Distribuer les versions des bundles d'applications aux testeurs - Codelab

1. Vue d'ensemble

Dans cet atelier de programmation, vous apprendrez à distribuer les versions d'Android App Bundle aux testeurs à l'aide de Firebase App Distribution et de son plug-in Gradle. App Distribution fournit un hub central vous permettant de gérer les versions préliminaires de votre application et les testeurs que vous invitez à chaque version.

Ce que vous apprendrez

• Comment lier votre application Firebase à Google Play
• Comment empaqueter et créer votre application en tant que bundle d'applications
• Comment créer une version et la partager avec des testeurs en direct
• Comment télécharger et tester les nouvelles versions en tant que testeur

Ce dont vous aurez besoin

• Dernière version d'Android Studio
• Un fichier bundle signé que vous avez généré à partir d'Android Studio
• Un compte de développeur Google Play dont vous êtes le propriétaire ou l'administrateur
• Votre application dans Google Play est configurée sur le tableau de bord de l'application Google Play et son état est le suivant :
  • L'application est distribuée à l'une des pistes Google Play (Tests internes, Tests fermés, Tests ouverts ou Production).
  • L'examen de l'application dans Google Play est terminé et l'application est publiée. Votre application est publiée si la colonne Statut de l'application affiche l'un des statuts suivants : test interne (pas de test interne préliminaire), test fermé, test ouvert ou production.
• Une adresse e-mail que vous pouvez utiliser en tant que testeur pour recevoir de nouvelles invitations de build de Firebase

2. Créer un projet Firebase

1. Connectez-vous à Firebase .
2. Dans la console Firebase, cliquez sur Ajouter un projet , puis nommez votre projet « AppBundlesCodelab ». N'oubliez pas l'ID de projet de votre projet Firebase. Si vous ne modifiez pas l'ID du projet, Firebase attribue automatiquement un ID unique à votre projet.
   
   
3. (Facultatif) Lorsque vous y êtes invité, activez Google Analytics.
4. Effectuez les étapes restantes, puis cliquez sur Créer un projet .

Ajouter votre app bundle au projet

1. Dans la console Firebase, cliquez sur Ajouter une application .
   
   
2. Lors de l'enregistrement de votre application, assurez-vous d'utiliser le même nom de package que l'application téléchargée sur votre compte de développeur Google Play. Enfin, cliquez sur Enregistrer l'application .
3. Effectuez les étapes restantes pour ajouter le fichier de configuration Firebase de votre application ( google-services.json ) à votre application. Notez que pour Android, App Distribution n'a pas de SDK Firebase à ajouter à votre application.
4. Cliquez sur Continuer pour consoler .

Lien vers Google Play

1. Dans la console Firebase, accédez aux paramètres de votre projet .
   
   
2. Dans l'onglet Intégrations , cliquez sur Lien sur la carte Google Play .
3. Suivez les instructions à l'écran pour activer l'intégration de la distribution d'applications, puis sélectionnez votre application Firebase nouvellement créée à lier à Google Play.

Maintenant que vous avez terminé ces étapes, votre application Firebase sera liée à votre application dans votre compte de développeur Google Play tant que les noms de packages des applications correspondent.

3. Ajoutez App Distribution à votre projet

Ajouter le plugin App Distribution Gradle

Maintenant, vous allez utiliser Android Studio pour ajouter App Distribution et son plugin Gradle à votre application.

1. Dans votre fichier Gradle au niveau du projet ( android/build.gradle.kts ), ajoutez le plug-in App Distribution Gradle au bloc plugins .

   plugins {
        //...
   
        // Add the App Distribution Gradle plugin
        id("com.google.firebase.appdistribution") version "4.0.0" apply false
   }
   

2. Dans votre fichier Settings Gradle au niveau du projet ( android/settings.gradle.kts ), ajoutez le référentiel Maven de Google au bloc pluginManagement .

    pluginManagement {
        // Check that you have Google's Maven repository (if not, add it).
        repositories {
            google()
            mavenCentral()
        }
    }
   

3. Dans votre fichier Gradle au niveau de l'application ( android/app/build.gradle.kts ), ajoutez le plugin App Distribution au bloc plugins .

   plugins {
        //...
   
        // Add the App Distribution plugin
        id("com.google.firebase.appdistribution")
   }
   

4. Si vous êtes derrière un proxy d'entreprise ou un pare-feu, ajoutez la propriété système Java suivante qui permet à App Distribution de télécharger vos distributions sur Firebase :

   -Djavax.net.ssl.trustStore=/path/to/truststore -Djavax.net.ssl.trustStorePassword=password
   

Authentifiez votre projet Firebase

