Distribuer des applications Android aux testeurs à l'aide de la console Firebase
Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Ce guide explique comment importer des Android App Bundles (AAB) dans App Distribution et distribuer les APK générés à l'aide de la console Firebase.

App Distribution s'intègre au service de partage d'applications interne de Google Play pour traiter les AAB que vous importez et distribuer des APK optimisés selon la configuration des appareils de vos testeurs. La distribution d'AAB vous permet d'effectuer les opérations suivantes:

Exécutez des APK optimisés (distribués par Google Play) qui sont optimisés pour les appareils de vos testeurs.
Identifier et déboguer les problèmes spécifiques à un appareil
Testez les fonctionnalités des app bundles, comme Play Feature Delivery et Play Asset Delivery.
Réduisez la taille des téléchargements pour vos testeurs.

Autorisations requises

Pour importer des AAB dans App Distribution, vous devez associer votre application Firebase à une application dans Google Play. Vous devez disposer du niveau d'accès requis pour effectuer ces actions.

Si vous ne disposez pas de l'accès Firebase nécessaire, vous pouvez demander au propriétaire d'un projet Firebase de vous attribuer le rôle approprié via les paramètres IAM de la console Firebase. Si vous avez des questions sur l'accès à votre projet Firebase, y compris sur la recherche ou l'attribution d'un propriétaire, consultez les questions fréquentes sur les autorisations et l'accès aux projets Firebase.

Le tableau suivant s'applique à l'association d'une application Firebase à une application dans Google Play, ainsi qu'à l'importation d'AAB.

Action dans la console Firebase	Autorisation IAM requise	Rôles IAM incluant les autorisations requises par défaut	Rôle(s) supplémentaire(s) requis(s)
Associer une application Firebase à une application dans Google Play	`firebase.playLinks.update`	L'un des rôles suivants : Propriétaire Administrateur Firebase	Accès à un compte de développeur Google Play en tant qu'administrateur
Importer des AAB dans App Distribution	`firebaseappdistro.releases.update`	L'un des rôles suivants : Propriétaire Éditeur Administrateur Firebase Administrateur de qualité Firebase Administrateur de la distribution de l'application Firebase	––

Avant de commencer

Si ce n'est pas encore fait, ajoutez Firebase à votre projet Android. À la fin de ce workflow, vous disposerez d'une application Android Firebase dans votre projet Firebase.

Si vous n'utilisez aucun autre produit Firebase, il vous suffit de créer un projet et d'enregistrer votre application. Si vous décidez d'utiliser des produits supplémentaires, veillez à suivre toutes les étapes de la section Ajouter Firebase à votre projet Android.

Attention :Lorsque vous enregistrez votre application auprès de Firebase, saisissez le même nom de package que celui de l'application que vous distribuez. La valeur du nom du package est sensible à la casse et ne peut pas être modifiée pour votre application dans Firebase une fois qu'elle est enregistrée dans votre projet Firebase.
Pour associer Firebase à Google Play et importer des AAB, assurez-vous que votre application répond aux exigences suivantes:
- L'application dans Google Play et l'application Android pour Firebase sont enregistrées sous le même nom de package.
  
  Remarque :Vous pouvez importer des AAB pour des applications qui ne portent pas le même nom de package que votre application de production. Il vous suffit de créer une application dans Google Play et de la distribuer sur n'importe quel canal (vous n'avez pas besoin de sélectionner le canal de production). Google Play utilise ensuite le nom de package dans l'AAB pour enregistrer l'application Google Play.
- L'application dans Google Play est configurée dans le tableau de bord des applications et distribuée dans l'un des canaux Google Play (tests internes, de tests fermés, de tests ouverts ou de production).
- Une fois l'examen de l'application dans Google Play terminé, celle-ci est publiée. Votre application est publiée si la colonne État de l'application indique l'un des états suivants : "Tests internes" (pas "Brouillon" ni "Tests internes"), "Tests fermés", "Tests ouverts" ou "Production".
Associez votre application Android pour Firebase à votre compte de développeur Google Play:
1. Dans la console Firebase, accédez à Paramètres du projet, puis sélectionnez l'onglet Intégrations.
2. Sur la fiche Google Play, cliquez sur Associer.
  Si vous avez déjà effectué l'association, cliquez sur Gérer.
3. Suivez les instructions à l'écran pour activer l'intégration App Distribution et sélectionner les applications Android pour Firebase à associer à Google Play.
En savoir plus sur l'association à Google Play

Étape 1 : Créer votre application

Lorsque vous êtes prêt à distribuer une version préliminaire de votre application à des testeurs, créez votre AAB (consultez la documentation Android Studio pour obtenir des instructions).

Étape 2 : Distribuer votre application aux testeurs

Pour distribuer votre application aux testeurs, importez votre fichier AAB à l'aide de la console Firebase:

Ouvrez la page App Distribution de la console Firebase. Sélectionnez votre projet Firebase lorsque vous y êtes invité.
Sur la page Versions, sélectionnez l'application que vous souhaitez distribuer dans le menu déroulant.
Faites glisser le fichier AAB de votre application dans la console pour l'importer.
Une fois l'importation terminée, spécifiez les groupes de testeurs et les testeurs individuels que vous souhaitez recevoir le build. Ajoutez ensuite les notes de version de la version.

Pour en savoir plus sur la création de groupes de testeurs, consultez la section Gérer les testeurs.
Cliquez sur Distribuer pour rendre la version disponible pour les testeurs. Le testeur reçoit automatiquement une invitation par e-mail pour tester l'application.
(Facultatif) Pour partager des liens vers des versions spécifiques avec les testeurs qui y ont accès, cliquez sur l'icône Lien pour copier le lien de la version dans le presse-papiers.

Une fois que vous avez distribué votre build, il est disponible dans le tableau de bord App Distribution de la console Firebase pendant 150 jours (cinq mois). Lorsque le build est sur le point d'expirer dans 30 jours, une notification d'expiration s'affiche à la fois dans la console et dans la liste des builds de votre testeur sur son appareil de test.

Les testeurs qui n'ont pas été invités à tester l'application reçoivent des invitations par e-mail pour commencer, et les testeurs existants reçoivent des notifications par e-mail indiquant qu'une nouvelle version est prête à être testée. Pour savoir comment installer l'application de test, consultez la section Configurer un testeur avec App Distribution. Vous pouvez surveiller l'état de chaque testeur (s'il a accepté l'invitation et s'il a téléchargé l'application) dans la console Firebase.

Les testeurs disposent de 30 jours pour accepter une invitation à tester l'application avant qu'elle n'expire. Lorsqu'une invitation est sur le point d'expirer dans cinq jours, une notification d'expiration s'affiche dans la console Firebase à côté du testeur d'une version. Vous pouvez renouveler une invitation en la renvoyant à l'aide du menu déroulant de la ligne du testeur.

Étapes suivantes

Implémentez des commentaires dans l'application pour permettre aux testeurs d'envoyer facilement des commentaires sur votre application (y compris des captures d'écran).
Découvrez comment afficher des alertes dans l'application à vos testeurs lorsque de nouvelles versions de votre application sont disponibles à l'installation.
Découvrez les bonnes pratiques pour distribuer des applications Android aux testeurs de contrôle qualité à l'aide de la CI/CD.