Membangun dan menggunakan SDK yang Mendukung Runtime

Membangun dan mengonfigurasi aplikasi pengujian

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

Menyiapkan aplikasi

Pertama, buat project atau modul mandiri terpisah.

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

Membangun aplikasi yang menggunakan SDK yang Kompatibel dengan Runtime memerlukan Android Studio Ladybug Canary 1 atau yang lebih baru, dan Android Gradle Plugin (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. Aktifkan Runtime SDK menggunakan tanda yang dijelaskan di Langkah 3: Siapkan bagian SDK Anda.

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

3. Tambahkan URL Maven Privacy Sandbox ke file 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 yang ada (SDK yang kompatibel dengan runtime).

5. Tambahkan blok privacySandbox ke build.gradle project dengan dependensi pada library SDK dan tetapkan enable ke 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 membuat aplikasi sebagai Android App Bundle (AAB) seperti biasanya.

Menguji SDK Anda secara lokal

Untuk menjalankan aplikasi pengujian, instal SDK dan aplikasi yang diaktifkan runtime ke perangkat pengujian 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 Bundle".
3. Di bagian Launch Options, tetapkan Launch ke Specified Activity.
4. Klik menu tiga titik di samping Activity, lalu pilih Main Activity untuk klien Anda.
5. Klik Apply, lalu OK.
6. Klik Run untuk menginstal aplikasi klien dan SDK di perangkat pengujian Anda.

Membangun SDK untuk distribusi

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

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

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

1. APK yang dibuat untuk berjalan dalam mode kompatibel mundur 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 untuk perangkat yang kompatibel dengan Runtime SDK (Android 14 dan yang lebih tinggi). APK ini hanya berisi kode aplikasi, dengan stub API untuk SDK yang diaktifkan runtime.
3. APK SDK dengan kode SDK yang diaktifkan untuk 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 project Build > Rebuild.
  2. File ASB berada di modul ASB yang diaktifkan untuk runtime di 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 untuk diupload ke Konsol SDK. Google menggunakan sertifikat upload untuk memverifikasi identitas Anda.

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

1. Buat keystore dan kunci upload. Proses 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 Anda yang menentukan kunci dan keystore yang baru dibuat:

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

Toko aplikasi dapat mengembangkan berbagai strategi untuk menggunakan komponen ini guna mendukung distribusi aplikasi yang Diaktifkan Runtime. Runtime SDK terus bekerja sama dengan app store untuk memperluas dukungan bagi SDK dengan dukungan runtime.

arrow_back_iosLangkah 4: Gunakan SDK yang diaktifkan saat runtime