Avant de pouvoir utiliser le plugin Gradle, vous devez authentifier votre projet Firebase. Pour cet atelier de programmation, vous vous connecterez à votre compte Google à l'aide de l'action de connexion du plug-in.

1. Exécutez la commande suivante à la racine de votre projet Android :

   ~/your-android-project$ ./gradlew appDistributionLogin
   

2. Lorsque la commande imprime un lien d'authentification, ouvrez-le dans un navigateur. Lorsque vous y êtes invité, connectez-vous à votre compte Google et accordez l'autorisation d'accéder à votre projet Firebase. La commande Gradle imprime un jeton d'actualisation, que le plug-in App Distribution utilise pour s'authentifier auprès de Firebase.
3. Définissez la variable d'environnement FIREBASE_TOKEN sur le jeton de l'étape précédente :

   ~/your-android-project$ export FIREBASE_TOKEN=your_firebase_token
   

4. Configurez les propriétés de votre bundle dans Android Studio

Dans cette étape, vous vous ajouterez en tant que testeur pour la version que vous distribuerez plus tard. Une fois que vous avez distribué la version, les testeurs reçoivent des notifications par e-mail de Firebase les invitant à tester la nouvelle version.

Dans votre app/build.gradle.kts , ajoutez une section firebaseAppDistribution et incluez les paramètres suivants :

• appID : ID d'application Firebase de votre application. Vous pouvez le trouver dans l' onglet Général des paramètres de votre projet .
• artifactType : le type de fichier de votre application ( AAB ).
• testers : Adresses e-mail de vos testeurs. Pour cet atelier de programmation, ajoutez votre propre adresse e-mail afin de pouvoir tester votre version une fois qu'elle sera distribuée.

Par exemple:

    android {

       // ...

       buildTypes {
            getByName("release") {
                firebaseAppDistribution {
                  appId = "yourAppId"
                  artifactType = "AAB"
                  testers = "ali@example.com, bri@example.com, cal@example.com"
                }
            }
        }

        // ...
    }

En option, vous pouvez également remplacer les valeurs définies dans votre build.gradle.kts en transmettant des arguments de ligne de commande sous la forme -PappDistribution- property-name = property-value .

5. Créer et distribuer une version

1. Exécutez la tâche bundle Variant pour créer votre fichier de bundles d'applications :

   $ ./gradlew :base:bundleRelease
   

2. Localisez le bundle dans le répertoire de construction de votre application (l'emplacement par défaut est app/build/outputs/bundle/release ).
3. Pour distribuer la version, créez les cibles bundleRelease et appDistributionUploadRelease avec le wrapper Gradle de votre projet. Incluez le jeton Firebase (celui que vous avez reçu à l'étape 3 : Ajouter la distribution d'applications à votre application).

   export FIREBASE_TOKEN=your_firebase_token
   
   ./gradlew --stop // Only needed for environment variable changes
   
   ./gradlew bundleRelease appDistributionUploadRelease
   

Les testeurs recevront désormais des invitations par e-mail pour télécharger et tester la version. En tant que développeur, vous pouvez désormais surveiller la version dans l'onglet Releases du tableau de bord App Distribution.

6. Téléchargez et testez votre version

Dans cette section, vous serez configuré en tant que testeur afin de télécharger la version que vous avez distribuée. En tant que testeur, vous devrez authentifier votre appareil de test et activer le partage d'application interne dans l'application Google Play Store.

1. Sur votre appareil de test, connectez-vous à votre compte de messagerie de testeur et ouvrez l'invitation de Firebase.
   
   
2. Connectez-vous avec votre compte Google et acceptez l'invitation à tester la version distribuée. En option, vous pouvez également télécharger Firebase App Tester , qui empêche l'ajout des versions téléchargées au dossier Downloads de votre appareil. Il affiche également des informations supplémentaires sur les versions, telles que la progression du téléchargement et la version de la version.
   
   
3. Appuyez sur Télécharger sur la version pour l'installer à partir du Play Store.
4. Lorsque vous y êtes invité, effectuez les étapes restantes pour activer le partage d'application interne (les instructions s'affichent sur votre appareil de test et ne doivent être suivies qu'une seule fois).

Une fois le téléchargement terminé, votre version apparaîtra automatiquement sous forme de raccourci sur l'écran d'accueil de votre appareil.

7. Félicitations !

Vous venez d'utiliser Firebase App Distribution pour télécharger un ensemble d'applications et distribuer une version aux testeurs.

Prochaines étapes

• Rendez-vous sur la documentation App Distribution pour en savoir plus sur la gestion des testeurs pour votre release.
• Consultez Créer et tester votre Android App Bundle pour plus d'informations sur les autres outils que vous pouvez utiliser pour déployer votre application.