Xây dựng và sử dụng SDK hỗ trợ thời gian chạy

Tạo và định cấu hình ứng dụng kiểm thử

Phần này giải thích cách thiết lập và chuẩn bị một ứng dụng để sử dụng SDK có thể chạy trong thời gian chạy cho mục đích kiểm thử cục bộ.

Chuẩn bị ứng dụng

Trước tiên, hãy tạo một dự án hoặc mô-đun độc lập riêng biệt.

Trong trường hợp này, ứng dụng không chứa mã SDK mà khai báo mã đó dưới dạng một phần phụ thuộc Maven.

Để tạo một ứng dụng sử dụng SDK có hỗ trợ thời gian chạy, bạn cần có Android Studio Ladybug Canary 1 trở lên và Trình bổ trợ Android cho Gradle (AGP) 8.7.0-alpha01 trở lên.

1. Hãy làm theo các bước tương tự như mô tả trước đó để thiết lập môi trường phát triển và thiết bị/trình mô phỏng để kiểm thử.

2. Bật Thời gian chạy SDK bằng cờ được mô tả trong Bước 3: Chuẩn bị phần SDK.

   # This enables the Privacy Sandbox for your project on Android Studio.
   android.experimental.privacysandboxsdk.enable=true
   android.experimental.privacysandboxsdk.requireServices=false
   

3. Thêm URL Maven của Hộp cát về quyền riêng tư vào tệp build.gradle cấp cao nhất của dự án.

       allprojects {
           repositories {
               google()
               maven {
                   url "https://maven.privacysandbox.com/v1/repository"
                   }
               }
           }
   

4. Giữ phần phụ thuộc Maven trên mục tiêu Maven của thư viện quảng cáo hiện có (SDK nhận biết thời gian chạy của bạn).

5. Thêm một khối privacySandbox vào build.gradle của dự án với một phần phụ thuộc vào thư viện SDK và đặt enable thành true

   plugins {
       id 'com.android.application'
       id 'org.jetbrains.kotlin.android'
   }
   
   android {
       //...
       privacySandbox {
           enable true
       }
       //...
   }
   
   dependencies {
       // SDK library dependency
       implementation(<maven coordinates to SDK library>)
   }
   

6. Giờ đây, ứng dụng có thể sử dụng các API của SDK theo cách tương tự như được giải thích trong phần sử dụng API.

Tạo ứng dụng

Bạn có thể tạo ứng dụng dưới dạng Android App Bundle (AAB) như bình thường.

Kiểm thử SDK cục bộ

Để chạy ứng dụng kiểm thử, hãy cài đặt SDK và ứng dụng đã bật thời gian chạy trên thiết bị kiểm thử hoặc trình mô phỏng bằng Android Studio.

1. Mở dự án Android Studio cho ứng dụng kiểm thử của bạn.
2. Chuyển đến Run > Edit Configurations (Chạy > Chỉnh sửa cấu hình). Cửa sổ "Run/Debug" Configuration (Cấu hình chạy/gỡ lỗi) sẽ xuất hiện. Bạn có thể triển khai dưới dạng "APK mặc định" hoặc "APK từ gói".
3. Trong phần Launch Options (Tuỳ chọn khởi chạy), hãy đặt Launch (Khởi chạy) thành Specified Activity (Hoạt động đã chỉ định).
4. Nhấp vào trình đơn có biểu tượng ba dấu chấm bên cạnh Activity (Hoạt động) rồi chọn Main Activity (Hoạt động chính) cho ứng dụng khách của bạn.
5. Nhấp vào Apply (Áp dụng) rồi nhấp vào OK.
6. Nhấp vào Run (Chạy) để cài đặt ứng dụng và SDK trên thiết bị kiểm thử của bạn.

Tạo SDK để phân phối

Bạn cần tạo SDK dưới dạng gói SDK Android (ASB) trước khi có thể xuất bản SDK đó lên một cửa hàng ứng dụng. ASB là một gói phát hành chưa ký tương đương với Android App Bundle.

ASB hoặc phiên bản phái sinh của ASB là Android SDK Archive (ASAR), cùng với AAB của ứng dụng sẽ được Bundletool chuyển thành một nhóm APK có thể cài đặt. Nhà phát triển ứng dụng có thể sử dụng BundleTool ngay trong Android Studio (hiện là phiên bản Canary) để xuất tất cả các biến thể APK.

Bundletool lấy một AAB và một ASB, đồng thời có thể xuất ra một tập hợp các biến thể APK:

1. Một APK được tạo để chạy ở chế độ tương thích ngược của Thời gian chạy SDK, dành cho những thiết bị không tương thích với thời gian chạy SDK (Android 13 trở xuống). Tệp APK này chứa tất cả mã cần thiết cho cả ứng dụng và SDK.
2. Một APK được tạo để chạy chế độ Thời gian chạy SDK cho các thiết bị tương thích với Thời gian chạy SDK (Android 14 trở lên). APK này chỉ chứa mã ứng dụng, với các phần giữ chỗ API cho SDK hỗ trợ thời gian chạy.
3. APK SDK có mã SDK hỗ trợ thời gian chạy, nhằm mục đích cài đặt trước APK ứng dụng được mô tả trong bước trước.

Bạn có thể tạo ASB theo 2 cách:

• Android Studio
  1. Tạo dự án. Bạn có thể thực hiện việc này bằng cách gọi Build > Rebuild (Xây dựng > Xây dựng lại) dự án.
  2. Tệp ASB nằm trong mô-đun ASB hỗ trợ thời gian chạy của bạn trong build/outputs/asb/single/<your-asb-module-name>.asb
• Dòng lệnh của Bundletool – hãy làm theo hướng dẫn này.

Bạn phải ký SDK bằng khoá tải lên trước khi có thể xuất bản. Sử dụng khoá tải lên này để ký ASB khi tải lên SDK Console. Google sử dụng chứng chỉ tải lên để xác minh danh tính của bạn.

Các bước sau đây là thông tin tổng quan về những việc bạn cần làm để ký ASB:

1. Tạo một kho khoá và khoá tải lên. Thao tác này giống hệt với việc tạo kho khoá và khoá tải lên cho ứng dụng.
2. Ký ASB bằng khoá tải lên. Để làm việc này, hãy thêm một khối signingConfig vào tệp build.gradle của bạn, chỉ định khoá và kho khoá mới tạo:

android {
  signingConfig {
    storeFile file(path-to-keystore.jks)
    storePassword "keystorePassword"
    keyAlias "UploadKey"
    keyPassword "keyPassword"
  }
}

Các cửa hàng ứng dụng có thể phát triển nhiều chiến lược để sử dụng các thành phần này nhằm hỗ trợ việc phân phối ứng dụng có thể bật trong thời gian chạy. Thời gian chạy SDK không ngừng hợp tác với các cửa hàng ứng dụng để mở rộng khả năng hỗ trợ cho các SDK hỗ trợ thời gian chạy.

arrow_back_iosBước 4: Sử dụng SDK có bật thời gian chạy