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

Parcours pour Android Studio

La création de parcours pour Android Studio facilite l'écriture et la maintenance 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 effectue sur votre application. Il est donc facile d'écrire et de comprendre vos parcours. Vous pouvez également rédiger 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 réfléchit aux actions à effectuer pour atteindre les objectifs, les parcours sont plus résistants aux changements subtils 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'appareil.

Écrivez et exécutez des parcours directement depuis Android Studio sur n'importe quel appareil Android local ou à distance. L'IDE offre une nouvelle expérience d'éditeur 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 voyage

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

Pour créer et commencer à modifier un parcours, procédez comme suit :

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

Décrire 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 constamment l'état de votre application pour déterminer si elle est 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 accepte 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 simplement la direction et l'intention de votre geste de balayage. Par défaut, Gemini effectue des balayages depuis le centre de l'écran, mais vous pouvez lui indiquer d'effectuer un balayage sur une autre partie de l'écran de l'appareil. * Évitez les interactions complexes et les modifications de configuration : Gemini ne prend actuellement pas en charge 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 d'instrumentation. Android Studio génère des résultats détaillés qui vous aident à comprendre l'exécution de votre parcours.

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

Des résultats limités s'affichent également dans l'éditeur lors de l'exécution d'un parcours, comme les captures d'écran, l'action effectuée et le raisonnement lors de l'exécution de chaque étape de votre parcours. Il vous suffit de pointer sur la miniature dans l'éditeur pour afficher plus d'informations. Cela peut être utile lorsque vous itérez sur les requêtes de votre parcours.

Afficher les résultats

Une fois qu'Android Studio a terminé de tester votre parcours, le panneau des résultats de test 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 comment Gemini a interprété et analysé votre parcours, et comment il a été exécuté.
Les captures d'écran envoyées à Gemini sont affichées à titre d'aide visuelle pour chaque action de l'étape.
Chaque action effectuée et le raisonnement de Gemini pour justifier cette action sont décrits à 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 équipé d'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 des tests 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 requête 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.