Cette page a été traduite par l'API Cloud Translation.

Parcours pour Android Studio

La création de parcours pour Android Studio permet d'écrire et de gérer facilement des tests de bout en bout en vous permettant d'utiliser le langage naturel pour décrire les étapes et les assertions de chaque test, appelé parcours. En tirant parti des capacités de vision et de raisonnement de Gemini, les étapes rédigées en langage naturel sont converties en actions que Gemini exécute sur votre application. Vos parcours sont ainsi faciles à écrire et à comprendre. Vous pouvez également écrire et décrire des assertions plus complexes, que Gemini évalue en fonction de ce qu'il voit sur l'appareil afin de déterminer si vos parcours réussissent ou échouent.

Comme Gemini détermine les actions à effectuer pour atteindre les objectifs, les parcours sont plus résistants aux modifications subtiles de la mise en page ou du comportement de votre application. Cela permet de réduire le nombre de tests instables lors de l'exécution sur différentes versions de votre application et différentes configurations d'appareils.

Écrivez et exécutez des parcours directement depuis Android Studio sur n'importe quel appareil Android local ou distant. L'IDE offre une nouvelle expérience d'édition pour créer des parcours, ainsi que des résultats enrichis qui vous aident à mieux comprendre le raisonnement et l'exécution de votre parcours par Gemini.

Écrire un parcours

Android Studio fournit un modèle de fichier et une nouvelle expérience d'éditeur qui simplifient la création et la modification de parcours. Les parcours sont écrits à l'aide de la syntaxe XML (Extensible Markup Language) pour organiser la description et les étapes de votre parcours.

Éditeur de parcours dans Android Studio, affichant un fichier XML avec des étapes de parcours.

Pour créer et commencer à modifier un parcours :

Dans le panneau Project (Projet) d'Android Studio, effectuez un clic droit sur le module d'application pour lequel vous souhaitez écrire un parcours.
Sélectionnez Nouveau > Test > Fichier de parcours.
Dans la boîte de dialogue qui s'affiche, indiquez le nom et la description de votre parcours.
Cliquez sur OK. Android Studio crée un fichier XML pour votre parcours avec le nom que vous avez choisi. Vous pouvez utiliser la vue Code pour modifier directement le code XML ou la vue Conception pour une expérience de modification améliorée.
Lorsque vous affichez votre parcours dans la vue Conception, utilisez le champ de texte pour décrire chaque étape de votre parcours. Chaque étape peut inclure des actions descriptives que vous souhaitez que Gemini effectue ou des assertions que vous souhaitez que Gemini évalue.
Appuyez sur la touche Entrée de votre clavier pour saisir une nouvelle requête dans le même parcours. Vous pouvez répéter cette opération autant de fois que nécessaire pour chaque étape du parcours que vous souhaitez définir.

Conseils pour rédiger des parcours

Rédiger vos parcours de manière détaillée et organisée peut augmenter la probabilité que Gemini exécute précisément les parcours souhaités de manière plus déterministe. Voici quelques conseils pour vous aider à rédiger vos parcours plus efficacement :

Séparez les assertions des actions : Gemini évalue en permanence l'état de votre application pour déterminer si elle se trouve dans un état "correct" pour poursuivre le parcours. Toutefois, vous devrez peut-être définir des assertions plus complexes dans une étape distincte. De plus, commencez chaque requête par des expressions clés telles que "Vérifie que", "Affirme que" ou "Contrôle que" pour indiquer à Gemini que cette étape est une affirmation.
Diriger Gemini par balayage : en plus des interactions de base, comme les commandes tactiles ou les saisies au clavier, Gemini prend en charge les actions qui nécessitent de balayer l'écran dans certaines directions. Par exemple, pour faire défiler du contenu ou fermer une partie de l'UI, décrivez la direction et l'intention de votre geste de balayage. Par défaut, Gemini balaye l'écran depuis le centre, mais vous pouvez spécifier qu'il doit balayer une autre partie de l'écran de l'appareil.
Évitez les interactions et les modifications de configuration complexes : Gemini n'est pas compatible avec toutes les interactions et modifications de configuration, comme les gestes à plusieurs doigts, les rotations d'écran ou les actions de pliage. L'équipe travaille à l'amélioration des capacités de Gemini.

Exécuter votre parcours

Vous pouvez exécuter votre parcours sur n'importe quel appareil local ou distant disponible, comme n'importe quel autre test instrumenté. Android Studio génère des résultats détaillés qui vous aident à comprendre l'exécution de votre parcours.

