Parcours pour Android Studio

Journeys pour Android Studio vous permet de décrire des parcours utilisateur de bout en bout en langage naturel et de les exécuter directement avec l'agent IA sur un appareil connecté ou un émulateur. Votre ensemble d'instructions, appelé "parcours", est converti en actions que l'agent effectue sur votre application. Vous pouvez également écrire et décrire des assertions plus complexes, que l'agent évalue en fonction de ce qu'il voit sur l'appareil.

Un parcours terminé dans Android Studio, avec le parcours ouvert dans l'éditeur, l'application sur un émulateur et les résultats de l'agent dans la fenêtre de l'agent.
Parcours pour Android Studio

Comme l'agent détermine les actions à effectuer pour atteindre les objectifs, les parcours sont plus résilients aux modifications subtiles de la mise en page ou du comportement de votre application. Cela se traduit par moins de tests irréguliers lors de l'exécution sur différentes versions de votre application et différentes configurations d'appareils.

Vous pouvez écrire et exécuter des parcours directement depuis Android Studio ou depuis la ligne de commande à l'aide de n'importe quel agent. Lorsque vous exécutez un parcours, l'agent parcourt le flux, vérifie les résultats attendus et génère un rapport avec des captures d'écran indiquant si chaque étape a réussi ou échoué.

Écrire un parcours

Les parcours sont écrits en XML pour organiser leur description et leurs étapes. Les fichiers de parcours utilisent l'extension .journey.xml et sont stockés dans le répertoire src/journeysTest/ du module de votre application. Android Studio fournit un éditeur visuel qui facilite la création et la modification des parcours. Vous n'avez pas besoin de modifier vos fichiers de compilation pour utiliser les parcours.

Pour créer un parcours, effectuez l'une des opérations suivantes :

  • Dans le panneau Project (Projet) d'Android Studio, effectuez un clic droit sur le module d'application pour lequel vous souhaitez écrire un parcours, puis sélectionnez New > Journey File (Nouveau > Fichier de parcours). Vous pouvez également sélectionner File > New > Journey File (Fichier > Nouveau > Fichier de parcours) dans le menu principal.
  • Dans la fenêtre Agent, demandez à l'agent de créer un parcours pour un flux utilisateur dans votre application. Par exemple, "Créer un parcours qui recherche un produit, l'ajoute au panier et vérifie que le panier contient un article".

Pour modifier un parcours, ouvrez le fichier correspondant. Vous pouvez utiliser la vue Code pour modifier directement le code XML, la vue Design pour une expérience de modification simplifiée ou la vue Split (Diviser) pour afficher les deux. Vous pouvez également demander à l'agent de mettre à jour un fichier de parcours existant.

Dans la vue Conception, chaque ligne correspond à une étape de votre parcours. Saisissez une action que vous souhaitez que l'agent effectue ou une assertion que vous souhaitez que l'agent vérifie, puis appuyez sur Entrée pour ajouter l'étape suivante.

Éditeur de parcours dans Android Studio, affichant le titre, la description et les étapes d'un parcours.
Éditeur de parcours dans Android Studio.

Conseils pour rédiger des parcours

Bien que l'agent soit capable de comprendre la plupart des étapes écrites dans les langues acceptées, suivre ces conseils pour rédiger des parcours peut vous aider à obtenir des résultats plus précis et attendus :

  • Partez du principe que votre application est déjà au premier plan : l'exécution d'un parcours lance automatiquement votre application. Les étapes de votre parcours doivent commencer après le lancement complet de l'application. Autrement dit, vous n'avez pas besoin d'inclure l'étape "lancer l'application".
  • Utilisez un langage sans ambiguïté : la précision réduit les risques d'interprétation erronée et améliore la fiabilité.
au lieu de À faire
"Sélectionner le bouton de fermeture" "Appuie sur 'Ignorer'" ou simplement "Ignorer"
"Saisissez 'céleri'" "Saisissez 'céleri' dans la barre de recherche en haut de l'écran d'accueil"
"Balayer pour ignorer" "Balayez l'écran vers la gauche pour fermer la carte. Elle ne devrait plus être visible."
  • Incluez les critères de réussite dans l'étape : cela aide l'agent à mieux comprendre votre intention et clarifie le moment où l'action est terminée et où l'action suivante peut commencer.
au lieu de À faire
"Sélectionne le bouton d'envoi" "Envoyez l'e-mail en appuyant sur le bouton d'envoi. L'e-mail devrait alors se fermer et vous devriez revenir à la boîte de réception."
"Accéder au panier" "Appuyez sur l'icône du panier pour accéder à la page du panier. Vérifiez qu'il ne contient aucun élément"
"Clique sur la première vidéo" "Cliquez sur la première vidéo et attendez qu'elle se charge complètement."
  • Affiner votre parcours : si votre parcours ne s'exécute pas comme prévu, consultez les résultats pour comprendre pourquoi l'agent n'a peut-être pas exécuté les étapes comme prévu. Utilisez ces informations pour clarifier vos instructions.
  • Décomposez votre parcours en étapes plus spécifiques : bien que l'agent puisse interpréter les étapes multi-actions, des étapes discrètes plus précises peuvent parfois améliorer la précision et la reproductibilité du parcours.

Fonctionnalités compatibles et limites

Voici un aperçu des fonctionnalités compatibles lors de l'écriture de parcours, ainsi que des fonctionnalités qui ne sont pas compatibles ou qui peuvent présenter des incohérences. Les listes suivantes ne sont pas exhaustives.

