Trang này được dịch bởi Cloud Translation API.

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.

Để xây dựng một ứng dụng dùng SDK kích hoạt bởi thời gian chạy, bạn phải 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ách sử dụ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

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 .

    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 mức sử dụng API.

Tạo ứng dụng

Bạn có thể xây dựng ứng dụng dưới dạng Android App Bundle (AAB) như bạn vẫn thường làm.

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 hỗ trợ thời gian chạy vào quy trình kiểm thử thiết bị 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 Activity (Hoạt động) rồi chọn Hoạt động của khách hàng.
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 ấn bản chưa được 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. Chiến dịch Quảng cáo ứng dụng nhà phát triển có thể sử dụng BundleTool ngay trong Android Studio (hiện là Canary phiên bản) để xuất tất cả cá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 ra một tập hợp các biến thể APK:

Một APK được tạo để chạy trong chế độ tương thích ngược Thời gian chạy SDK, cho 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ả cá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 bản thảo này khoá tải lên để ký ASB để 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. Điều này giống với 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 signConfig vào tệp build.gradle của bạn chỉ định khoá mới tạo và kho khoá:

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