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

Agent de test d'application (Android)

L'agent de test d'application est un agent de génération, de gestion et d'exécution de scénarios de test optimisé par Gemini dans Firebase. Vous définissez des objectifs de test en langage naturel, et l'agent utilise l'IA pour comprendre votre application et y naviguer, simuler des interactions utilisateur et fournir des résultats de test détaillés.

Comment l'agent App Testing utilise vos données

L'agent de test d'application est fourni par Gemini dans Firebase et est soumis aux mêmes conditions. Pour en savoir plus sur la manière dont Gemini dans Firebase utilise vos données, consultez Utilisation de vos données par Gemini dans Firebase.

Avant de commencer

Si ce n'est pas déjà fait, enregistrez votre application auprès de Firebase.

Si vous n'utilisez aucun autre produit Firebase, il vous suffit de créer un projet et d'enregistrer votre application. Vous n'avez pas besoin d'ajouter de SDK à votre application. Toutefois, si vous décidez d'utiliser d'autres produits à l'avenir, veillez à suivre toutes les étapes de la section Ajouter Firebase à l'aide de la console Firebase.

Lorsque vous êtes prêt à distribuer une version préliminaire de votre application à des testeurs, compilez votre APK ou AAB en suivant votre procédure habituelle, puis importez-le dans App Distribution dans la console Firebase. Vous devez signer l'APK avec votre clé de débogage ou votre clé de signature d'application.

Créer un scénario de test

Pour exécuter des tests guidés par l'IA, l'agent App Testing utilise vos scénarios de test en langage naturel pour exécuter des tests sur votre application.

Chaque scénario de test est divisé en étapes, qui seront exécutées dans l'ordre. Les étapes vous permettent de diviser votre cas de test en phases, chacune avec ses propres critères de réussite. L'agent peut effectuer de nombreuses actions à chaque étape.

Pour créer un cas de test, ouvrez la page App Distribution de la console Firebase et procédez comme suit :

Dans l'onglet Scénarios de test, cliquez sur Nouveau scénario de test. Si vous ne souhaitez pas créer votre propre cas de test, vous pouvez modifier ou utiliser l'exemple de cas de test fourni.
Dans la boîte de dialogue Ajouter un scénario de test, donnez un nom au scénario de test. Il permet d'identifier le test, mais est ignoré par l'agent.
Envisagez de diviser votre test en plusieurs étapes en cliquant sur le bouton Ajouter une étape.
Donnez à chaque étape un objectif qui décrit ce que l'agent de test d'application doit faire à cette étape.
(Facultatif) Ajoutez un indice pour fournir des informations supplémentaires afin d'aider l'agent de test d'application à comprendre votre application et à la parcourir lors de cette étape.
(Facultatif) Ajoutez des critères de réussite pour aider l'agent de test d'applications à déterminer quand l'étape a été correctement effectuée.
Cliquez sur Enregistrer une fois que vous avez terminé de personnaliser votre test.

Exemple de scénario de test

Voici un exemple de création d'un scénario de test à l'aide de l'agent App Testing :

Tester la page d'accueil
Titre test	Chargements de la page d'accueil
Objectif	Charger la page d'accueil
Indice	Passez les écrans d'accueil. Fermez les pop-ups. Ne vous connectez pas.
Critères de réussite	La page d'accueil principale de l'application est visible à l'écran, toutes les images sont chargées et aucune erreur ne s'affiche.

Exécuter un test

L'agent App Testing vous permet d'exécuter des tests guidés par l'IA dans la console en cliquant sur le bouton Exécuter les tests depuis la page "Versions" ou "Scénarios de test". L'écran de personnalisation de l'agent de test d'application s'ouvre. Vous pouvez y sélectionner un ou plusieurs de vos scénarios de test existants pour que l'agent les exécute. Vous pouvez également choisir les appareils sur lesquels vous souhaitez effectuer les tests et indiquer si vous souhaitez fournir des identifiants de connexion.

Vous pouvez également choisir d'exécuter un test d'exploration aléatoire en modifiant le type de test. Les tests d'exploration aléatoire utilisent la fonctionnalité Testeur automatisé.

Vous pouvez consulter les résultats de vos tests sur la page Releases, dans l'onglet Agent App Testing d'une release. Le bouton Afficher les détails ouvre la boîte de dialogue "Résultats du test", qui affiche les éventuels problèmes, les captures d'écran de l'application et les actions effectuées par Gemini lors du test.

Tester automatiquement vos compilations

