Recorder d'application mobile

Enregistrez un test smartphone en pilotant un device réel aux côtés d'une liste d'étapes en direct.

L'enregistrement transforme une session manuelle sur un device réel en test. Vous pilotez le smartphone depuis votre navigateur, et chaque tap, input et scroll devient une étape modifiable, sans script requis. Le recorder fonctionne côte à côte avec le builder : le device est diffusé à droite tandis que vos étapes se construisent à gauche.

Le recorder smartphone en cours de session : le bandeau d'enregistrement avec son chrono, Pause et Stop record, le canvas d'étapes à gauche, et le device surmonté d'Assertion mode et Find an element

Enregistrer un test

Partez du tableau de bord Tests pour que l'enregistrement aboutisse dans un nouveau test.

1
Créer le test

Cliquez sur + Créer un nouveau test, choisissez Smartphone (Nouvelle expérience), donnez un nom au test, sélectionnez le device sur lequel enregistrer et choisissez l'application à tester. Cliquez sur Utiliser l'enregistreur.

2
Piloter le device

Le recorder s'ouvre avec le flux du device à droite et le canvas d'étapes à gauche, en commençant par un bloc Ouvrir l'application. Effectuez vos tap et swipe directement sur le flux : chaque interaction ajoute une étape numérotée (par exemple Toucher) sous un groupe d'étapes.

3
Générer le test

Cliquez sur Arrêter l'enregistrement lorsque vous avez terminé. Les étapes restent dans le canvas, prêtes à être exécutées avec Enregistrer et exécuter ou à être affinées au préalable.

Pendant l'enregistrement

Un bandeau traverse le haut du recorder et porte l'état de la session : le chrono, Pause et Arrêter l'enregistrement. La pause gèle l'enregistrement sans fermer la session : vous pouvez naviguer librement dans l'application (fermer une popup, revenir au bon écran) sans que ce détour devienne des étapes. Le device reste pilotable pendant la pause, il n'enregistre simplement plus. Reprendre reprend l'enregistrement.

Deux outils sont posés au-dessus du device, parce qu'ils agissent sur l'écran lui-même :

  • Mode assertion transforme votre prochain tap en vérification plutôt qu'en action : vous désignez ce qui doit être à l'écran et le recorder écrit une étape Vérifier l'élément. C'est le raccourci de la vérification que vous construiriez sinon via Trouver un élément, sans ouvrir la modale.
  • Trouver un élément ouvre une modale où vous désignez un élément sur une capture de l'écran et le transformez en étape. C'est la porte d'entrée pour un élément qu'on n'atteint pas au doigt, pour une vérification, ou quand vous voulez voir le sélecteur avant le geste. Voir Trouver un élément plus bas.

Remplir le champ ne demande aucune commande : tapez un champ sur le device et le recorder crée l'étape, avec un bandeau qui rappelle que vous pouvez saisir la valeur directement au clavier.

Find an element

La modale s'ouvre sur l'écran tel qu'il a été capturé, avec l'heure de la capture dans l'en-tête et un bouton Actualiser pour en prendre une nouvelle. Elle a trois colonnes : l'écran à gauche, l'arbre des éléments au milieu, et l'élément sélectionné à droite.

Désigner ce que vous visez

Survolez la capture : le plus petit élément sous le pointeur s'allume. Cliquez pour le sélectionner. L'arbre suit, les parents se déplient et la ligne défile, vous voyez donc toujours où l'élément se situe dans la hiérarchie. Le bouton en forme d'oeil contoure d'un coup tout ce qui est sélectionnable à l'écran, pratique quand vous ne savez pas ce que l'application expose.

Le champ Rechercher par libellé, texte ou id filtre l'arbre : un élément que vous savez nommer est plus rapide à atteindre qu'un élément qu'il faut aller chercher au scroll.

Lire les sélecteurs

La colonne de droite liste, sous Trouver l'élément par, les façons d'atteindre l'élément, de la plus robuste à la plus fragile. Chacune indique combien d'éléments elle matche, compté sur cet écran précis :

BadgeCe que ça veut dire
1 correspondanceLe sélecteur atteint votre élément et lui seul. Rien à arbitrer.
22 correspondancesPlusieurs éléments le partagent. Voir la section suivante.
1 correspondance, par positionIl atteint un seul élément, mais grâce à sa place dans l'arbre. Il casse si l'écran est réordonné.

Le plus robuste porte le badge recommandé et c'est celui qui est déjà rempli en pied de modale. Le panneau Attributs en dessous liste tout ce que la capture sait de l'élément, si vous voulez construire le vôtre.

