Membangun dan menggunakan SDK yang Mendukung Runtime

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.

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

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

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

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

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

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

6. Aplikasi kini dapat menggunakan API SDK dengan cara yang sama seperti yang dijelaskan di bagian penggunaan API.

Membuat aplikasi

Anda dapat mem-build 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.

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

Mem-build SDK untuk distribusi

Anda perlu mem-build SDK sebagai Android SDK Bundle (ASB) sebelum dapat memublikasikannya ke app store. ASB adalah paket publikasi tanpa tanda tangan yang setara dengan Android App Bundle.

ASB, atau turunannya Android SDK Archive (ASAR), bersama dengan AAB aplikasi diubah oleh Bundletool menjadi kumpulan APK yang dapat diinstal. Developer aplikasi dapat menggunakan BundleTool langsung di Android Studio (saat ini versi Canary) untuk menghasilkan semua varian APK.

Bundletool mengambil AAB dan ASB serta dapat menghasilkan kumpulan varian APK:

1. 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.
2. 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, dengan stub API untuk SDK yang mengaktifkan runtime.
3. APK SDK dengan kode SDK yang mendukung runtime, yang ditujukan untuk diinstal sebelum APK aplikasi yang dijelaskan pada langkah sebelumnya.

Anda dapat mem-build 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 kunci upload ini untuk menandatangani ASB Anda agar dapat diupload ke Konsol SDK. Google menggunakan sertifikat upload untuk memverifikasi identitas Anda.

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

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

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.

arrow_back_iosLangkah 4: Gunakan SDK yang mendukung runtime