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

Testing, and building for distribution

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 phiên bản được kích hoạt bởi thời gian chạy SDK để 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.

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

Để tạo một ứng dụng sử dụng SDK 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.

Làm theo các bước tương tự như được 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 để thử nghiệm.

Bật Thời gian chạy SDK bằng cờ được mô tả trong phần 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

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

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

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).

Thêm một khối privacySandbox vào dự án build.gradle với phần phụ thuộc trên thư viện SDK và đặt bật 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>)
}

Ứng dụng hiện có thể sử dụng 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 vào thiết bị kiểm thử hoặc trình mô phỏng bằng Android Studio.

Mở dự án Android Studio cho ứng dụng kiểm thử của bạn.
Chuyển đến Run > Edit Configurations (Chạy > Chỉnh sửa cấu hình). Thao tác "Chạy/Gỡ lỗi" Cửa sổ cấu hình 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".
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).
Nhấp vào trình đơn có biểu tượng ba dấu chấm bên cạnh Hoạt động rồi chọn Hoạt động chính cho ứng dụng khách của bạn.
Nhấp vào Apply (Áp dụng) rồi nhấp vào OK.
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 ứng dụng lên 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 các dẫn xuất của Android SDK Archive (ASAR), cùng nhau với AAB của ứng dụng sẽ được Bundletool biến thành một tập hợp các tệp 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 tại là phiên bản Canary) để xuất tất cả biến thể APK.

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

Tệp APK được tạo để chạy ở chế độ tương thích ngược với Thời gian chạy SDK, dành cho các thiết bị không tương thích với thời gian chạy SDK (Android 13 trở xuống). APK này chứa tất cả mã cần thiết cho cả ứng dụng và SDK.
Một APK được xây dựng để 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 phần mã ứng dụng, với mã giả lập API cho SDK hỗ trợ thời gian chạy.
APK SDK có mã SDK hỗ trợ thời gian chạy, nhằm được cài đặt trước APK ứng dụng được mô tả ở bước trước.

Bạn có thể xây dựng ASB theo 2 cách:

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

Bạn phải ký SDK bằng một khoá tải lên thì mới có thể phát hành. Sử dụng khoá tải lên này để ký ASB của bạn nhằm 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:

Tạo kho khoá và khoá tải lên. Thao tác này giống với cách tạo kho khoá và khoá tải lên cho ứng dụng.
Ký ASB bằng khoá tải lên. Để thực hiện 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ửa hàng ứng dụng có thể phát triển nhiều chiến lược nhằm hỗ trợ những thành phần này Phân phối ứng dụng do thời gian chạy kích hoạt. Thời gian chạy SDK liên tục hoạt động với ứng dụng cửa hàng để mở rộng khả năng hỗ trợ cho các SDK hỗ trợ thời gian chạy.

Bước 4: Sử dụng SDK hỗ trợ thời gian chạy

Xây dựng và sử dụng SDK hỗ trợ thời gian chạy Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.