Meilleures pratiques pour distribuer des applications Android aux testeurs QA à l'aide de CI/CD,Meilleures pratiques pour distribuer des applications Android aux testeurs QA à l'aide de CI/CD

Ce document présente les bonnes pratiques d'utilisation de Firebase App Distribution afin de rendre vos flux de travail de tests préliminaires Android durables et reproductibles dans un 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 des versions et des testeurs afin que vous puissiez planifier à l'avance une expérience optimale.

Si vous utilisez également des plates-formes Apple, consultez Bonnes pratiques pour la distribution d'applications Apple aux testeurs QA à l'aide de CI/CD et fastlane .

Avant que tu commences

Avant de mettre en œuvre les bonnes pratiques de ce document, assurez-vous d'activer App Distribution dans la console Firebase pour chaque application . Si vous n'avez pas activé App Distribution, vous obtiendrez une erreur 404.

Pour activer la distribution d'applications, procédez comme suit :

  1. Ouvrez la page Distribution d'applications dans la console Firebase.
  2. Sélectionnez votre application Android.
  3. 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 créant un lien vers Google Play .

Automatisez votre flux de travail de tests préliminaires à l'aide d'un pipeline CI/CD

Si vous souhaitez automatiser la création et la publication d'applications auprès de vos testeurs et que vous utilisez CI/CD, nous vous recommandons d'utiliser fastlane ou Gradle . Une autre option consiste à utiliser la Firebase CLI , qui vous permet d'accéder à un large éventail de produits Firebase.

Utiliser la voie rapide

Intégrez App Distribution dans votre pipeline CI/CD à l'aide de fastlane, un outil open source qui automatise la création et la publication d'applications iOS et Android. En créant et en distribuant automatiquement vos dernières versions aux testeurs, vous vous assurez que ceux-ci disposent toujours de la version de test la plus à jour de votre application.

Pour savoir comment intégrer App Distribution à Fastlane, consultez Distribuer des applications Android aux testeurs utilisant Fastlane .

Utiliser Gradle

Utilisez Gradle pour intégrer App Distribution dans votre processus de création Android à l'aide du plugin App Distribution Gradle. Le plugin vous permet de spécifier vos testeurs et vos notes de version dans le fichier build.gradle de votre application, ce qui vous permet de configurer des distributions pour différents types de build et variantes de votre application.

Pour savoir comment intégrer App Distribution à Gradle, consultez Distribuer des applications Android aux testeurs utilisant Gradle .

Utiliser la CLI Firebase

Utilisez les outils Firebase CLI fournis par App Distribution pour distribuer les builds aux testeurs par programmation. Vous pouvez spécifier des testeurs et des notes de version pour une version.

Distribuez votre dernière version d'Android en spécifiant l'ID d'application Firebase de l'application, en ajoutant éventuellement une note de version et un fichier contenant les e-mails 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 Firebase CLI pour automatiser vos builds, consultez Distribuer des applications Android aux testeurs à l'aide de Firebase CLI .

Utiliser les informations d'identification du service pour vous authentifier

Utilisez le plugin App Distribution fastlane , le plugin Gradle ou la Firebase CLI avec des comptes de service. Un compte de service est un type de compte Google qui représente des applications (par opposition aux utilisateurs). Votre système 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 Workload Identity, vous pouvez générer et utiliser un fichier de configuration d'informations d'identification au lieu d'une clé de compte de service.

Gardez à l’esprit les limites de publication

App Distribution prend en charge 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 dépassant la limite. Pour savoir comment gérer les limites de versions, consultez Combien de temps les versions d'application sont-elles disponibles ?

Ajouter le même ensemble de testeurs à plusieurs versions

Si vous souhaitez ajouter un grand nombre de testeurs à vos versions, utilisez la fonctionnalité de gestion groupée des testeurs d'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, il perd l'accès à toutes les versions distribuées à ce groupe. Pour en savoir plus, consultez Ajouter et supprimer des testeurs d'un groupe .

Si vous avez beaucoup de testeurs à gérer, vous pouvez ajouter et supprimer des testeurs en masse à l'aide de la console Firebase. Pour automatiser l'ajout et la suppression de testeurs, utilisez la Firebase CLI , fastlane , Gradle ou l' API publique Firebase App Distribution .

Gardez à l'esprit les limites du testeur

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 pourrez plus distribuer votre application à des testeurs supplémentaires. Pour en savoir plus sur les limites des testeurs, consultez Existe-t-il des limites pour l’ajout de testeurs à mon application ?

Permettre aux testeurs potentiels de s’auto-inscrire pour les tests

Pour faciliter la distribution de votre application à davantage de testeurs, nous vous recommandons d'utiliser 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 transparent d'augmenter votre base de tests internes.

Les cas d'utilisation des liens d'invitation incluent les programmes dogfood d'entreprise, les organisations dotées de grandes équipes d'assurance qualité et les groupes de développeurs qui souhaitent que les clients individuels puissent contrôler l'accès des testeurs.

Nous vous recommandons de créer un lien d'invitation pour un groupe. Tout testeur qui s'inscrit à l'aide du lien d'invitation est automatiquement ajouté aux versions suivantes.

Pour en savoir plus, consultez 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 téléchargée, vos testeurs sont avertis par email. Pour compléter cette notification, vous pouvez utiliser les fonctionnalités suivantes (liens de publication et alertes dans l'application) pour vous assurer que vos testeurs testent la version spécifique 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 Distribuer des applications Android aux testeurs à l'aide de la console Firebase . Ces liens sont également disponibles avec nos outils de ligne de commande (CLI) Firebase , fastlane et Gradle à utiliser avec vos outils d'automatisation de build.
  • Alertes dans l'application : utilisez ces alertes lorsque vous souhaitez vous assurer que vos testeurs testent la dernière version de votre application. En intégrant le SDK Android Firebase App Distribution, vous pouvez afficher des alertes directement dans l'application à vos testeurs lorsque de nouvelles versions de votre application sont disponibles. Pour savoir comment ajouter des alertes dans l'application, consultez Informer les testeurs des nouvelles builds .

Supprimer automatiquement l'accès aux testeurs qui quittent l'entreprise

Lorsque votre flux de tests internes 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 propose les options suivantes :