Ce document présente les bonnes pratiques à suivre pour utiliser Firebase App Distribution et Fastlane afin de rendre vos workflows de test en version préliminaire de la plate-forme Apple durables et reproductibles dans un environnement CI/CD. Bien que ce document se concentre sur Fastlane, nous décrivons également les solutions disponibles via la console Firebase, la CLI Firebase et l'API publique App Distribution Firebase pour vous offrir plus de flexibilité. 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 Android, consultez les bonnes pratiques pour distribuer des applications Android aux testeurs QA à l'aide de la CI/CD.
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.App Distribution
Pour activer App Distribution, procédez comme suit:
Ouvrez la page App Distribution dans la console Firebase.
Sélectionnez votre application iOS.
Cliquez sur Commencer.
Automatiser votre workflow de test en version préliminaire à l'aide de CI/CD
Si vous souhaitez automatiser la création et le déploiement d'applications auprès de vos testeurs et que vous utilisez la CI/CD, nous vous recommandons d'utiliser fastlane. Vous pouvez également utiliser la CLI Firebase, qui vous permet d'accéder à un large éventail de produits Firebase.
Utiliser Fastlane
Intégrez App Distribution à votre pipeline CI/CD à l'aide de Fastlane, un outil Open Source qui automatise la compilation 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 la section Distribuer des applications iOS aux testeurs à l'aide de fastlane. Consultez également un atelier de programmation qui vous explique le processus d'intégration Fastlane.
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 iOS test.ipa
en spécifiant l'ID d'application Firebase de l'application, et en ajoutant éventuellement une note de version et un fichier contenant les adresses e-mail des testeurs:
firebase appdistribution:distribute test.ipa \ --app 1:1234567890:ios: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 la section Distribuer des applications iOS aux testeurs à l'aide de la CLI Firebase.
Utiliser des identifiants de service pour l'authentification
Utilisez le plug-in fastlane App Distribution ou la CLI Firebase avec des comptes de service, qui exploitent les identifiants par défaut de l'application et vous aident à gérer votre CI. 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 un 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 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 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 des 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 devez gérer un grand nombre de testeurs, vous pouvez en ajouter et en supprimer 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 ou l'API publique App Distribution Firebase.
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 concernant les testeurs, consultez Existe-t-il des limites concernant l'ajout de testeurs à mon application ?
Gérer et ajouter automatiquement de nouveaux appareils de test iOS
Pour vous aider à enregistrer des appareils de test iOS supplémentaires, App Distribution vous aide à gérer vos appareils de test iOS sur le portail pour développeurs Apple en vous informant des nouveaux appareils de test iOS par e-mail ou par fichier CSV. Pour en savoir plus, consultez la section Importer des testeurs à partir de fichiers CSV. Vous pouvez également exporter de nouveaux appareils de manière programmatique à l'aide de Fastlane.
Pour savoir comment configurer une action Fastlane qui extrait automatiquement les UDID, les ajoute à la console de développement Apple, puis reconstruit l'application et la distribue, consultez Distribuer vos versions iOS préliminaires plus rapidement avec App Distribution et Fastlane.
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'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 simple d'augmenter votre base de test interne.
Les cas d'utilisation des liens d'invitation incluent les programmes de dogfood d'entreprise, les organisations disposant d'équipes de contrôle qualité importantes 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 ultérieures.
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
Lorsque vous importez une nouvelle version, vos testeurs en sont informés par e-mail. Pour compléter cette notification, vous pouvez utiliser les fonctionnalités suivantes (liens de version et alertes dans l'application) pour vous assurer que vos testeurs testent la version d'application spécifique qui vous intéresse:
Liens vers les versions:utilisez cette fonctionnalité lorsque vous souhaitez partager une version spécifique avec des testeurs. Pour savoir comment utiliser les liens de version, consultez la page Distribuer des applications iOS aux testeurs à l'aide de la console Firebase. Ces liens sont également disponibles avec nos outils de ligne de commande (CLI) Firebase et fastlane à utiliser avec vos outils d'automatisation de compilation.
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 iOS App Distribution Firebase, vous pouvez afficher des alertes directement dans l'application pour vos testeurs lorsque de nouvelles versions de votre application sont disponibles. Pour savoir comment ajouter des alertes dans l'application, consultez Notifier les testeurs de nouveaux builds.
Supprimer automatiquement l'accès des testeurs qui quittent l'entreprise
Une fois que 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 sur l'utilisation de fastlane pour supprimer des testeurs, consultez Distribuer des applications iOS aux testeurs à l'aide de fastlane.
API Firebase App Distribution publique:utilisez le point de terminaison
testers.batchRemove
.