Pour exécuter automatiquement des tests de l'agent App Testing sur vos nouvelles versions, par exemple à partir de pipelines CI/CD, vous pouvez distribuer vos versions à l'agent à l'aide des plug-ins Gradle ou fastlane de App Distribution, ou de la CLI Firebase.

Tester automatiquement vos compilations avec la CLI Firebase

Vous devez spécifier au moins un appareil de test et un ID de scénario de test pour utiliser la fonctionnalité d'agent App Testing. Vous pouvez trouver et télécharger les ID des scénarios de test sur la page "Scénarios de test" de la console Firebase. Pour en savoir plus sur les premiers pas avec la CLI Firebase et sur les différentes façons de configurer votre distribution, consultez Distribuer des applications Android aux testeurs à l'aide de la CLI Firebase.

Exécutez la commande appdistribution:distribute pour importer votre application, puis utilisez les paramètres suivants pour configurer sa distribution à la fonctionnalité d'agent App Testing :

Options de appdistribution:distribute
`--test-devices` ou `--test-devices-file`	Les appareils de test sur lesquels vous souhaitez distribuer des versions à la fonctionnalité Agent de test d'application. Vous pouvez spécifier les appareils de test sous forme de liste d'appareils de test séparés par un point-virgule : `--test-devices: "model=tokay, version=36, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'appareils de test séparés par un point-virgule : `--test-devices-file: "/path/to/test-devices.txt"` Vous pouvez rechercher les modèles d'appareils disponibles à l'aide de la gcloud CLI.
`--test-username`	Nom d'utilisateur pour la connexion automatique à utiliser lors des tests.
`--test-password` ou `--test-password-file`	Mot de passe à utiliser lors des tests pour la connexion automatique. Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant un mot de passe : `--test-password-file: "/path/to/test-password.txt"`
`--test-non-blocking`	Exécutez les tests de manière asynchrone. Consultez la console Firebase pour obtenir les résultats des tests automatiques.
`--test-case-ids` ou `--test-case-ids-file`	Liste d'ID de scénarios de test séparés par une virgule pour exécuter des tests automatisés optimisés par l'IA : `--test-case-ids: "load-app,play-the-first-level"` Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'ID de cas de test séparés par une virgule ou un saut de ligne : `--test-case-ids-file: "/path/to/test-case-ids.txt"`

Tester automatiquement vos builds avec Gradle

Vous devez spécifier au moins un appareil de test et un ID de scénario de test pour utiliser la fonctionnalité d'agent App Testing. Vous pouvez trouver et télécharger les ID des scénarios de test sur la page "Scénarios de test" de la console Firebase. Pour en savoir plus sur la prise en main de Gradle et sur les différentes façons de configurer votre distribution, consultez Distribuer des applications Android aux testeurs à l'aide de Gradle.

Vous pouvez configurer App Distribution en ajoutant au moins une section firebaseAppDistribution et en utilisant les paramètres suivants pour configurer la distribution à la fonctionnalité d'agent App Testing :

App Distribution Paramètres de compilation
`testDevices` ou `testDevicesFile`	Les appareils de test sur lesquels vous souhaitez distribuer des versions à la fonctionnalité Agent de test d'application. Vous pouvez spécifier les appareils de test sous forme de liste de spécifications d'appareils séparées par des points-virgules. `testDevices="model=tokay, version=36, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` Vous pouvez également spécifier le chemin d'accès à un fichier contenant une liste de spécifications d'appareils séparées par un point-virgule : `testDevicesFile="/path/to/testDevices.txt"` Vous pouvez rechercher les modèles d'appareils disponibles à l'aide de la gcloud CLI.
`testUsername`	Nom d'utilisateur pour la connexion automatique à utiliser lors des tests.
`testPassword` ou `testPasswordFile`	Mot de passe à utiliser lors des tests pour la connexion automatique. Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant un mot de passe : testPasswordFile="/path/to/testPassword.txt"
`testNonBlocking`	Exécutez les tests de manière asynchrone. Accédez à la console Firebase pour consulter les résultats des tests automatiques.
`testCases`ou `testCasesFile`	Liste d'ID de scénarios de test séparés par une virgule pour exécuter des tests automatisés optimisés par l'IA : `testCases: "load-app,play-the-first-level"` Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'ID de cas de test séparés par une virgule ou un saut de ligne : `testCasesFile: "/path/to/test-case-ids.txt"`

Tester automatiquement vos builds avec fastlane

Vous devez spécifier au moins un appareil de test et un ID de scénario de test pour utiliser la fonctionnalité d'agent App Testing. Vous pouvez trouver et télécharger les ID des scénarios de test sur la page "Scénarios de test" de la console Firebase. Pour en savoir plus sur la prise en main de fastlane et sur les différentes façons de configurer votre distribution, consultez Distribuer des applications Android aux testeurs à l'aide de fastlane.

