Ce guide décrit comment distribuer automatiquement les builds aux testeurs à l'aide de la fonctionnalité App Distribution Automated Tester de 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 que tu commences
Si vous ne l'avez pas déjà 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 des produits supplémentaires à 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 en suivant votre processus habituel. Vous devez signer l'APK avec votre clé de débogage ou votre clé de signature d'application.
Distribuez votre application sur Automated Tester à l'aide de la console Firebase
Pour distribuer votre application sur Automated Tester, téléchargez votre fichier APK à l'aide de la console Firebase :
- Ouvrez la page Distribution d'applications 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 vers la console pour le télécharger.
- Une fois le téléchargement terminé, sélectionnez Testeur automatisé dans la barre de recherche Ajouter des testeurs ou des groupes .
- Pour personnaliser votre test automatisé, cliquez sur l'icône Modifier et sélectionnez les personnalisations dans la boîte de dialogue Personnaliser votre test automatisé .
- (Facultatif) Dans la boîte de dialogue de 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 qui peuvent être utilisés pendant le test si votre application nécessite des informations de connexion.
- Cliquez sur Distribuer . Vous pouvez également ajouter une note de version facultative pour votre application.
Distribuez votre application sur Automated Tester à l'aide de la CLI Firebase
Exécutez la commande appdistribution:distribute pour télécharger votre application et la distribuer aux testeurs. Utilisez les paramètres suivants pour configurer votre distribution sur la fonctionnalité Automated Tester :
| appdistribution:options de distribution | |
|---|---|
--test-devices ou --test-devices-file | Les appareils de test sur lesquels vous souhaitez distribuer les builds à la fonctionnalité Automated Tester. Vous pouvez spécifier les appareils de test sous forme de liste d'appareils de test séparés par des points-virgules : --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 de périphériques de test séparés par des points-virgules : --test-devices-file: "/path/to/test-devices.txt" |
--test-username | Le nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés . |
--test-password ou --test-password-file | Le 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 pour le champ du nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés . |
--test-password-resource | Nom de la ressource pour le champ mot de passe pour la connexion automatique à utiliser lors des tests automatisés . |
--test-non-blocking | Exécutez des tests automatisés de manière asynchrone. Visitez la console Firebase pour les résultats des tests automatiques. |
Pour plus d'informations sur la prise en main de Firebase CLI et les différentes manières de configurer votre distribution, consultez Distribuer des applications Android aux testeurs à l'aide de Firebase CLI .
Distribuez votre application sur Automated Tester à l'aide de Gradle
Vous pouvez configurer App Distribution en ajoutant au moins une section firebaseAppDistribution et en utilisant les paramètres suivants pour configurer la distribution sur la fonctionnalité Automated Tester :
| Paramètres de construction de distribution d'applications | |
|---|---|
testDevices ou testDevicesFile | Les appareils de test sur lesquels vous souhaitez distribuer les builds à l'aide de tests automatisés . Vous pouvez spécifier les appareils de test sous forme de liste de spécifications d'appareil séparées par des points-virgules. testDevices="model=shiba, version=34, locale=en, orientation=portrait;model=b0p, version=33, locale=en, orientation=portrait"Vous pouvez également spécifier le chemin d'accès à un fichier contenant une liste de spécifications de périphérique séparées par des points-virgules : testDevicesFile="/path/to/testDevices.txt" |
testUsername | Le nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés . |
testUsernameResource | Nom de la ressource pour le champ du nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés . |
testPassword ou testPasswordFile | Le 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 pour le champ mot de passe pour la connexion automatique à utiliser lors des tests automatisés . |
testNonBlocking | Exécutez des tests automatisés de manière asynchrone. Visitez la console FIrebase pour les résultats des tests automatiques. |
Pour plus d'informations sur la prise en main de Gradle et les différentes manières de configurer votre distribution, consultez Distribuer des applications Android aux testeurs utilisant Gradle .
Distribuez votre application sur Automated Tester à l'aide de Fastlane
Dans une voie ./fastlane/Fastfile , ajoutez un bloc firebase_app_distribution . Utilisez les paramètres suivants pour configurer votre distribution sur la fonctionnalité Automated Tester :
| Paramètres firebase_app_distribution | |
|---|---|
test_devices ou test_devices_file | Les appareils de test sur lesquels vous souhaitez distribuer les builds à la fonctionnalité Automated Tester. Vous pouvez spécifier les appareils de test sous forme de liste d'appareils de test séparés par des points-virgules : 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 de périphériques de test séparés par des points-virgules : test_devices_file: "/path/to/test-devices.txt" |
test_username | Le nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés . |
test_password ou test_password_file | Le 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 pour le champ du nom d'utilisateur pour la connexion automatique à utiliser lors des tests automatisés . |
test_password_resource | Nom de la ressource pour le champ mot de passe pour la connexion automatique à utiliser lors des tests automatisés . |
test_non_blocking | Exécutez des tests automatisés de manière asynchrone. Visitez la console FIrebase pour les résultats des tests automatiques. |
Pour plus d'informations sur la prise en main de Fastlane et les différentes manières de configurer votre distribution, consultez Distribuer des applications Android aux testeurs utilisant Fastlane .
Statuts d'exploration des tests automatiques
Pour vous aider à interpréter les résultats de vos tests, l'onglet Résultats des tests automatisés affiche tous les problèmes de test, des captures d'écran de l'application et une vidéo de l'exploration du test pour chaque appareil. Le statut du test peut être trouvé sur la page de résultats de votre test :
| État de l'exploration | Description |
|---|---|
| En attente | Le test automatique est toujours en cours et vos résultats seront bientôt disponibles. |
| Passé | Le test automatique a exploré avec succès votre application et n’a détecté aucun plantage. |
| Échoué | Le test automatique a échoué car votre application est tombée en panne pendant le test. |
| Non concluant | Le test automatique a échoué en raison d'erreurs d'infrastructure. |