Halaman ini diterjemahkan oleh Cloud Translation API.

Membangun dan menggunakan SDK yang Mendukung Runtime
Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Testing, and building for distribution

Membangun dan mengonfigurasi aplikasi pengujian

Bagian ini menjelaskan cara menyiapkan dan menyiapkan aplikasi untuk menggunakan runtime yang mendukung runtime SDK untuk pengujian lokal.

Menyiapkan aplikasi

Pertama, buat project atau modul mandiri yang terpisah.

Dalam skenario ini, aplikasi tidak berisi kode SDK; ia mendeklarasikannya sebagai Sebagai gantinya, dependensi Maven.

Membangun aplikasi yang menggunakan Runtime Enabled SDK memerlukan Android Studio Ladybug Canary 1 atau yang lebih baru, dan Plugin Android Gradle (AGP) 8.7.0-alpha01 atau yang lebih baru.

Ikuti langkah yang sama seperti yang diuraikan sebelumnya untuk menyiapkan lingkungan pengembangan dan perangkat/emulator untuk pengujian.

Mengaktifkan Runtime SDK menggunakan flag yang dijelaskan di Langkah 3: Siapkan bagian SDK.

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

Menambahkan URL Maven Privacy Sandbox ke build.gradle level teratas project Anda .

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

Pertahankan dependensi Maven pada target Maven library iklan (SDK yang peka runtime).

Menambahkan blok privacySandbox ke project build.gradle dengan dependensi pada library SDK dan menyetel enable 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>)
}

Sekarang aplikasi dapat menggunakan API SDK dengan cara yang sama seperti dijelaskan di bagian pemakaian API.

Membuat aplikasi

Anda dapat membuat aplikasi sebagai Android App Bundle (AAB) seperti biasa.

Menguji SDK secara lokal

Untuk menjalankan aplikasi pengujian, instal SDK dan aplikasi yang mendukung runtime ke pengujian Anda perangkat atau emulator menggunakan Android Studio.

Buka project Android Studio untuk aplikasi pengujian Anda.
Buka Run > Edit Configurations. Perintah "Run/Debug" Jendela konfigurasi muncul. Anda dapat men-deploy-nya sebagai "APK Default" atau "APK dari Paket".
Di bagian Launch Options, tetapkan Launch ke Specified Activity.
Klik menu tiga titik di samping Aktivitas dan pilih tombol Aktivitas untuk klien Anda.
Klik Apply, lalu OK.
Klik Run untuk menginstal aplikasi klien dan SDK di perangkat pengujian Anda.

Bangun SDK untuk distribusi

Anda harus membangun SDK sebagai Android SDK Bundle (ASB) sebelum Anda dapat memublikasikannya ke app store. ASB adalah publikasi yang tidak ditandatangani yang setara dengan Android App Bundle.

ASB, atau turunannya, Android SDK Archive (ASAR), bersama-sama dengan AAB aplikasi diubah oleh Bundletool menjadi satu set APK yang dapat diinstal. Aplikasi developer dapat menggunakan BundleTool langsung di Android Studio (saat ini Canary ) untuk menghasilkan output semua varian APK.

Bundletool mengambil AAB dan ASB, dan dapat menghasilkan serangkaian varian APK:

APK yang dibuat untuk berjalan dalam mode yang kompatibel dengan versi lama Runtime SDK, untuk perangkat yang tidak kompatibel dengan runtime SDK (Android 13 dan yang lebih lama). APK ini berisi semua kode yang diperlukan untuk aplikasi dan SDK.
APK yang dibuat untuk menjalankan mode Runtime SDK bagi perangkat yang kompatibel dengan Runtime SDK (Android 14 dan yang lebih baru). APK ini hanya berisi kode aplikasi Anda, dengan stub API untuk SDK yang mendukung runtime.
APK SDK dengan kode SDK yang mendukung runtime, yang ditujukan untuk diinstal sebelum APK aplikasi yang dijelaskan pada langkah sebelumnya.

Anda dapat membuat ASB dengan dua cara:

Android Studio
1. Bangun project Anda. Hal ini dapat dilakukan dengan memanggil Build > Build ulang.
2. File ASB berada di modul ASB yang mendukung runtime di bagian build/outputs/asb/single/<your-asb-module-name>.asb
Command line Bundletool - ikuti petunjuk ini.

SDK harus ditandatangani dengan kunci upload sebelum Anda dapat memublikasikannya. Gunakan ini kunci upload untuk menandatangani ASB agar dapat diupload ke SDK Console. Google menggunakan sertifikat upload untuk memverifikasi identitas Anda.

Langkah-langkah berikut adalah ringkasan tentang apa yang perlu Anda lakukan untuk menandatangani ASB:

Buat keystore dan kunci upload. Hal ini identik dengan membuat keystore dan kunci upload untuk aplikasi.
Tanda tangani ASB Anda dengan kunci upload. Untuk melakukannya, tambahkan blok signingConfig ke file build.gradle Anda dengan menentukan kunci yang baru dibuat dan keystore:

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

{i>App store<i} dapat mengembangkan strategi yang berbeda untuk menggunakan komponen ini guna mendukung Distribusi aplikasi yang Mendukung Runtime. Runtime SDK terus bekerja dengan aplikasi untuk memperluas dukungan bagi SDK yang mendukung runtime.

Langkah 4: Gunakan SDK yang mendukung runtime

Membangun dan menggunakan SDK yang Mendukung Runtime Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.