Ce document explique comment utiliser les scripts Robo, qui sont des tests qui automatisent les tâches manuelles d'assurance qualité pour les applications mobiles et permettent des stratégies d'intégration continue (CI) et de tests avant lancement. Par exemple, vous pouvez utiliser des scripts Robo pour tester le parcours utilisateur habituel ou fournir des entrées spécifiques de l'interface utilisateur (UI), comme un nom d'utilisateur et un mot de passe. Les scripts Robo sont une fonctionnalité du test Robo.
Les scripts Robo vous permettent d'enregistrer votre parcours dans un workflow de votre application, puis d'importer cet enregistrement dans la console Firebase pour l'exécuter dans les tests Robo. Lorsque vous exécutez un test Robo avec un script, Robo réalise d'abord les actions décrites dans le script, puis explore l'application comme d'habitude.
Les scripts Robo utilisent le test Robo comme moteur de test. Dans sa forme la plus élémentaire, un script Robo se compose d'une séquence d'actions d'UI telles que enter text 'username' (saisir le texte "nom d'utilisateur") puis tap the OK button (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 |
| Très robuste | Les scripts Robo peuvent tolérer des différences structurelles et comportementales importantes entre les versions d'application, ainsi que l'instabilité des applications. |
| Question ouverte | Une fois un script Robo terminé, le test Robo de base peut prendre le relais et continuer à tester l'application. Cette approche de test continu permet plusieurs cas d'utilisation clés. Par exemple, vous pouvez utiliser un script Robo pour amener une application dans un état particulier en effectuant un flux de connexion personnalisé. |
| Avec message enregistrable | Vous n'avez pas besoin de coder manuellement les scripts Robo. Vous pouvez les enregistrer à l'aide de l'enregistreur de script Robo dans Android Studio. En règle générale, la création ou la modification de scripts Robo ne nécessite aucune connaissance en développement mobile. |
| Flexible | Les scripts Robo peuvent interagir avec des éléments d'UI 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'augmenter le comportement de Robo, généralement pour obtenir une couverture plus large 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 étant actif (ou non) ou un élément spécifique étant affiché à l'écran (ou non).
- Contrôles d'exécution, par exemple, nombre maximal d'exécutions, priorité, étape d'exploration pertinente.
- Types d'actions non conventionnels (conditionnelles, ignorant les éléments, fermant l'écran).
Nous vous recommandons d'utiliser des scripts Robo chaque fois que 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 au cœur des fonctionnalités 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 maximum le temps de test Robo. Le script Robo guide le test Robo vers la partie pertinente d'une application, où le test Robo reprend une exploration entièrement automatisée.
- Amenez une application dans un état ou sur un écran spécifique pour effectuer une analyse, par exemple pour analyser un message intégré à 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, en 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 après la fin d'une exploration. Par exemple, nettoyez les données de l'application testée avant une exploration ou modifiez les paramètres de l'appareil.
- Modifiez certains aspects du comportement de Robo lors d'une exploration, en particulier :
- Faites en sorte que Robo ignore certains widgets d'UI ou écrans d'application.
- Fournissez une action personnalisée que Robo doit effectuer lors du retour en arrière à partir d'un écran spécifique.
- Faites effectuer des actions spécifiques à Robo chaque fois qu'un écran d'application particulier est rencontré lors d'une exploration.
- Personnalisez entièrement la façon dont Robo effectue l'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 apparaissent 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 de logique de bas niveau dans votre application. Ces tests ne nécessitent généralement pas d'environnement Android ni iOS. Nous vous recommandons de compléter les tests de script Robo par des tests d'instrumentation ciblés qui peuvent contenir 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 dans 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 avec l'outil Firebase dans Android Studio :
Ouvrez Android Studio et sélectionnez Tools > Firebase (Outils > Firebase).
Dans le volet Firebase, cliquez sur Enregistrer un script Robo et l'utiliser pour guider le test Robo.
Cliquez sur Enregistrer le script Robo. La boîte de dialogue "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 normale. Le plus souvent, les scripts Robo échouent parce que 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 le fichier de script Robo que vous avez enregistré ou créé manuellement dans le champ Script Robo (facultatif).
Fournir un script Robo à une exécution de test Robo local
Pour fournir un script Robo à une exécution de test Robo local, 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.