La modale Find an element sur une calculatrice : la touche 9 est sélectionnée, resource-id est recommandé avec 1 match tandis que class name en atteint 24

Un sélecteur partagé est une question de portée

Un élément dont les frères portent les mêmes attributs, c'est normal : une liste de cartes, une rangée d'onglets. Plutôt que de refuser le sélecteur, la modale vous demande lequel vous visiez, avec Utiliser le 14e des 22 éléments qui le partagent, celui que vous avez choisi. Les matchs sont numérotés sur la capture pour que vous vérifiiez que c'est le bon, et changer de rang déplace la sélection : vous n'inspectez jamais une carte pendant que l'étape en tape une autre.

Le sélecteur en pied de modale affiche alors found by class name - 14th of 22.

Un ImageView partagé par 22 éléments : les matchs sont numérotés sur la capture et une liste déroulante choisit le 14e

Taper par coordonnées

Certains écrans n'offrent rien à sélectionner, typiquement une page web affichée dans l'application : l'arbre s'arrête au cadre et aucun des champs à l'intérieur n'est atteignable par un sélecteur.

Basculez la capture sur Coordonnées. Un viseur suit le pointeur et affiche les x et y, un clic pose le point, et Position X et Position Y restent modifiables. Le panneau écrit noir sur blanc ce que coûte un point : 65% from the left, 14% from the top of this 1080 x 2340 screen. On a screen of another size the tap lands somewhere else. Si un élément se trouve tout de même sous le point, la modale propose son sélecteur, parce qu'un sélecteur survit à un changement de mise en page, un point non.

Le mode Coords : un viseur sur la capture affiche 700, 339, à côté des champs X et Y et de la note sur la résolution de l'écran

Ajouter l'étape

Choisissez l'action en pied de modale : Toucher, Appui long, Remplir le champ, Vérifier l'élément ou Extraire une valeur. Ajoutez une valeur si l'action en attend une, puis Ajouter l'étape. En mode Coordonnées, seules Toucher et Appui long restent proposées, puisqu'il n'y a pas d'élément à vérifier ni dont lire une valeur.

Le sélecteur d'action en pied de modale, ouvert sur Tap, Long press, Fill input, Verify element et Extract value, à côté du bouton Add step

La modale remplit le locator de l'étape depuis laquelle elle a été ouverte, dans le bon mode : vous ne recopiez jamais un sélecteur à la main.

Ajuster les sélecteurs et ajouter des assertions

Chaque étape enregistrée affiche le sélecteur qu'elle cible (par exemple id=... ou content-desc=...) directement dans la ligne de l'étape. Lorsque le choix automatique est fragile, ouvrez le menu déroulant du sélecteur et choisissez une correspondance plus claire.

Le menu trois points d'une étape propose des options supplémentaires, dont Add assertion : une étape Vérifier l'élément qui vérifie que l'écran est correct, par exemple qu'une valeur est displayed. Les assertions deviennent des étapes dans le canvas aux côtés de vos taps, ce qui permet à un enregistrement de vérifier le comportement au fur et à mesure.

Pour les éléments fragiles, activez les sélecteurs IA par étape dans le builder afin que le test s'auto-corrige lorsque l'interface de l'application change. Consultez Sélecteurs IA.

Legacy : recorder en contrôle à distance

Le recorder d'origine se trouve dans l'onglet Contrôle à distance de la live session et génère un test JavaScript. Il fonctionne toujours, mais il est progressivement remplacé par le recorder côte à côte décrit ci-dessus. Préférez le nouveau flux pour les nouveaux tests.

1
Démarrer l'enregistrement

Dans Contrôle à distance, sélectionnez le smartphone, puis cliquez sur start a test record dans la barre d'outils Quick Assistant (aux côtés des contrôles Power, Volume, Home, Back et App switcher).

2
Sélectionner l'application

Choisissez l'application depuis la modale Choose your test package, qui liste les applications User et System.

3
Enregistrer et générer

Pilotez le device manuellement, puis arrêtez l'enregistrement. Celui-ci produit une configuration d'étapes basée sur un formulaire avec des champs comme Application package et Application activity, ainsi que des options comme Reset the app, Run in background et Ignorer les erreurs.

Le résultat est une smartphone script action : du JavaScript que vous pouvez modifier, enrichir d'assertions, ou compléter avec des variables et métriques personnalisées.

Et ensuite ?

Test builder

Modifiez, groupez et vérifiez les étapes que vous avez enregistrées

Live session

Pilotez un device réel de manière interactive sans enregistrer

Last updated on