Crea e utilizza un SDK abilitato per il runtime

Creare e configurare un'app di test

Questa sezione spiega come configurare e preparare un'app per utilizzare un SDK abilitato per il runtime per i test locali.

Preparare l'app

Innanzitutto, crea un progetto o un modulo autonomo separato.

In questo scenario, l'app non contiene il codice SDK, ma lo dichiara come dipendenza Maven.

La creazione di un'app che utilizza un SDK abilitato per il runtime richiede Android Studio Ladybug Canary 1 o versioni successive e Android Gradle Plugin (AGP) 8.7.0-alpha01 o versioni successive.

1. Segui gli stessi passaggi descritti in precedenza per configurare l'ambiente di sviluppo e il dispositivo/emulatore per i test.

2. Attiva SDK Runtime utilizzando il flag descritto nel passaggio 3: prepara la sezione SDK.

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

3. Aggiungi l'URL Maven di Privacy Sandbox al file build.gradle di primo livello del tuo progetto.

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

4. Mantieni la dipendenza Maven dalla libreria di annunci esistente (il tuo SDK runtime-aware) come target Maven.

5. Aggiungi un blocco privacySandbox a build.gradle del progetto con una dipendenza dalla libreria SDK e imposta enable su 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. Ora l'app può utilizzare le API dell'SDK nello stesso modo descritto nella sezione relativa all'utilizzo delle API.

Crea la tua app

Puoi creare le tue app come Android App Bundle (AAB) come faresti normalmente.

Testare l'SDK localmente

Per eseguire l'app di test, installa l'SDK e l'app con runtime abilitato sul dispositivo o sull'emulatore di test utilizzando Android Studio.

1. Apri il progetto Android Studio per l'app di test.
2. Vai a Esegui > Modifica configurazioni. Viene visualizzata la finestra di configurazione "Esegui/Esegui debug". Puoi eseguire il deployment come "APK predefinito" o "APK da bundle".
3. In Opzioni di avvio, imposta Avvio su Attività specificata.
4. Fai clic sul menu con tre puntini accanto ad Attività e seleziona l'attività principale per il tuo cliente.
5. Fai clic su Applica e poi su Ok.
6. Fai clic su Esegui per installare l'app client e l'SDK sul dispositivo di test.

Crea l'SDK per la distribuzione

Devi creare l'SDK come bundle Android SDK (ASB) prima di poterlo pubblicare in uno store. ASB è un pacchetto di pubblicazione non firmato equivalente agli Android App Bundle.

L'ASB o il suo derivato, l'archivio SDK Android (ASAR), insieme all'AAB dell'app, vengono trasformati da Bundletool in un insieme di APK installabili. Gli sviluppatori di app possono utilizzare BundleTool direttamente in Android Studio (attualmente la versione Canary) per generare tutte le varianti APK.

Bundletool accetta un AAB e un ASB e può generare un insieme di varianti APK:

1. Un APK creato per l'esecuzione in modalità di compatibilità con le versioni precedenti di SDK Runtime per dispositivi non compatibili con SDK Runtime (Android 13 e versioni precedenti). Questo APK contiene tutto il codice necessario sia per l'app sia per l'SDK.
2. Un APK creato per l'esecuzione della modalità SDK Runtime per i dispositivi compatibili con SDK Runtime (Android 14 e versioni successive). Questo APK contiene solo il codice dell'app, con stub API per l'SDK abilitato per l'esecuzione.
3. L'APK dell'SDK con il codice dell'SDK abilitato per il runtime, da installare prima dell'APK dell'app descritto nel passaggio precedente.

Puoi creare un ASB in due modi:

• Android Studio
  1. Crea il tuo progetto. Questa operazione può essere eseguita chiamando il progetto Build > Rebuild.
  2. Il file ASB si trova nel modulo ASB abilitato per il runtime in build/outputs/asb/single/<your-asb-module-name>.asb
• Riga di comando di Bundletool: segui queste istruzioni.

Prima di poterlo pubblicare, l'SDK deve essere firmato con una chiave di caricamento. Utilizza questa chiave di caricamento per firmare l'ASB da caricare su SDK Console. Google utilizza il certificato di caricamento per verificare la tua identità.

I passaggi riportati di seguito sono una panoramica di ciò che devi fare per firmare la tua ASB:

1. Genera un keystore e una chiave di caricamento. Questa operazione è identica alla generazione di un archivio chiavi e di una chiave di caricamento per le app.
2. Firma l'ASB con la chiave di caricamento. Per farlo, aggiungi un blocco signingConfig al file build.gradle specificando la chiave e il keystore appena creati:

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

Gli store possono sviluppare strategie diverse per utilizzare questi componenti a supporto della distribuzione di app abilitate per il runtime. SDK Runtime collabora costantemente con gli store per estendere il supporto agli SDK abilitati per il runtime.

arrow_back_iosPassaggio 4: utilizza l'SDK abilitato per l'esecuzione