Créer et utiliser un SDK compatible avec l'environnement d'exécution

Compiler et configurer une application de test

Cette section explique comment configurer et préparer une application pour qu'elle consomme un SDK compatible avec l'exécution pour les tests locaux.

Préparer votre application

Commencez par créer un projet ou un module autonome distinct.

Dans ce scénario, l'application ne contient pas le code du SDK. Elle le déclare plutôt comme dépendance Maven.

Pour créer une application qui consomme un SDK compatible avec Runtime, vous devez utiliser Android Studio Ladybug Canary 1 ou version ultérieure, ainsi que le plug-in Android Gradle (AGP) 8.7.0-alpha01 ou version ultérieure.

1. Suivez les mêmes étapes que celles décrites précédemment pour configurer votre environnement de développement et votre appareil/émulateur pour les tests.

2. Activez SDK Runtime à l'aide de l'indicateur décrit dans la section Étape 3 : Préparer votre SDK.

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

3. Ajoutez l'URL Maven Privacy Sandbox au fichier build.gradle de premier niveau de votre projet.

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

4. Conservez la dépendance Maven sur la bibliothèque d'annonces existante (votre SDK compatible avec le cycle de vie) cible Maven.

5. Ajoutez un bloc privacySandbox au fichier build.gradle du projet avec une dépendance à la bibliothèque du SDK et définissez enable sur 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. L'application peut désormais utiliser les API du SDK de la même manière que décrit dans la section sur la consommation d'API.

Créer votre application

Vous pouvez créer vos applications en tant qu'Android App Bundle (AAB) comme d'habitude.

Tester votre SDK en local

Pour exécuter votre application de test, installez le SDK et l'application compatibles avec l'exécution sur votre appareil de test ou votre émulateur à l'aide d'Android Studio.

1. Ouvrez le projet Android Studio pour votre application de test.
2. Accédez à Run > Edit Configurations (Exécuter > Modifier les configurations). La fenêtre de configuration "Run/Debug" (Exécuter/Déboguer) s'affiche. Vous pouvez déployer l'application en tant qu'"APK par défaut" ou "APK à partir du bundle".
3. Sous Launch Options (Options de lancement), définissez Launch (Lancer) sur Specified Activity (Activité spécifiée).
4. Cliquez sur le menu à trois points à côté de Activité, puis sélectionnez l'activité principale pour votre client.
5. Cliquez sur Apply (Appliquer), puis sur OK.
6. Cliquez sur Run (Exécuter) pour installer l'application cliente et le SDK sur votre appareil de test.

Compiler votre SDK pour la distribution

Vous devez compiler votre SDK en tant qu'Android SDK Bundle (ASB) avant de pouvoir le publier sur un app store. Un ASB est un package de publication non signé équivalent aux Android App Bundles.

L'ASB, ou son dérivé Android SDK Archive (ASAR), ainsi que l'AAB de l'application sont transformés par Bundletool en un ensemble d'APK installables. Les développeurs d'applications peuvent utiliser BundleTool directement dans Android Studio (actuellement en version Canary) pour générer toutes les variantes d'APK.

Bundletool prend un AAB et un ASB en entrée, et peut générer un ensemble de variantes d'APK :

1. APK conçu pour s'exécuter en mode rétrocompatible avec le SDK Runtime, pour les appareils non compatibles avec le SDK Runtime (Android 13 et versions antérieures). Cet APK contient tout le code nécessaire pour l'application et le SDK.
2. APK conçu pour exécuter le mode SDK Runtime pour les appareils compatibles avec le SDK Runtime (Android 14 et versions ultérieures). Cet APK ne contient que le code de l'application, avec des stubs d'API pour le SDK compatible avec le runtime.
3. APK du SDK avec le code du SDK compatible avec l'environnement d'exécution, destiné à être installé avant l'APK de l'application décrit à l'étape précédente.

Vous pouvez créer un ASB de deux manières :

• Android Studio
  1. Compilez votre projet. Pour ce faire, appelez Build > Rebuild (Compiler > Recompiler) le projet.
  2. Le fichier ASB se trouve dans votre module ASB compatible avec l'exécution sous build/outputs/asb/single/<your-asb-module-name>.asb.
• Ligne de commande de Bundletool : suivez ces instructions.

Le SDK doit être signé avec une clé de transfert avant de pouvoir être publié. Utilisez cette clé d'importation pour signer votre ASB afin de l'importer dans la console SDK. Google utilise le certificat d'importation pour valider votre identité.

Voici un aperçu des étapes à suivre pour signer votre ASB :

1. Générez un keystore et une clé d'importation. Cette opération est identique à la génération d'un keystore et d'une clé d'importation pour les applications.
2. Signez votre ASB avec la clé d'importation. Pour ce faire, ajoutez un bloc signingConfig à votre fichier build.gradle en spécifiant la clé et le keystore nouvellement créés :

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

Les plates-formes de téléchargement d'applications peuvent développer différentes stratégies pour utiliser ces composants afin de prendre en charge la distribution d'applications avec activation du moteur d'exécution. SDK Runtime collabore en permanence avec les plates-formes de téléchargement d'applications pour étendre la compatibilité avec les SDK compatibles avec l'environnement d'exécution.

arrow_back_iosÉtape 4 : Utiliser le SDK compatible avec l'exécution