Exécuter un script Robo (Android)

Ce document explique comment utiliser les scripts Robo, qui sont des tests qui automatisent les tâches de contrôle qualité manuelles pour les applications mobiles, et permettent 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 (UI) 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 suivant un workflow dans votre application, puis vous importez cet enregistrement dans la console Firebase pour l'exécuter dans des tests Robo. Lorsque vous exécutez un test Robo avec un script associé, Robo exécute 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 basique, un script Robo consiste en une séquence d'actions d'interface utilisateur, comme 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'affichage d'un élément, le tapotement à 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 de l'application ainsi que sa fragilité.
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 continue permet de mettre en œuvre plusieurs cas d'utilisation clés. Par exemple, vous pouvez utiliser un script Robo pour placer une application dans un état particulier en exécutant un flux de connexion personnalisé.
Enregistrable Vous n'avez pas besoin de coder manuellement des scripts Robo. Ils peuvent être enregistrés à l'aide de l'enregistreur de scripts Robo d'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 les é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 étant actif (ou non) ou un élément spécifique affiché à l'écran (ou non).
  • Commandes d'exécution, par exemple, nombre maximal d'exécutions, priorité, étape d'exploration pertinente.
  • Types d'actions non conventionnels (conditionnel, ignorant un élément, fermeture de 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 principaux workflows pour aller au cœur de la fonctionnalité 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.
  • Axez Robo sur une partie spécifique d'une application pour tirer le meilleur parti du 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 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 qui reprend un crawl entièrement automatisé 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 d'effectuer 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'interface utilisateur ou écrans d'application.
    • Fournissez une action personnalisée que Robo doit effectuer lors du retour en arrière à partir d'un écran particulier.
    • Demandez à Robo d'effectuer des actions spécifiques chaque fois qu'un écran d'application particulier est rencontré lors d'un crawl.
  • Personnaliser entièrement la façon dont Robo effectue un crawl Par exemple, utilisez une combinaison d'actions conditionnelles et non conditionnelles pour maintenir l'application en cours de test en arrière-plan tout au long de l'exploration, tout en effectuant des manipulations de l'appareil et en fermant les boîtes de dialogue pop-up qui s'affichent au cours du processus.

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 avec des tests d'instrumentation ciblés qui peuvent comporter des assertions spécifiques et détaillées sur la logique métier, qui sont mieux exprimées en 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 à créer des scripts Robo via l'outil Firebase dans Android Studio:

  1. Ouvrez Android Studio, puis sélectionnez Tools -> Firebase (Outils -> Firebase).

  2. Dans le volet Firebase, cliquez sur Enregistrer un script Robo et l'utiliser pour guider le test Robo.

  3. Cliquez sur Enregistrer le script Robo. La boîte de dialogue "Sélectionner une cible de déploiement" s'affiche.

  4. Sélectionnez l'appareil sur lequel vous souhaitez enregistrer le script Robo.

  5. Après avoir enregistré le script Robo dans l'appareil, enregistrez-le en tant que fichier JSON à l'emplacement souhaité.

  6. Ouvrez la page Test Lab dans la console Firebase, puis importez le fichier de script JSON et l'APK de l'application.

  7. 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.

  8. (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 des scripts Robo empêchent leur échec prématuré. 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 régulière. Le plus souvent, les scripts Robo échouent, car Robo ne parvient pas à trouver 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 sont affichés 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:

  1. Ouvrez la page Test Lab dans la console Firebase.

  2. Importez l'APK ou l'AAB de l'application dans le champ APK ou AAB de l'application.

  3. 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 un 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 une invocation de test de la gcloud CLI

Pour spécifier un script Robo dans un appel de test de la gcloud CLI, utilisez l'option de CLI gcloud suivante:

--robo-script = <robo-script-path>

Remplacez <robo-script-path> par un 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