Ce document présente les bonnes pratiques d'utilisation de Firebase App Distribution pour assurer la durabilité et la reproductibilité de vos flux de travail de test des versions préliminaires d'Android Environnement CI/CD. Les solutions incluent Gradle et Fastlane, mais pour vous offrir encore plus de flexibilité, nous incluons également des solutions disponibles via la console Firebase, la CLI Firebase et l'API publique Firebase App Distribution. Nous décrivons également les limites de publication et de test afin que vous puissiez planifier à l'avance pour une expérience optimale.
Si vous utilisez également des plates-formes Apple, consultez Bonnes pratiques pour distribuer des applications Apple aux testeurs de contrôle qualité à l'aide de CI/CD et d'Fastlane
Avant de commencer
Avant d'implémenter les bonnes pratiques décrites dans ce document, veillez à activer App Distribution dans la console Firebase pour chaque application. Si vous ne l'avez pas activé, une erreur 404 s'affiche.
Pour activer App Distribution, procédez comme suit :
- Ouvrez la page App Distribution dans la console Firebase.
- Sélectionnez votre application Android.
- Cliquez sur Commencer.
Étant donné que les Android App Bundles (AAB) deviennent le format de package Android le plus courant, nous vous recommandons de configurer la possibilité de distribuer des AAB à vos testeurs en liant à Google Play.
Automatiser votre workflow de test en version préliminaire à l'aide d'un pipeline CI/CD
Si vous souhaitez automatiser la création et la mise à disposition d'applications pour vos testeurs et que vous à l'aide de la CI/CD, nous vous recommandons d'utiliser fastlane ou Gradle : Vous pouvez également utiliser la CLI Firebase, qui vous permet d'accéder à un large éventail de produits Firebase.
Utiliser la voie rapide
Intégrez App Distribution à votre pipeline CI/CD à l'aide de Fastlane, une solution Open Source qui automatise la création et la publication d'applications iOS et Android. En compilant et en distribuant automatiquement vos dernières versions aux testeurs, vous vous assurez qu'ils disposent toujours de la version de test la plus récente de votre application.
Pour découvrir comment intégrer App Distribution à fastlane, consultez Distribuer des applications Android aux testeurs à l'aide de fastlane.
Utiliser Gradle
Utilisez Gradle pour intégrer App Distribution à votre processus de compilation Android à l'aide de la
Plug-in Gradle App Distribution. Le plug-in vous permet de spécifier vos testeurs et les notes de version dans le fichier build.gradle
de votre application, ce qui vous permet de configurer des distributions pour différents types de compilation et variantes de votre application.
Pour découvrir comment intégrer App Distribution à Gradle, consultez la section Distribuer des applications Android aux testeurs à l'aide de Gradle.
Utiliser la CLI Firebase
Utilisez les outils CLI Firebase fournis par App Distribution pour distribuer des builds aux testeurs de manière programmatique. Vous pouvez spécifier des testeurs et des notes de version pour une compilation.
Distribuez votre dernier build Android en spécifiant l'ID d'application Firebase de l'application. si vous le souhaitez, vous pouvez ajouter une note de version et un fichier contenant les adresses e-mail des testeurs:
firebase appdistribution:distribute test.aab \
--app 1:1234567890:android:0a1b2c3d4e5f67890 \
--release-notes "Bug fixes and improvements" --testers-file testers.txt
Pour en savoir plus sur l'utilisation de la CLI Firebase pour automatiser vos compilations, consultez Distribuer des applications Android aux testeurs à l'aide de la CLI Firebase.
Utiliser des identifiants de service pour l'authentification
Utilisez le plug-in Fastlane App Distribution. le plug-in Gradle, ou la CLI Firebase avec des comptes de service. Un compte de service est un type de compte Google qui représente des applications (et non des utilisateurs). Votre système de CI peut utiliser des comptes de service pour exécuter vos charges de travail App Distribution. Pour en savoir plus, consultez S'authentifier avec un compte de service.
Si vous utilisez la fédération d'identité de charge de travail, vous pouvez générer et utiliser Fichier de configuration des identifiants au lieu d'une clé de compte de service.
Tenir compte des limites de publication
App Distribution accepte un maximum de 1 000 versions par application. Cela signifie que lorsque vous dépassez la limite de versions, App Distribution supprime automatiquement les versions les plus anciennes au-delà de cette limite. Pour savoir comment gérer les limites de publication, consultez la section Combien de temps les versions d'applications sont-elles disponibles ?
Ajouter le même groupe de testeurs à plusieurs versions
Si vous souhaitez ajouter un grand nombre de testeurs à vos versions, utilisez Fonctionnalité de gestion des testeurs groupés de App Distribution.
Nous vous recommandons d'utiliser des groupes pour ajouter les mêmes testeurs à plusieurs versions. Un groupe agit comme une liste de contrôle d'accès. lorsque vous supprimez un testeur d'un groupe, ils perdent l'accès à toutes les versions distribuées à ce groupe. Pour apprendre consultez Ajouter des testeurs à un groupe et en supprimer.
Si vous avez beaucoup de testeurs à gérer, vous pouvez ajouter et supprimer des testeurs de manière groupée. à l'aide de la console Firebase. Pour automatiser l'ajout et la suppression de testeurs, utilisez la CLI Firebase, fastlane Gradle, ou l'API publique Firebase App Distribution.
Gardez à l'esprit les limites des testeurs
App Distribution limite le nombre de testeurs que vous pouvez ajouter à un projet Firebase ou un groupe App Distribution. Lorsque vous dépassez ces limites, vous ne pouvez plus distribuer votre application à d'autres testeurs. Pour en savoir plus sur les limites pour les testeurs, Consultez la section Existe-t-il des limites pour ajouter des testeurs à mon application ?
Permettre aux testeurs potentiels de s'inscrire eux-mêmes aux tests
Pour faciliter la distribution de votre application à un plus grand nombre de testeurs, nous vous recommandons d'effectuer les actions suivantes : vous utilisez des liens d'invitation. Un lien d'invitation est une URL unique qui permet aux testeurs de saisir leur adresse e-mail pour s'inscrire et tester une application. Permettre aux utilisateurs de s'ajouter à votre liste de testeurs d'applications est un moyen simple d'augmenter votre base de test interne.
Il peut s'agir de programmes dogfood d'entreprise, d'organisations ayant les grandes équipes chargées du contrôle qualité et les groupes de développeurs qui souhaitent que chaque client pour contrôler l'accès des testeurs.
Nous vous recommandons de créer un lien d'invitation pour un groupe. Tout testeur qui signe à l'aide du lien d'invitation est automatiquement ajouté aux versions suivantes.
Pour en savoir plus, consultez les pages Créer des liens d'invitation et Ajouter et supprimer des testeurs d'un groupe.
Assurez-vous que les testeurs testent la version qui vous intéresse
Lorsqu'une nouvelle version est importée, vos testeurs en sont informés par e-mail. À en complément de cette notification, vous pouvez utiliser les fonctionnalités suivantes : et des alertes dans l'application, afin de vous assurer que vos testeurs testent le la version de l'application qui vous intéresse:
- Liens de version : utilisez cette fonctionnalité lorsque vous souhaitez partager une version spécifique avec des testeurs. Pour savoir comment utiliser les liens de version, consultez la section Distribuer des applications Android aux testeurs à l'aide de la console Firebase. Ces liens sont également disponible dans notre centre d'aide Firebase, fastlane Gradle de ligne de commande (CLI) à utiliser avec vos outils d'automatisation de compilation.
- Alertes dans l'application:utilisez ces alertes pour vous assurer que votre les testeurs testent la dernière version de votre application. En intégrant SDK Firebase App Distribution pour Android, vous pouvez afficher les alertes directement dans l'application à vos testeurs lorsque de nouvelles versions de votre application sont disponibles. Pour apprendre comment ajouter des alertes dans l'application, consultez Informez les testeurs des nouveaux builds.
Supprimer automatiquement l'accès des testeurs qui quittent l'entreprise
Lorsque votre flux de test interne CI/CD est opérationnel, vous devez vous assurer que les personnes qui quittent l'entreprise n'ont plus accès à vos builds internes. Pour vous aider à gérer l'accès des testeurs aux builds, App Distribution fournit les options suivantes:
- fastlane:utilisez votre fichier Fastfile ou exécutez directement des actions fastlane. Pour en savoir plus, consultez Distribuer des applications Android aux testeurs à l'aide de Fastlane.
- CLI Firebase:utilisez
firebase appdistribution:testers:remove
action. Pour en savoir plus, consultez Distribuer des applications Android aux testeurs à l'aide de la CLI Firebase. - Gradle:si vous utilisez Gradle pour supprimer des testeurs, transmettez
appDistributionRemoveTesters
avec les arguments
et--PROJECT_NUMBER
dans votre fichier--EMAILS build.gradle
. Pour en savoir plus, consultez la page Distribuer des applications Android aux testeurs à l'aide de Gradle. - API Firebase App Distribution publique : utilisez le point de terminaison
testers.batchRemove
.