Cette page a été traduite par l'API Cloud Translation.

Distribuer les versions de l'App Bundle 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 une plateforme centrale 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 sous forme d'app bundle
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 a l' état suivant :
- L'application est distribuée sur l'une des pistes de Google Play (tests internes, tests fermés, tests ouverts ou production).
- L'examen de l'application sur 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 des invitations à de nouvelles versions de Firebase

2. Créez un projet Firebase

Connectez-vous à Firebase .
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.
(Facultatif) Lorsque vous y êtes invité, activez Google Analytics.
Effectuez les étapes restantes, puis cliquez sur Créer un projet .

Ajoutez votre bundle d'applications au projet

Dans la console Firebase, cliquez sur Ajouter une application .
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.
Remarque : Le même nom de package est requis pour lier votre application Firebase à votre compte de développeur Google Play, ce que vous ferez dans la section suivante.
Enfin, cliquez sur Enregistrer l'application .
Suivez les étapes restantes pour ajouter le fichier de configuration Firebase de votre application ( google-services.json ) à votre application. Notez que pour Android, App Distribution ne dispose pas de SDK Firebase à ajouter à votre application.
Cliquez sur Continuer pour consoler .

Lien vers Google Play

Dans la console Firebase, accédez aux paramètres de votre projet .
Dans l'onglet Intégrations , cliquez sur Lien sur la carte Google Play .
Suivez les instructions à l'écran pour activer l'intégration d'App Distribution, puis sélectionnez votre application Firebase nouvellement créée pour la 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 la distribution d'applications à votre projet

Ajouter le plugin App Distribution Gradle

Vous allez maintenant utiliser Android Studio pour ajouter App Distribution et son plugin Gradle à votre application.

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

plugins {
     //...

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

Dans le fichier Settings Gradle au niveau de votre 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()
     }
 }

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")
}
```
Si vous utilisez 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 devrez authentifier votre projet Firebase. Pour cet atelier de programmation, vous vous connecterez à votre compte Google à l'aide de la CLI Firebase .

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

~/your-android-project$ firebase login

La documentation de référence contient plus de détails.

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

Au cours de cette étape, vous vous ajouterez en tant que testeur pour la version que vous distribuerez ultérieurement. Une fois la version distribuée, 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 : Les adresses email de vos testeurs. Pour cet atelier de programmation, ajoutez votre propre adresse e-mail afin de pouvoir tester votre build 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 passant des arguments de ligne de commande sous la forme -PappDistribution- property-name = property-value .

5. Créer et distribuer une version

Exécutez la tâche bundle Variant Gradle pour créer votre fichier de bundles d'applications :
```
$ ./gradlew :base:bundleRelease
```
Localisez le bundle dans le répertoire de build de votre application (l'emplacement par défaut est app/build/outputs/bundle/release ).
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 App Distribution à 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 build 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'applications internes dans l'application Google Play Store.

Sur votre appareil de test, connectez-vous à votre compte de messagerie de testeur et ouvrez l'invitation de Firebase.
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.
Appuyez sur Télécharger sur la version pour l'installer à partir du Play Store.
Lorsque vous y êtes invité, effectuez les étapes restantes pour activer le partage d'application interne (les instructions sont affichées sur votre appareil de test et ne doivent être complétées 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 façon de gérer les testeurs pour votre version.
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.