Ce guide explique comment distribuer automatiquement des builds aux testeurs à l'aide de la fonctionnalité de testeur automatisé App Distribution dans la console Firebase. La fonctionnalité Testeur automatisé fournit un outil de test de fumée toujours prêt et facile à utiliser pour votre application.
Avant de commencer
Si ce n'est pas encore fait, ajoutez Firebase à votre projet Android.
Si vous n'utilisez aucun autre produit Firebase, il vous suffit de créer un projet et d'enregistrer votre application. Toutefois, si vous décidez d'utiliser d'autres produits à l'avenir, veillez à suivre toutes les étapes de la section Ajouter Firebase à l'aide de la console Firebase.
Lorsque vous êtes prêt à distribuer une version préliminaire de votre application aux testeurs, créez votre APK à l'aide de votre processus normal. Vous devez signer l'APK avec votre clé de débogage ou votre clé de signature d'application.
Distribuer votre application au testeur automatisé à l'aide de la console Firebase
Pour distribuer votre application à l'outil Automated Tester, importez votre fichier APK à 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 APK de votre application dans la console pour l'importer.
- Une fois l'importation terminée, sélectionnez Testeur automatique dans la barre de recherche Ajouter des testeurs ou des groupes.
- Pour personnaliser votre test automatisé, cliquez sur l'icône Modifier, puis sélectionnez les personnalisations dans la boîte de dialogue Personnaliser votre test automatisé.
- (Facultatif) Dans la boîte de dialogue Device configuration (Configuration de l'appareil), sélectionnez le niveau d'API, l'orientation de l'appareil et les paramètres régionaux qui répondent à vos spécifications de test.
- (Facultatif) Cliquez sur le menu déroulant Identifiants de connexion pour créer un nom d'utilisateur et un mot de passe personnalisés à utiliser pendant le test si votre application nécessite des identifiants de connexion.
- Cliquez sur Distribuer. Vous pouvez également ajouter une note de version facultative pour votre application.
Distribuer votre application au testeur automatisé à l'aide de la CLI Firebase
Exécutez la commande appdistribution:distribute pour importer votre application et la distribuer aux testeurs. Utilisez les paramètres suivants pour configurer votre distribution pour la fonctionnalité de testeur automatique:
| appdistribution:distribute options | |
|---|---|
--test-devices ou --test-devices-file
|
Les appareils de test sur lesquels vous souhaitez distribuer des builds à la fonctionnalité de testeur automatisé. Vous pouvez spécifier les appareils de test sous forme de liste d'appareils séparés par un point-virgule: --test-devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"
Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'appareils de test séparés par une virgule: --test-devices-file: "/path/to/test-devices.txt"
|
--test-username
|
Nom d'utilisateur à utiliser pour la connexion automatique lors des tests automatisés. |
--test-password ou --test-password-file
|
Mot de passe de connexion automatique à utiliser lors des tests automatisés. Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant un mot de passe: --test-password-file: "/path/to/test-password.txt"
|
--test-username-resource
|
Nom de la ressource du champ du nom d'utilisateur à utiliser pour la connexion automatique lors des tests automatisés. |
--test-password-resource
|
Nom de la ressource du champ de mot de passe à utiliser pour la connexion automatique lors des tests automatisés. |
--test-non-blocking |
Exécutez des tests automatisés de manière asynchrone. Accédez à la console Firebase pour consulter les résultats des tests automatiques. |
Pour en savoir plus sur les premiers pas avec la CLI Firebase et les différentes façons de configurer votre distribution, consultez Distribuer des applications Android aux testeurs à l'aide de la CLI Firebase.
Distribuer votre application au testeur automatisé à l'aide de Gradle
Vous pouvez configurer App Distribution en ajoutant au moins une section firebaseAppDistribution et utiliser les paramètres suivants pour configurer la distribution de la fonctionnalité Testeur automatique:
| App Distribution Paramètres de compilation | |
|---|---|
testDevices ou testDevicesFile
|
Les appareils de test sur lesquels vous souhaitez distribuer des builds à l'aide de tests automatisés. Vous pouvez spécifier les appareils de test sous la forme d'une liste de spécifications d'appareils séparées par une virgule. testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"
Vous pouvez également spécifier le chemin d'accès à un fichier contenant une liste de spécifications d'appareils séparées par une virgule: testDevicesFile="/path/to/testDevices.txt"
|
testUsername
|
Nom d'utilisateur à utiliser pour la connexion automatique lors des tests automatisés. |
testUsernameResource
|
Nom de la ressource du champ du nom d'utilisateur à utiliser pour la connexion automatique lors des tests automatisés. |
testPassword ou testPasswordFile
|
Mot de passe de connexion automatique à utiliser lors des tests automatisés. Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant un mot de passe: testPasswordFile="/path/to/testPassword.txt" |
testPasswordResource
|
Nom de la ressource du champ de mot de passe à utiliser pour la connexion automatique lors des tests automatisés. |
testNonBlocking |
Exécutez des tests automatisés de manière asynchrone. Consultez la console Firebase pour obtenir les résultats des tests automatiques. |
Pour en savoir plus sur la prise en main de Gradle et les différentes manières de configurer votre distribution, consultez Distribuer des applications Android aux testeurs à l'aide de Gradle.
Distribuer votre application au testeur automatisé à l'aide de Fastlane
Dans une voie ./fastlane/Fastfile, ajoutez un bloc firebase_app_distribution. Utilisez les paramètres suivants pour configurer votre distribution pour la fonctionnalité de testeur automatique:
| Paramètres firebase_app_distribution | |
|---|---|
test_devices ou test_devices_file
|
Les appareils de test sur lesquels vous souhaitez distribuer des builds à la fonctionnalité de testeur automatisé. Vous pouvez spécifier les appareils de test sous forme de liste d'appareils séparés par un point-virgule: test_devices: "model=shiba, version=34, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"
Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'appareils de test séparés par une virgule: test_devices_file: "/path/to/test-devices.txt"
|
test_username
|
Nom d'utilisateur à utiliser pour la connexion automatique lors des tests automatisés. |
test_password ou test_password_file
|
Mot de passe de connexion automatique à utiliser lors des tests automatisés. Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant un mot de passe: test_password_file: "/path/to/test-password.txt"
|
test_username_resource
|
Nom de la ressource du champ du nom d'utilisateur à utiliser pour la connexion automatique lors des tests automatisés. |
test_password_resource
|
Nom de la ressource du champ de mot de passe à utiliser pour la connexion automatique lors des tests automatisés. |
test_non_blocking |
Exécutez des tests automatisés de manière asynchrone. Consultez la console Firebase pour obtenir les résultats des tests automatiques. |
Pour en savoir plus sur la prise en main de fastlane et les différentes façons de configurer votre distribution, consultez Distribuer des applications Android aux testeurs à l'aide de fastlane.
États des explorations de test automatiques
Pour vous aider à interpréter les résultats de vos tests, l'onglet Résultats des tests automatisés affiche les problèmes de test, des captures d'écran de l'application et une vidéo de l'exploration du test pour chaque appareil. L'état du test est indiqué sur la page des résultats:
| État de l'exploration | Description |
|---|---|
| En attente | Le test automatique est toujours en cours. Les résultats seront bientôt disponibles. |
| Réussi | Le test automatique a pu explorer votre application et n'a détecté aucun plantage. |
| Échec | Le test automatique a échoué, car votre application a planté pendant le test. |
| Non concluant | Le test automatique a échoué en raison d'erreurs d'infrastructure. |