Les actions suivantes sont acceptées dans les parcours :

  • Appuyez sur des éléments d'interface utilisateur.
  • Appuyez de manière prolongée sur les éléments d'interface utilisateur.
  • Saisir pour saisir du texte dans les champs de texte.
  • Balayez l'écran ou faites-le défiler dans une certaine direction pour naviguer dans l'interface utilisateur.

Les fonctionnalités suivantes ne sont pas prises en charge pour le moment :

  • Gestes à plusieurs doigts (par exemple, pincer pour zoomer) : interactions nécessitant deux points de contact ou plus sur l'écran simultanément, comme pincer pour zoomer ou dézoomer, ou balayer l'écran avec deux doigts.

Les fonctionnalités suivantes peuvent ne pas fonctionner de manière cohérente :

  • Comptage : suivi précis des quantités, des fréquences ou de la progression.

Les fonctionnalités et les capacités s'améliorent constamment. Nous vous suggérons de consulter cette page ultérieurement pour en savoir plus sur les fonctionnalités supplémentaires. Pour nous aider à améliorer les parcours, envoyez-nous vos commentaires.

Exécuter votre parcours

Vous exécutez des parcours avec l'agent IA dans la fenêtre Agent. Lorsque vous exécutez un parcours, l'agent compile et déploie votre application sur un appareil, effectue chaque étape de votre parcours et indique si le parcours a réussi ou échoué.

Un parcours ouvert dans l'éditeur pendant que l'agent l'exécute dans la fenêtre de l'agent, avec l'application s'exécutant sur un émulateur.
Un parcours en cours d'exécution dans la fenêtre de l'agent.

Pour exécuter un parcours, effectuez l'une des opérations suivantes :

  • Ouvrez le fichier du parcours et cliquez sur Exécuter  dans la barre d'outils de l'éditeur.
  • Dans la vue Code ou Split (Fractionner), cliquez sur Run (Exécuter)  dans la gouttière à côté de la balise <journey>.
  • Dans le panneau Project (Projet), effectuez un clic droit sur un fichier de parcours, puis sélectionnez Run Journey with Agent (Exécuter le parcours avec l'agent). Pour exécuter plusieurs parcours, sélectionnez plusieurs fichiers de parcours ou un dossier contenant des fichiers de parcours, puis sélectionnez Exécuter les parcours avec l'agent.
  • Dans la fenêtre Agent, demandez à l'agent d'exécuter un parcours.

Android Studio démarre une nouvelle conversation dans la fenêtre Agent en utilisant le dernier agent que vous avez sélectionné, y compris les autres agents que vous avez connectés dans Settings > Tools > AI > Agents (Paramètres > Outils > IA > Agents).

L'agent exécute le parcours sur l'appareil sélectionné dans la barre d'outils principale. Si aucun appareil n'est en cours d'exécution, l'agent peut lancer un émulateur pour vous. Si vous exécutez plusieurs parcours ou sélectionnez plusieurs appareils, l'agent affiche un résumé des résultats une fois les exécutions terminées.

Exécuter un parcours depuis la ligne de commande

Pour exécuter des parcours depuis la ligne de commande avec n'importe quel agent, utilisez la CLI Android.

Afficher les résultats

Lorsque l'agent termine un parcours, il indique si le parcours a réussi ou échoué, y compris les étapes ayant échoué, dans la fenêtre Agent. Il fournit également un lien vers un rapport sur le parcours. Le rapport inclut les éléments suivants :

  • Résultat global du parcours.
  • Indique si chaque étape a réussi ou échoué.
  • Commandes exécutées par l'agent sur l'appareil.
  • Commentaires de l'agent sur chaque étape.
  • Liens vers les captures d'écran effectuées par l'agent.
Un rapport de parcours affichant le résultat, les commandes, la capture d'écran et le commentaire pour chaque étape, à côté du résumé de l'agent dans la fenêtre &quot;Agent&quot;.
Rapport de parcours, avec le résumé de l'agent dans la fenêtre "Agent".

Exécuter des parcours en tant que suites de tests AGP

Dans Android Studio Rabbit 2 et versions antérieures, Journeys est disponible en tant que fonctionnalité Studio Labs qui exécute les parcours en tant que suites de tests du plug-in Android Gradle (AGP). Pour l'utiliser, procédez comme suit :

  1. Accédez à Studio Labs dans le menu des paramètres, puis activez "Parcours".
  2. Assurez-vous que votre projet utilise AGP 9.0.0 ou une version ultérieure.
  3. Dans le panneau Project (Projet), effectuez un clic droit sur le module de votre application, puis sélectionnez New > Journey Test (Nouveau > Test de parcours). Si c'est la première fois que vous ajoutez des parcours à votre projet, Android Studio ajoute également la compatibilité avec la suite de tests AGP à votre projet.
  4. Ouvrez le fichier de parcours et, dans la vue Design (Conception), cliquez sur Run Journey (Exécuter le parcours). Android Studio crée une configuration d'exécution Journeys Test, l'exécute sur l'appareil sélectionné et affiche les résultats dans le panneau des résultats de test.

La suite de tests s'exécute sur la variante de compilation qui était active lorsque vous avez créé le parcours. Si vous passez à une autre variante de compilation, ajoutez-la à la propriété targetVariants dans le bloc testSuites de votre fichier build.gradle.kts au niveau du module.