Android Studio exécutant un parcours, avec le sélecteur d'appareil et une icône d'exécution mis en évidence dans l'éditeur.

Pour tester un parcours, procédez comme suit :

Sélectionnez un appareil cible dans la barre d'outils principale, comme vous le feriez pour exécuter un test instrumenté.
Accédez au fichier XML du parcours que vous souhaitez tester et ouvrez-le dans l'éditeur.
Dans l'éditeur, effectuez l'une des opérations suivantes :
1. Si vous êtes dans la vue Conception, cliquez sur Exécuter le parcours.
2. Si vous êtes dans la vue Code, cliquez sur Exécuter test dans la marge, à côté de l'endroit où le nom du parcours est défini dans le fichier XML.

Android Studio crée une configuration Journeys Test pour vous et l'exécute sur l'appareil cible. Lors de l'exécution, Android Studio compile et déploie votre application, et se connecte à Gemini pour déterminer les actions à effectuer à chaque étape de votre parcours.

Pointez sur la miniature dans l'éditeur pour en savoir plus. Cela peut être utile lorsque vous itérez sur les requêtes de votre parcours.

Panneau des résultats des tests de parcours dans Android Studio, affichant les détails des étapes et le raisonnement de Gemini.

Afficher les résultats

Une fois qu'Android Studio a terminé de tester votre parcours, le panneau des résultats des tests s'affiche automatiquement.

Par rapport aux autres tests instrumentés que vous pouvez exécuter dans Android Studio, l'affichage des résultats des parcours présente quelques différences.

Le panneau Tests décompose le parcours en étapes distinctes. Vous pouvez cliquer sur chaque étape pour en savoir plus sur la façon dont Gemini l'a exécutée.
Le panneau Résultats affiche des informations détaillées pour vous aider à comprendre l'interprétation et le raisonnement de Gemini concernant votre trajet, ainsi que la façon dont Gemini l'a exécuté.
Les captures d'écran envoyées à Gemini sont affichées pour vous aider visuellement à chaque action de l'étape.
Chaque action effectuée et la raison de Gemini pour cette action sont décrites à côté de chaque capture d'écran.
Chaque action de l'étape est numérotée.

Problèmes connus

Lorsque vous testez un parcours, toutes les autorisations pour votre application sont accordées par défaut.
Lorsque vous testez un parcours sur un appareil exécutant Android 15 (niveau d'API 35), un avertissement peut s'afficher sur l'appareil, indiquant Application non sécurisée bloquée pour AndroidX Crawler. Vous pouvez cliquer sur Installer quand même pour ignorer cette vérification. Vous pouvez également configurer les options pour les développeurs sur l'appareil et désactiver l'option Valider les applis via USB.
Les fichiers de parcours n'apparaissent pas actuellement dans la vue Android du panneau Projets. Pour afficher les fichiers de parcours dans votre projet, utilisez la vue Projet.
Si plusieurs actions d'un parcours partagent exactement la même requête, les résultats des tests affichés dans l'éditeur de parcours peuvent être incorrects. Plus précisément, toutes les actions associées à la requête en double afficheront les résultats de test associés à l'instance la plus récemment mise à jour de cette requête. Pour contourner ce problème, assurez-vous que chaque action possède une invite unique, par exemple en ajoutant un préfixe ou un suffixe distinct.
Un pop-up de stylet s'affiche la deuxième fois que le clavier est chargé sur un nouvel émulateur. Cette pop-up entraîne généralement l'échec des tests qui interagissent avec les champs de texte. Dans ce cas, fermez le pop-up et relancez le parcours.
Il peut arriver que des artefacts du robot d'exploration d'applications apparaissent dans la justification de l'agent.
L'exécution du parcours échoue parfois avec un IllegalStateException. Dans ce cas, vous pouvez cliquer sur Résultats du test pour afficher l'erreur complète.
Si le plug-in Android Gradle (com.android.application) n'est pas défini dans le fichier build.gradle de premier niveau, l'erreur suivante peut s'afficher lors de l'exécution d'un parcours :
```
Failed to apply plugin class 'com.android.tools.journeys.JourneysGradlePlugin'
```
Pour résoudre ce problème, assurez-vous que le plug-in est défini dans le fichier build.gradle de premier niveau. Pour en savoir plus, consultez Configurer le système de compilation Android.