Ce document explique comment utiliser les scripts Robo, qui sont des tests automatisant les tâches de contrôle qualité manuelles pour les applications mobiles, et permettant l'intégration continue (CI) et les stratégies de test pré-lancement. Par exemple, vous pouvez utiliser des scripts Robo pour tester un parcours utilisateur courant ou fournir une entrée d'interface utilisateur spécifique, comme un nom d'utilisateur et un mot de passe. Les scripts Robo sont une fonctionnalité du test Robo.
Avec les scripts Robo, vous vous enregistrez en train de parcourir un workflow dans votre application, puis vous importez cet enregistrement dans la console Firebase pour l'exécuter dans les tests Robo. Lorsque vous exécutez un test Robo avec un script associé, Robo commence par exécuter les actions pré-scénarisées, puis explore l'application comme d'habitude.
Les scripts Robo utilisent le test Robo comme moteur de test. Dans sa forme la plus simple, un script Robo consiste en une séquence d'actions d'interface utilisateur, telles que saisir le texte "nom d'utilisateur", puis appuyer sur le bouton OK. Les scripts Robo peuvent également inclure des actions telles que l'attente de l'apparition d'un élément, l'appui sur un point spécifique d'un élément et l'exécution de commandes shell Android Debug Bridge (adb).
Les scripts Robo présentent les avantages suivants par rapport aux frameworks de test traditionnels :
| Capacité | Description |
| Grande robustesse | Les scripts Robo peuvent tolérer des différences structurelles et comportementales importantes entre les versions de l'application et l'instabilité de l'application. |
| Question ouverte | Une fois qu'un script Robo est terminé, le test Robo de base peut prendre le relais et continuer à tester l'application. Cette approche de test continu permet de couvrir plusieurs cas d'utilisation clés. Par exemple, vous pouvez utiliser un script Robo pour placer une application dans un état particulier en effectuant un flux de connexion personnalisé. |
| Avec message enregistré | Vous n'avez pas besoin de coder manuellement les scripts Robo. Ils peuvent être enregistrés à l'aide de l'enregistreur de scripts Robo dans Android Studio. La création ou la modification de scripts Robo ne nécessite généralement aucune connaissance en développement mobile. |
| Flexible | Les scripts Robo peuvent interagir avec des éléments d'interface utilisateur non natifs courants dans les jeux. |
Les scripts Robo sont déclenchés de manière conditionnelle lors d'un test Robo, ce qui permet aux utilisateurs d'améliorer le comportement de Robo, généralement pour obtenir une meilleure couverture ou cibler des fonctionnalités spécifiques. Contrairement aux frameworks de test traditionnels, les scripts Robo sont compatibles avec les éléments suivants :
- Diverses conditions de déclenchement, par exemple, un nom de package d'application particulier actif (ou non) ou un élément spécifique affiché à l'écran (ou non).
- Contrôles d'exécution, par exemple un nombre maximal d'exécutions, une priorité, une étape d'exploration pertinente.
- Types d'actions non conventionnels (conditionnels, ignorant des éléments, fermant l'écran).
Nous vous recommandons d'utiliser des scripts Robo dans la mesure du possible, car ils peuvent être gérés sans effort. Par exemple, vous pouvez utiliser un script Robo pour effectuer les opérations suivantes :
- Parcourez les workflows importants pour accéder aux fonctionnalités de base d'une application. Par exemple, vous pouvez effectuer une connexion, configurer l'état d'une application après le premier lancement et enregistrer un nouvel utilisateur.
- Concentrez Robo sur une partie spécifique d'une application pour exploiter au mieux le temps de test Robo. Le script Robo guide le test Robo pour qu'il atteigne la partie pertinente d'une application, où le test Robo reprend une exploration entièrement automatisée.
- Placer une application dans un état ou sur un écran spécifique pour effectuer une analyse, par exemple pour analyser un message dans l'application, des règles de confidentialité ou un niveau spécifique d'un jeu.
- Effectuez un test d'instrumentation de bout en bout, avec ou sans test Robo reprenant une exploration entièrement automatisée une fois le script Robo terminé.
Utilisez des fonctionnalités de script Robo plus avancées pour effectuer les opérations suivantes :
- Effectuez des actions avant que Robo ne commence à explorer l'application testée ou une fois l'exploration terminée (par exemple, nettoyez les données de l'application testée avant une exploration ou modifiez les paramètres de l'appareil).
- Modifier certains aspects du comportement de Robo lors d'une exploration, en particulier :
- Faites en sorte que Robo ignore certains widgets d'interface utilisateur ou écrans d'application.
- Fournissez une action personnalisée que Robo doit effectuer lorsqu'il revient en arrière à partir d'un écran particulier.
- Faites en sorte que Robo effectue des actions spécifiques chaque fois qu'un écran d'application particulier est rencontré lors d'une exploration.
- Personnalisez entièrement la façon dont Robo effectue une exploration. Par exemple, utilisez une combinaison d'actions conditionnelles et non conditionnelles pour maintenir l'application testée en arrière-plan tout au long de l'exploration, tout en effectuant des manipulations sur l'appareil et en fermant les boîtes de dialogue pop-up qui s'affichent en cours de route.
N'oubliez pas que les scripts Robo ne remplacent pas tous les types de tests. Vous avez toujours besoin de tests unitaires pour détecter les bugs logiques de bas niveau dans votre application. Ces tests ne nécessitent généralement pas d'environnement Android ou iOS. Nous vous recommandons de compléter les tests de script Robo par des tests d'instrumentation ciblés pouvant comporter des assertions spécifiques et détaillées sur la logique métier, qui sont mieux exprimées dans le code.
Enregistrer un script Robo à l'aide de Test Lab dans Android Studio
L'enregistreur de scripts Robo d'Android Studio vous permet d'enregistrer des scripts Robo en interagissant directement avec l'application sur votre appareil. Suivez ces instructions pour commencer à utiliser les scripts Robo via l'outil Firebase dans Android Studio :
Ouvrez Android Studio, puis sélectionnez Tools -> Firebase (Outils -> Firebase).
Dans le volet Firebase, cliquez sur Record Robo Script and Use it to Guide Robo Test (Enregistrer un script Robo et l'utiliser pour guider le test Robo).
Cliquez sur Enregistrer un script Robo. La boîte de dialogue "Select Deployment Target" (Sélectionner une cible de déploiement) s'affiche.
Sélectionnez l'appareil sur lequel vous souhaitez enregistrer le script Robo.
Après avoir enregistré le script Robo sur l'appareil, enregistrez le fichier au format JSON à l'emplacement souhaité.
Ouvrez la page Test Lab dans la console Firebase, puis importez le fichier de script JSON et l'APK de l'application.
Cliquez sur le bouton Continuer. Vous êtes invité à sélectionner l'appareil et le niveau d'API. Une fois le script de test terminé, Test Lab génère le rapport de test.
(Facultatif) Pour copier ou télécharger le logcat du rapport de test et de la vidéo, cliquez sur Afficher les fichiers sources.
Par défaut, les mécanismes de robustesse du script Robo l'empêchent d'échouer prématurément.
Si vous choisissez le mode d'exécution strict et qu'un script Robo échoue à un moment donné, Test Lab abandonne toutes les étapes suivantes du script et reprend une exploration Robo standard. Le plus souvent, les scripts Robo échouent, car Robo ne trouve pas un élément requis à l'écran. Pour éviter les échecs, assurez-vous que la navigation dans votre application est prévisible et que vos écrans s'affichent dans un ordre déterministe.
Exécuter un script Robo dans Test Lab
Pour exécuter un script Robo dans Test Lab, procédez comme suit :
Ouvrez la page Test Lab dans la console Firebase.
Importez l'APK ou l'AAB de l'application dans le champ APK ou AAB de l'application.
Importez votre fichier de script Robo enregistré ou créé manuellement dans le champ Script Robo (facultatif).
Fournir un script Robo à une exécution de test Robo locale
Pour fournir un script Robo à une exécution de test Robo locale, utilisez l'option de test Robo suivante :
--robo-script-file <robo-script-path>
Remplacez <robo-script-path> par le chemin d'accès à votre fichier de script Robo dans le système de fichiers local. Suivez les instructions pour exécuter un test Robo local.
Spécifier un script Robo dans un appel de test gcloud CLI
Pour spécifier un script Robo dans un appel de test gcloud CLI, utilisez l'option gcloud CLI suivante :
--robo-script = <robo-script-path>
Remplacez <robo-script-path> par le chemin d'accès à votre fichier de script Robo dans le système de fichiers local ou dans Cloud Storage à l'aide de la notation gs://. Exemple :
gcloud firebase test android run --app = <path_to_app_apk_file> --robo-script = <robo-script-path>
Étapes suivantes
- Pour en savoir plus sur la structure, les fonctionnalités, l'utilisation et les actions des scripts Robo, consultez le guide de référence des scripts Robo.
- Exécutez un test Robo.