Dans une voie ./fastlane/Fastfile, ajoutez un bloc firebase_app_distribution. Utilisez les paramètres suivants pour configurer votre distribution à la fonctionnalité d'agent de test d'application :

Paramètres firebase_app_distribution
`test_devices` ou `test_devices_file`	Les appareils de test sur lesquels vous souhaitez distribuer des versions à la fonctionnalité Agent de test d'application. Vous pouvez spécifier les appareils de test sous forme de liste d'appareils de test séparés par un point-virgule : `test_devices: "model=tokay, version=36, locale=en, orientation=portrait;model=b0q, version=33, locale=en, orientation=portrait"` Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'appareils de test séparés par un point-virgule : `test_devices_file: "/path/to/test-devices.txt"` Vous pouvez rechercher les modèles d'appareils disponibles à l'aide de la gcloud CLI.
`test_username`	Nom d'utilisateur pour la connexion automatique à utiliser lors des tests.
`test_password` ou `test_password_file`	Mot de passe à utiliser lors des tests pour la connexion automatique. Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant un mot de passe : `test_password_file: "/path/to/test-password.txt"`
`test_non_blocking`	Exécutez les tests de manière asynchrone. Consultez la console Firebase pour obtenir les résultats des tests automatiques.
`--test_case_ids` ou `--test_case_ids_file`	Liste d'ID de scénarios de test séparés par une virgule pour exécuter des tests automatisés optimisés par l'IA : `--test_case_ids: "load-app,play-the-first-level"` Vous pouvez également spécifier le chemin d'accès à un fichier texte brut contenant une liste d'ID de cas de test séparés par une virgule ou un saut de ligne : `--test_case_ids_file: "/path/to/test-case-ids.txt"`

Déboguer les résultats de vos tests

Si les résultats de vos tests sont différents de ce à quoi vous vous attendiez, vous pouvez les déboguer à l'aide du bouton Afficher la vue de l'agent sous Afficher les détails sur la page "Résultats des tests". La vue de l'agent vous montre les éléments à l'écran que l'agent App Testing a pu détecter en utilisant les informations d'accessibilité de l'application. Si vous souhaitez examiner de plus près ce que l'agent a vu, vous pouvez télécharger ces informations depuis le menu à développer.

Vous pouvez également utiliser le bouton Afficher les artefacts sur la page "Résultats des tests" pour consulter toutes les vidéos, tous les journaux et tous les autres artefacts Cloud associés aux résultats de vos tests.

Limites et problèmes connus

La version preview de l'agent de test d'application présente certaines limites connues :

Étant donné que l'agent de test d'application utilise l'IA générative pour tester votre application, il effectuera parfois des actions différentes tout en suivant les mêmes instructions.
L'agent App Testing n'est compatible qu'avec les actions suivantes : appuyer, saisir du texte, balayer vers le haut/le bas/la gauche/la droite, appuyer de manière prolongée, faire glisser et déposer, revenir en arrière et attendre.
L'agent de test d'application a du mal à exécuter les tests ne contenant qu'une seule étape nécessitant de nombreuses actions. Il fonctionne mieux lorsque les tâches complexes sont divisées en plusieurs étapes plus courtes.
L'agent de test d'application ne fait parfois pas défiler l'écran pour afficher d'autres éléments. Cela se produit plus souvent lorsqu'il n'y a aucune indication visuelle de la possibilité de faire défiler l'écran. Pour contourner ce problème, le champ "hints" peut être utilisé pour suggérer le défilement.
L'agent de test d'applications a parfois du mal à compter, par exemple à effectuer une action un nombre spécifique de fois.
L'agent App Testing ne peut pas naviguer dans votre application si l'option FLAG_SECURE est activée. Au lieu de voir des captures d'écran de votre application, il ne verra qu'un écran vide.

Tester les quotas

Pendant la phase bêta, les tests guidés par l'IA seront proposés sans frais dans la limite d'un quota. La limite de quota par défaut est de 200 tests par mois et par projet Firebase.

Notez que si vous choisissez d'exécuter plusieurs scénarios de test ou le même scénario de test sur plusieurs appareils, cela compte comme plusieurs tests. Par exemple, si vous exécutez deux cas de test sur deux appareils, cela compte comme quatre tests au total.

Pour augmenter votre quota au-delà de la limite par défaut, contactez l'assistance Firebase en expliquant votre cas d'utilisation.