Crea e utilizza un SDK abilitato per il runtime

Crea e configura un'app di test

Questa sezione spiega come configurare e preparare un'app per il consumo di una versione abilitata per il runtime SDK 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; 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 versione successiva e plug-in Android Gradle (AGP) 8.7.0-alpha01 o versione successiva

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

2. Abilita SDK Runtime utilizzando il flag descritto in Passaggio 3: prepara la sezione relativa all'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 sul target Maven esistente per la libreria di annunci (il tuo SDK per il runtime).

5. Aggiungi un blocco privacySandbox al progetto build.gradle con una dipendenza dalla libreria SDK e imposta abilita 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 spiegato nella sezione sul consumo delle API.

Crea la tua app

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

Testa l'SDK in locale

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

1. Apri il progetto Android Studio per l'app di test.
2. Vai a Esegui > Modifica configurazioni. La sezione "Esegui/Debug" Finestra di configurazione . Puoi eseguire il deployment come "APK predefinito" o "APK dall'app bundle".
3. In Opzioni di avvio, imposta Avvia su Attività specificata.
4. Fai clic sul menu con tre puntini accanto ad Attività e seleziona Attività per il 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.

Creare l'SDK per la distribuzione

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

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

Strumento a pacchetto prende un AAB e un ASB e può generare un insieme di varianti dell'APK:

1. Un APK creato per l'esecuzione in modalità compatibile con le versioni precedenti di SDK Runtime, ad dispositivi non compatibili con il runtime dell'SDK (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 eseguire la 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 in fase di runtime.
3. L'APK dell'SDK con il codice SDK abilitato per il runtime, progettato per essere installato prima all'APK dell'app descritto nel passaggio precedente.

Puoi creare un ASB in due modi:

• Android Studio
  1. Crea il tuo progetto. Per farlo, occorre utilizzare il progetto Build > Rebuild.
  2. Il file ASB si trova nel modulo ASB abilitato per il runtime nella build/outputs/asb/single/<your-asb-module-name>.asb
• Riga di comando di Bundletool - Segui queste istruzioni.

L'SDK deve essere firmato con una chiave di caricamento prima di poter essere pubblicato. Usa questa per firmare l'ASB per il caricamento su SDK Console. Google utilizza il certificato di caricamento per verificare la tua identità.

I seguenti passaggi sono una panoramica di ciò che devi fare per firmare l'ASB:

1. Generare un archivio chiavi e una chiave di caricamento. È identico a generare un archivio chiavi e una chiave di caricamento per le app.
2. Firma l'ASB con la chiave di caricamento. A questo scopo, aggiungi un blocco signConfig al file build.gradle specificando la chiave appena creata e l'archivio chiavi:

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

Gli store possono sviluppare diverse strategie per l'utilizzo di questi componenti al fine di supportare Distribuzione di app abilitate per il runtime. SDK Runtime funziona continuamente con l'app per estendere il supporto degli SDK abilitati per il runtime.

arrow_back_iosPassaggio 4: utilizza l'SDK abilitato per il runtime