Ce document fournit des informations de référence sur les scripts Robo, y compris la structure, les capacités, l'utilisation, l'enregistrement et les actions. Les scripts robotiques sont des tests qui automatisent les tâches manuelles d'assurance qualité (QA) pour les applications mobiles et permettent l'intégration continue (CI) et les stratégies de test de pré-lancement. Un script Robo est un fichier JSON qui décrit une séquence d'interface utilisateur (UI) et d'autres actions.
Vous pouvez créer un script Robo des manières suivantes :
- Utilisez la fonction d'enregistrement de script Robo.
- Créez le script Robo manuellement.
- Enregistrez le script Robo, puis modifiez-le manuellement.
Pour en savoir plus sur l'utilisation des scripts Robo, consultez Exécuter un script Robo .
Le script Robo est fourni au test Robo avec d'autres entrées telles que le package d'application Android (APK) de l'application en cours de test.
Voici un exemple de script Robo qui connecte un utilisateur à une application :
[
{
"eventType": "VIEW_TEXT_CHANGED",
"replacementText": "user123",
"elementDescriptors": [
{
"resourceId": "my.app.package:id/username"
}
]
},
{
"eventType": "VIEW_TEXT_CHANGED",
"replacementText": "12345",
"elementDescriptors": [
{
"resourceId": "my.app.package:id/password"
}
]
},
{
"eventType": "VIEW_CLICKED",
"elementDescriptors": [
{
"resourceId": "my.app.package:id/login"
}
]
}
]
Structure
Chaque action d'un script Robo est représentée sous la forme d'un ensemble d'une ou plusieurs paires attribut-valeur, qui sont décrites dans le tableau suivant :
Attribut | La description |
eventType | Spécifie le type de l'action, par exemple, clic, modification de texte, etc. Obligatoire pour chaque action. |
elementDescriptors | Descripteurs qui identifient un widget d'interface utilisateur. Requis pour toutes les actions qui ont un widget d'interface utilisateur cible, comme cliquer sur un bouton particulier. |
optional | Si la valeur est true , cette action est ignorée lorsqu'elle ne peut pas être effectuée. Par exemple, cette action est ignorée lorsqu'elle ne trouve pas son widget d'interface utilisateur cible sur un écran, sans faire échouer le script Robo contenant. Par défaut, la valeur est false . |
replacementText | Le texte à saisir dans le widget d'interface utilisateur cible. Obligatoire pour les actions d'édition de texte. |
swipeDirection | Spécifie la direction du balayage. Obligatoire pour les actions de balayage. |
delayTime | Spécifie le temps d'attente, en millisecondes. Obligatoire pour les actions d'attente. |
pointTapXCoordinate et pointTapYCoordinate | Coordonnées pixel X et Y du point tapé. Mutuellement exclusif avec pointTapXPercent et pointTapYPercent . Requis pour les actions d'appui ponctuel. |
pointTapXPercent et pointTapYPercent | Coordonnées X et Y en pourcentage du point tapé. Mutuellement exclusif avec pointTapXCoordinate et pointTapYCoordinate . Requis pour les actions d'appui ponctuel. |
Voici un exemple de script Robo avec deux actions sans widgets d'interface utilisateur cibles, ce qui signifie que ces actions ne fonctionnent pas sur un widget d'interface utilisateur spécifique :
[
{
"eventType": "DELAYED_MESSAGE_POSTED",
"delayTime": 3000
},
{
"eventType": "PRESSED_BACK"
}
]
Descripteurs d'éléments
Un descripteur d'élément identifie un widget d'interface utilisateur à l'aide d'un ou plusieurs des attributs d'identification suivants :
Attribut | La description |
className | – |
ancestorClassName | Nom de classe de l'ancêtre de la hiérarchie de l'interface utilisateur de l'élément. Un ancêtre est l'un des nœuds parents dans la hiérarchie de l'interface utilisateur de l'élément, y compris l'élément lui-même. |
resourceId | – |
resourceIdRegex | Expression régulière Java pour correspondre à resourceId . |
contentDescription | – |
contentDescriptionRegex | Expression régulière Java pour correspondre à contentDescription . |
text (qui apparaît à l'écran) | – |
textRegex | Expression régulière Java pour faire correspondre le text . |
groupViewChildPosition , recyclerViewChildPosition ou adapterViewChildPosition | Représente la position enfant d'un widget d'interface utilisateur en fonction du type de son widget parent. |
Souvent, ces attributs ne sont pas définis, par exemple, un bouton peut ne pas avoir de texte et de description de contenu. Même si certaines valeurs d'attribut sont présentes, elles peuvent ne pas être uniques sur un écran d'application donné (y compris resourceId
).
Par exemple, la différenciation entre les éléments d'une liste n'est généralement possible qu'en utilisant leurs différentes positions enfant dans leur widget parent. Cela signifie que l'utilisation d'un seul descripteur d'élément pour identifier un widget d'interface utilisateur est généralement insuffisante. Par conséquent, l'attribut elementDescriptors
d'une action contient une séquence de descripteurs d'éléments qui sont ordonnés de sorte que le premier corresponde au widget d'interface utilisateur cible, le second corresponde au widget parent du widget d'interface utilisateur cible, et ainsi de suite. Le widget d'interface utilisateur cible d'une action est mis en correspondance lorsque tous ses descripteurs d'élément correspondent à la sous-hiérarchie de widget d'interface utilisateur correspondante.
Voici un exemple de script Robo avec un changement de texte et des actions de clic, qui nécessitent tous deux que vous identifiiez le widget d'interface utilisateur cible à l'aide des descripteurs d'élément fournis :
[
{
"eventType": "VIEW_TEXT_CHANGED",
"replacementText": "John",
"elementDescriptors": [
{
"className": "android.support.v7.widget.AppCompatEditText",
"groupViewChildPosition": 0,
"resourceId": "com.google.samples.apps.topeka:id/first_name"
},
{
"className": "android.widget.FrameLayout",
"groupViewChildPosition": 0
},
{
"className": "android.support.design.widget.TextInputLayout",
"groupViewChildPosition": 1
}
]
},
{
"eventType": "VIEW_CLICKED",
"elementDescriptors": [
{
"className": "android.support.design.widget.FloatingActionButton",
"groupViewChildPosition": 1,
"resourceId": "com.google.samples.apps.topeka:id/done"
},
{
"className": "android.widget.FrameLayout",
"groupViewChildPosition": 1,
"resourceId": "com.google.samples.apps.topeka:id/content"
},
{
"className": "android.widget.FrameLayout",
"groupViewChildPosition": 0,
"resourceId": "com.google.samples.apps.topeka:id/sign_in_content"
}
]
}
]
Possibilités d'exécution
Vous pouvez éventuellement préfixer la liste des actions dans un script Robo avec un objet JSON qui spécifie les options d'exécution pour ce script Robo. Cet en-tête de configuration commence par le mot-clé roboscript
suivi d'une représentation JSON des options d'exécution souhaitées.
Les scripts Robo prennent en charge les options d'exécution suivantes :
-
executionMode
- options d'exécution appliquées lorsqu'un script Robo est en cours d'exécution :-
strict
- si défini surtrue
, le script Robo n'utilise pas de correspondance partielle, ignore l'action en cours et suspend . Autrement dit, le script Robo est exécuté comme un test d'instrumentation normal et échoue dès que l'une de ses actions ne peut pas être effectuée.
-
-
postscript
- options d'exécution appliquées après la fin d'un script Robo :-
terminate
- si défini surtrue
, le test Robo arrête l'exploration une fois le script Robo terminé.
-
Voici un exemple de script Robo exécuté en mode strict
qui dort pendant trois secondes, après quoi l'exploration s'arrête :
"roboscript": {
"executionMode": {
"strict": true
},
"postscript": {
"terminate": true
}
}
[
{
"eventType": "DELAYED_MESSAGE_POSTED",
"delayTime": 3000
}
]
Paramètres du modèle
Un paramètre de modèle est un espace réservé dans un script Robo qui est remplacé par la valeur réelle lorsque le test Robo charge ce script Robo pour exécution. Les paramètres de modèle sont précédés d'un double trait de soulignement suivi d'un signe de pourcentage et sont postfixés d'un signe de pourcentage suivi d'un double trait de soulignement.
Les scripts Robo prennent en charge le paramètre de modèle suivant :
-
__%APP_PACKAGE_NAME%__
- le nom du package de l'application en cours de test.
Voici un exemple de script Robo qui arrête le processus d'application en cours de test :
[
{
"eventType": "ADB_SHELL_COMMAND",
"command": "am force-stop __%APP_PACKAGE_NAME%__"
}
]
commentaires
Un script Robo peut contenir des lignes de commentaires, qui sont des lignes commençant par #
ou //
.
Voici un exemple de script Robo avec quelques commentaires :
# Confirm a user account.
[
{
// Click the DONE button.
"eventType": "VIEW_CLICKED",
"elementDescriptors": [
{
"resourceId": "com.google.samples.apps.topeka:id/done"
}
]
}
]
Capacités
Par défaut, jusqu'à ce que toutes les actions d'un script Robo soient terminées (ou au moins tentées), le script Robo reste actif. Le test Robo continue d'essayer de faire correspondre une action de script Robo chaque fois qu'il sélectionne une action à effectuer. Le script Robo utilise les techniques suivantes pour augmenter la robustesse :
Technique | La description |
Appariement partiel | Si l'action de script Robo actuelle ne peut pas être entièrement mise en correspondance, les critères de correspondance sont assouplis et la mise en correspondance est réessayée. La correspondance partielle ne prend pas en compte le descripteur d'élément le plus externe lors de la correspondance avec le widget d'interface utilisateur cible d'une action de script Robo. Si la correspondance partielle réussit, l'action de script Robo correspondante est exécutée comme d'habitude. Cette technique prend en charge les scénarios dans lesquels la structure de l'application change, par exemple, entre les versions de l'application, lorsque les éléments de l'écran sont réorganisés. |
Ignorer l'action en cours | Si l'action de script Robo actuelle ne peut pas correspondre entièrement ou partiellement, Robo essaie de faire correspondre l'action de script Robo suivante. Si l'action suivante correspond entièrement ou partiellement, le test Robo ignore (et ne revient jamais) l'action de script Robo actuelle et exécute la suivante. Cette technique prend en charge les scénarios lorsque le comportement de l'application change entre les versions ou est instable, par exemple, lorsqu'une boîte de dialogue intermittente peut apparaître sur différents écrans lors de l'enregistrement par rapport à la relecture d'un script Robo. |
Suspendre | Si aucune des actions de script Robo actuelles ou ultérieures ne peut correspondre entièrement ou partiellement, le script Robo est temporairement suspendu et le test Robo sélectionne une action à effectuer à l'aide de ses autres stratégies. Une fois cette action terminée, le test Robo reprend l'exécution du script Robo. Tant que les actions de script Robo actuelles ou ultérieures ne peuvent pas être mises en correspondance, le script Robo reste suspendu pour n'importe quel nombre d'actions. Ainsi, les scripts Robo n'ont pas nécessairement besoin d'être un prologue pour un test Robo, et vous pouvez intercaler des actions de script Robo avec des actions de test Robo standard. Cette technique prend en charge les scénarios lorsque le comportement de l'application est instable ou lorsque les changements entre les versions de l'application sont suffisamment importants pour que le test Robo doive « combler les lacunes » avec ses actions standard. |
Prise en charge de RecyclerView et AdapterView
Les enfants des widgets RecyclerView et AdapterView sont chargés dynamiquement et peuvent être affichés à plusieurs balayages de l'écran actuel. Étant donné que la taille d'un écran et le nombre de balayages nécessaires pour atteindre cet enfant sont différents pour différents facteurs de forme d'appareil, il est beaucoup plus robuste de s'appuyer sur la position des données de l'enfant, qui est absolue. C'est une approche moins robuste de compter sur le nombre de balayages nécessaires pour amener cet enfant à l'écran, puis d'utiliser sa position à l'écran.
Par conséquent, le script Robo capture les positions de données absolues des enfants RecyclerView qui sont les cibles des actions de script Robo en tant que recyclerViewChildPosition
. Le script Robo capture également les positions de données absolues des enfants AdapterView qui sont les cibles des actions de script Robo en tant que adapterViewChildPosition
.
Les actions sur les enfants RecyclerView et AdapterView sont effectuées selon les étapes suivantes :
Le test Robo garantit que l'enfant correspondant est affiché à l'écran grâce à une action de positionnement sur son RecyclerView ou AdapterView contenant.
Robo test effectue l'action enregistrée directement sur l'élément enfant, puisqu'il est déjà affiché à l'écran.
Voici un exemple d'action de clic sur un enfant AdapterView ( android.widget.GridView
):
{
"eventType": "VIEW_CLICKED",
"elementDescriptors": [
{
"className": "com.google.samples.apps.topeka.widget.AvatarView",
"adapterViewChildPosition": 5,
"resourceId": "com.google.samples.apps.topeka:id/avatar",
"contentDescription": "Avatar 6"
},
{
"className": "android.widget.GridView",
"groupViewChildPosition": 1,
"resourceId": "com.google.samples.apps.topeka:id/avatars"
},
{
"className": "android.widget.LinearLayout",
"groupViewChildPosition": 1
},
{
"className": "android.widget.LinearLayout",
"groupViewChildPosition": 0
}
]
}
Voici un exemple d'action de clic sur un enfant RecyclerView ( android.support.v7.widget.RecyclerView
):
{
"eventType": "VIEW_CLICKED",
"elementDescriptors": [
{
"className": "android.support.v7.widget.AppCompatTextView",
"groupViewChildPosition": 1,
"resourceId": "com.google.samples.apps.topeka:id/category_title"
},
{
"className": "android.widget.FrameLayout",
"recyclerViewChildPosition": 8,
"resourceId": "com.google.samples.apps.topeka:id/category_item"
},
{
"className": "android.support.v7.widget.RecyclerView",
"groupViewChildPosition": 1,
"resourceId": "com.google.samples.apps.topeka:id/categories"
},
{
"className": "android.widget.FrameLayout",
"groupViewChildPosition": 1,
"resourceId": "com.google.samples.apps.topeka:id/category_container"
},
{
"className": "android.widget.LinearLayout",
"groupViewChildPosition": 0
}
]
}
Enregistrez un script Robo dans Android Studio et exécutez-le dans Test Lab
Vous pouvez créer un script Robo dans Android Studio, qui enregistre le script sous forme de fichier JSON. Vous pouvez ensuite télécharger le fichier JSON dans Firebase Test Lab avec l'application et exécuter le test en conséquence.
Lorsque vous exécutez un test Robo avec un script joint, le test Robo parcourt d'abord vos actions pré-scriptées, puis explore l'application comme d'habitude.
Pour créer un fichier JSON de script Robo dans Android Studio, suivez les étapes décrites dans Enregistrer un script Robo à l'aide de Test Lab dans Android Studio .
Actions de script robotique
L'attribut facultatif commun suivant s'applique à toutes les actions :
-
description
- permet de suivre l'exécution de cette action de script Robo dans les sorties de test Robo.
Affirmation
Si la condition affirmée est vraie, le script Robo passe à l'action suivante, qui peut être une autre assertion. Sinon, l'exécution du script Robo est interrompue en raison d'un échec d'assertion et le résultat du test est FAILED.
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "ASSERTION" | -- |
contextDescriptor | Décrit le contexte ou la condition affirmée. |
Descripteur de contexte
Un descripteur de contexte définit le contexte/la condition à l'aide d'un ou d'une combinaison des attributs suivants :
Attribut | La description |
---|---|
"condition": "element_present" | Vérifie qu'un widget d'interface utilisateur qui correspond à elementDescriptors ou au texte spécifié par visionText est présent à l'écran. |
"condition": "app_under_test_shown" | Vérifie que l'application en cours de test s'exécute au premier plan. |
"condition": "default_launcher_shown" | Vérifie que l'écran d'accueil d'un appareil s'affiche, ce qui signifie qu'aucune application n'est en cours d'exécution au premier plan. |
"condition": "non_roboscript_action_performed" | Vérifie que la dernière action effectuée par le test Robo n'est pas une action de script Robo. |
negateCondition | Si défini sur true , annule la condition . Par exemple, vous pouvez utiliser cet attribut pour vérifier si un widget d'interface utilisateur n'est PAS présent à l'écran ou si l'application en cours de test ne s'exécute PAS au premier plan. |
elementDescriptors | Un ou plusieurs descripteurs d'élément qui identifient un widget d'interface utilisateur à l'écran. Il est utilisé en combinaison avec la condition element_present . Mutuellement exclusif avec visionText . Pour plus d'informations, voir Descripteurs d'éléments . |
visionText | Le texte à l'écran est détecté à l'aide de l'API de reconnaissance optique de caractères (OCR). visionText est utilisé en combinaison avec la condition element_present . Mutuellement exclusif avec elementDescriptors . |
Voici un exemple d'assertion de script Robo qui vérifie que l'application sous test est au premier plan :
{
"eventType": "ASSERTION",
"contextDescriptor": {
"condition": "app_under_test_shown"
}
}
Voici un exemple d'assertion de script Robo qui vérifie qu'un widget d'interface utilisateur avec l'ID de ressource "com.google.samples.apps.topeka:id/done"
est présent sur un écran :
{
"eventType": "ASSERTION",
"contextDescriptor": {
"condition": "element_present",
"elementDescriptors": [
{
"resourceId": "com.google.samples.apps.topeka:id/done"
}
]
}
}
Voici un exemple d'assertion de script Robo qui vérifie que "Settings"
n'est PAS détecté sur un écran utilisant l'OCR :
{
"eventType": "ASSERTION",
"contextDescriptor": {
"condition": "element_present",
"negateCondition": true,
"elementDescriptors": [
{
"visionText": "Settings"
}
]
}
}
Cliquez sur
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
---|---|
eventType | Spécifie le type d'action de script Robo. |
"eventType": "VIEW_CLICKED" | Clique sur l'élément cible de l'application en cours de test. |
"eventType": "SOFT_KEYBOARD_CLICK" | Clique sur l'élément cible du clavier logiciel. |
"eventType": "SOFT_KEYBOARD_RANDOM_CLICK" | Clique sur des éléments aléatoires du clavier logiciel jusqu'à maxNumberOfRuns fois. |
"eventType": "LIST_ITEM_CLICKED" | Utilisé par l'enregistreur de script Robo dans Android Studio pour cliquer sur les éléments de la liste. |
elementDescriptors | Identifie le widget d'interface utilisateur cliqué à l'aide de la hiérarchie de l'interface utilisateur Android. Mutuellement exclusif avec visionText . |
visionText | Identifie l'élément cliqué à l'aide de l'OCR. Mutuellement exclusif avec elementDescriptors . |
maxNumberOfRuns | Spécifie combien de fois cliquer sur un élément aléatoire du clavier logiciel, lorsque eventType est SOFT_KEYBOARD_RANDOM_CLICK . La valeur par défaut est 1 . |
Voici un exemple d'action de script Robo qui clique sur un bouton avec l'ID de ressource "com.google.samples.apps.topeka:id/done"
:
{
"eventType": "VIEW_CLICKED",
"elementDescriptors": [
{
"resourceId": "com.google.samples.apps.topeka:id/done"
}
]
}
Voici un exemple d'action de script Robo qui clique sur "Privacy Policy"
détectée sur un écran utilisant l'OCR :
{
"eventType": "VIEW_CLICKED",
"elementDescriptors": [
{
"visionText": "Privacy Policy"
}
]
}
Voici un exemple d'action de script Robo qui clique sur un élément de clavier logiciel avec une description de contenu "Emoji button"
:
{
"eventType": "SOFT_KEYBOARD_CLICK",
"elementDescriptors": [
{
"contentDescription": "Emoji button"
}
]
}
Voici un exemple d'action de script Robo qui clique jusqu'à cinq fois sur des éléments aléatoires du clavier virtuel :
{
"eventType": "SOFT_KEYBOARD_RANDOM_CLICK",
"maxNumberOfRuns": 5
}
Désactiver le clavier logiciel
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "DISABLE_KEYBOARD" | -- |
Voici un exemple d'action de script Robo qui désactive le clavier logiciel :
{
"eventType": "DISABLE_KEYBOARD"
}
Exécuter la commande shell adb
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "ADB_SHELL_COMMAND" | -- |
command | La commande shell Android Debug Bridge (adb) à exécuter. |
Voici un exemple d'action de script Robo qui efface les données utilisateur de l'application en cours de test :
{
"eventType": "ADB_SHELL_COMMAND",
"command": "pm clear __%APP_PACKAGE_NAME%__"
}
Accorder des autorisations
Cette action est enregistrée par l'enregistreur de script Robo dans Android Studio pour une compatibilité descendante avec Espresso Test Recorder . Le test Robo accorde toutes les autorisations à l'application sous test au début de chaque analyse, et par conséquent, cette action est une non-opération. N'utilisez PAS cette action dans vos scripts Robo.
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "PERMISSIONS_REQUEST" | -- |
Texte de saisie
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
---|---|
eventType | Spécifie le type d'action de script Robo. |
"eventType": "VIEW_TEXT_CHANGED" | Entre le texte donné dans le widget d'interface utilisateur cible. |
"eventType": "ENTER_TEXT" | entre le texte donné dans le widget d'interface utilisateur cible, puis envoie un événement KEYCODE_ENTER à ce widget d'interface utilisateur. |
elementDescriptors | Identifie le widget d'interface utilisateur cible à l'aide de la hiérarchie de l'interface utilisateur Android. |
replacementText | Le texte à saisir dans le widget d'interface utilisateur cible. |
Voici un exemple d'action de script Robo qui saisit "John"
dans un widget d'interface utilisateur avec l'ID de ressource "com.google.samples.apps.topeka:id/first_name"
:
{
"eventType": "VIEW_TEXT_CHANGED",
"replacementText": "John",
"elementDescriptors": [
{
"resourceId": "com.google.samples.apps.topeka:id/first_name"
}
]
}
Clic long
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "VIEW_LONG_CLICKED" | -- |
elementDescriptors | Identifie le widget d'interface utilisateur cible à l'aide de la hiérarchie de l'interface utilisateur Android. |
L'attribut suivant est facultatif :
-
delayTime
- spécifie combien de temps la pression d'un long clic doit durer, en millisecondes.
Voici un exemple d'action de script Robo qui effectue un clic de cinq secondes sur un widget d'interface utilisateur avec la description de contenu "Avatar 8"
:
{
"eventType": "VIEW_LONG_CLICKED",
"elementDescriptors": [
{
"contentDescription": "Avatar 8"
}
],
"delayTime": 5000
}
Effectuer un geste en un point
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
---|---|
"eventType": "ONE_POINT_GESTURE" | -- |
coordinates | Deux coordonnées pour un geste à un point, au format "(x1,y1)->(x2,y2)" en pourcentages ou en pixels. |
Voici un exemple d'action gestuelle en un point de script Robo qui effectue un balayage vers le bas :
{
"eventType": "ONE_POINT_GESTURE",
"coordinates": "(50%,25%)->(50%,75%)"
}
Effectuer un geste en deux points
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
---|---|
"eventType": "TWO_POINT_GESTURE" | -- |
coordinates | Quatre coordonnées pour un geste à deux points, au format "(x1,y1)->(x2,y2),(x3,y3)->(x4,y4)" en pourcentages ou en pixels. |
Voici un exemple d'action de script Robo qui effectue un geste de pincement :
{
"eventType": "TWO_POINT_GESTURE",
"coordinates": "(50%,50%)->(25%,50%),(50%,50%)->(75%,50%)"
}
Effectuer une action IME
Cette action appuie sur le bouton d'action en cours, par exemple, suivant, terminé et rechercher, sur l'éditeur de méthode d'entrée (IME) pour le widget d'interface utilisateur cible spécifié.
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
---|---|
"eventType": "PRESSED_EDITOR_ACTION" | -- |
elementDescriptors | Identifie le widget d'interface utilisateur cible à l'aide de la hiérarchie de l'interface utilisateur Android. |
Voici un exemple d'action de script Robo qui exécute une action IME sur un widget d'interface utilisateur avec l'ID de ressource "com.google.samples.apps.topeka:id/first_name"
:
{
"eventType": "PRESSED_EDITOR_ACTION",
"elementDescriptors": [
{
"resourceId": "com.google.samples.apps.topeka:id/first_name"
}
]
}
Refouler
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
eventType | Spécifie le type d'action de script Robo. |
"eventType": "PRESSED_BACK" | Envoie un événement KEYCODE_BACK à l'appareil. |
"eventType": "PRESSED_BACK_EMULATOR_28" | Utilisé par l'enregistreur de script Robo dans Android Studio pour appuyer sur les émulateurs API 28. |
Voici un exemple d'action de script Robo qui appuie en arrière :
{
"eventType": "PRESSED_BACK"
}
Appuyez sur accueil
Cette action envoie un événement KEYCODE_HOME
à l'appareil.
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "GO_HOME" | -- |
Voici un exemple d'action de script Robo qui appuie sur home :
{
"eventType": "GO_HOME"
}
Faire défiler un élément dans la vue
Cette action permet à Robo de faire défiler vers l'avant le widget d'interface utilisateur qui correspond aux elementDescriptors
spécifiés jusqu'à ce que le widget d'interface utilisateur correspondant aux childElementDescriptors
spécifiés soit présent à l'écran, ou que le widget défilé ne puisse plus défiler, ou que le nombre maximum de 50 défilements soit atteint.
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "ELEMENT_SCROLL_INTO_VIEW" | -- |
elementDescriptors | Identifie le widget d'interface utilisateur défilant à l'aide de la hiérarchie de l'interface utilisateur Android. |
childElementDescriptors | Identifie le widget de l'interface utilisateur à parcourir à l'aide de la hiérarchie de l'interface utilisateur Android. |
Voici un exemple d'action de script Robo qui fait défiler le widget UI avec l'ID de ressource "my.app.package:id/scrollable_card_container"
jusqu'à ce que le widget UI avec le texte "Orange"
soit présent à l'écran (ou plus aucun défilement ne peut être exécuté, ou le nombre maximum de 50 défilements est atteint) :
{
"eventType": "ELEMENT_SCROLL_INTO_VIEW",
"elementDescriptors": [
{
"resourceId": "my.app.package:id/scrollable_card_container"
}
],
"childElementDescriptors": [
{
"text": "Orange"
}
]
}
Glisser
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
---|---|
"eventType": "VIEW_SWIPED" | -- |
swipeDirection | Spécifie la direction du balayage :
|
elementDescriptors | Identifie le widget d'interface utilisateur cible à l'aide de la hiérarchie de l'interface utilisateur Android. |
Voici un exemple d'action de script Robo qui balaye un widget d'interface utilisateur avec l'ID de ressource "my.app.package:id/custom_content"
:
{
"eventType": "VIEW_SWIPED",
"swipeDirection": "Up",
"elementDescriptors": [
{
"resourceId": "my.app.package:id/custom_content"
}
]
}
Prendre une capture d'écran
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "TAKE_SCREENSHOT" | -- |
screenshotName | Spécifie le nom du fichier de capture d'écran. |
Voici un exemple d'action de script Robo qui prend une capture d'écran :
{
"eventType": "TAKE_SCREENSHOT",
"screenshotName": "my_screenshot"
}
Appuyez sur un point de l'écran
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
---|---|
"eventType": "POINT_TAP" | -- |
pointTapXCoordinate | La coordonnée pixel X du point tapé. Mutuellement exclusif avec pointTapXPercent et pointTapYPercent . |
pointTapYCoordinate | Coordonnée pixel Y du point tapé. Mutuellement exclusif avec pointTapXPercent et pointTapYPercent . |
pointTapXPercent | La coordonnée X en pourcentage du point taraudé. Mutuellement exclusif avec pointTapXCoordinate et pointTapYCoordinate . |
pointTapYPercent | La coordonnée Y en pourcentage du point taraudé. Mutuellement exclusif avec pointTapXCoordinate et pointTapYCoordinate . |
Voici un exemple d'action de script Robo qui touche au milieu d'un écran :
{
"eventType": "POINT_TAP",
"pointTapXPercent": 50,
"pointTapYPercent": 50
}
Appuyez sur un point dans un élément
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "POINT_TAP_ELEMENT" | -- |
pointTapXPercent | La coordonnée X en pourcentage dans l'élément cible. |
pointTapYPercent | La coordonnée Y en pourcentage dans l'élément cible. |
elementDescriptors | Identifie le widget d'interface utilisateur cible à l'aide de la hiérarchie d'interface utilisateur Android. |
Voici un exemple d'action de script Robo qui déplace le curseur d'une barre de recherche vers la droite :
{
"eventType": "POINT_TAP_ELEMENT",
"pointTapXPercent": 80,
"pointTapYPercent": 50,
"elementDescriptors": [
{
"resourceId": "my.app.package:id/my_seekbar"
}
]
}
Terminer l'exploration
Cette action arrête le test Robo.
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
---|---|
"eventType": "TERMINATE_CRAWL" | -- |
Voici un exemple d'action de script Robo qui arrête un test Robo :
{
"eventType": "TERMINATE_CRAWL"
}
Attendre
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "DELAYED_MESSAGE_POSTED" | -- |
delayTime | Spécifie le temps d'attente, en millisecondes. |
Voici un exemple d'action de script Robo qui attend trois secondes :
{
"eventType": "DELAYED_MESSAGE_POSTED",
"delayTime": 3000
}
Attendre un élément
Cette action oblige le test Robo à attendre qu'un élément apparaisse à l'écran jusqu'au délai spécifié.
Le tableau suivant répertorie les attributs requis :
Attribut | La description |
"eventType": "WAIT_FOR_ELEMENT" | -- |
delayTime | Spécifie le délai d'attente, en millisecondes. |
elementDescriptors | Identifie le widget d'interface utilisateur attendu à l'aide de la hiérarchie de l'interface utilisateur Android. |
Voici un exemple d'action de script Robo qui attend jusqu'à 30 secondes qu'un widget d'interface utilisateur avec l'ID de ressource "my.app.package:id/confirmation_button"
apparaisse à l'écran :
{
"eventType": "WAIT_FOR_ELEMENT",
"delayTime": 30000,
"elementDescriptors": [
{
"resourceId": "my.app.package:id/confirmation_button"
}
]
}