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 interne d'application d'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écuter des APK optimisés (fournis par Google Play) pour les appareils de vos testeurs.
Détecter et déboguer les problèmes spécifiques à un appareil.
Tester des fonctionnalités pour app bundles comme Play Feature Delivery et Play Asset Delivery.
Réduire 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 à un propriétaire de projet Firebase de vous attribuer le rôle approprié via les Firebase paramètres IAM de la console. 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ôle(s) IAM incluant les autorisations requises par défaut | Rôle(s) supplémentaire(s) requis |
|---|---|---|---|
| Associer une application Firebase à une application dans Google Play | firebase.playLinks.update
|
L'un des rôles suivants : | 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 : | –– |
Avant de commencer
Si ce n'est pas déjà 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.
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.
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, tests fermés, tests ouverts ou 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 "Tests internes à l'état brouillon"), "Tests fermés", "Tests ouverts" ou "Production".
Associez votre application Android pour Firebase à votre compte de développeur Google Play :
Dans la console Firebase, accédez à vos
Paramètres du projet , puis sélectionnez l'onglet Intégrations.Sur la fiche Google Play, cliquez sur Associer.
Si vous avez déjà associé des liens Google Play, cliquez sur Gérer au lieu de cela.Suivez les instructions à l'écran pour activer l'App Distribution intégration et sélectionnez 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 aux 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 Firebase console :
Ouvrez la App Distribution page de la Firebase console. Lorsque vous y êtes invité, sélectionnez votre projet Firebase.
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 vers la console pour l'importer.
Une fois l'importation terminée, spécifiez les groupes de testeurs et les testeurs individuels qui doivent recevoir le build. Ajoutez ensuite des notes de version pour le build.
Pour en savoir plus sur la création de groupes de testeurs, consultez la page Gérer les testeurs.
Cliquez sur Distribuer pour mettre le build à la disposition des 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 App Distribution tableau de bord de la Firebase console pendant 150 jours (cinq mois). Lorsque le build arrive à 30 jours de son expiration, un avis d'expiration s'affiche 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'un nouveau build est prêt à être testé. Pour obtenir des instructions sur l'installation de l'application de test, consultez la page Se configurer en tant que 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 Firebase console.
Les testeurs disposent de 30 jours pour accepter une invitation à tester l'application avant qu'elle n'expire. Lorsqu'une invitation arrive à cinq jours de son expiration, un avis d'expiration s'affiche dans la Firebase console à côté du testeur sur une version. Une invitation peut être renouvelée en la renvoyant à l'aide du menu déroulant de la ligne du testeur.
Étapes suivantes
Implémentez des commentaires intégrés à 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 intégrées à l'application à vos testeurs lorsque de nouveaux builds de votre application sont disponibles pour l'installation.
Découvrez les bonnes pratiques pour distribuer des applications Android aux testeurs QA à l'aide de la CI/CD.