Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Firebase Test Lab fournit une infrastructure basée sur le cloud pour tester les applications Android. Ce document explique comment commencer à utiliser Test Lab avec la console Firebase.
Test Lab vous permet d'exécuter les types de tests suivants :
Test d'instrumentation : test que vous écrivez et qui vous permet de contrôler l'UI de votre application avec les actions que vous spécifiez. Un test d'instrumentation peut également faire des assertions explicites sur l'état de votre application pour vérifier le bon fonctionnement à l'aide des API AndroidJUnitRunner. Test Lab est compatible avec les frameworks de test d'instrumentation Espresso et UI Automator.
Test Robo : test qui analyse l'interface de votre application, puis l'explore automatiquement en simulant des activités utilisateur.
Test de boucle de jeu : test qui utilise un "mode démo" pour simuler les actions des joueurs dans les applications de jeu.
Avant de commencer
Votre projet Firebase doit être associé au forfait Blaze avec paiement à l'usage, ce qui signifie qu'il est associé à un compte Cloud Billing. Vous pouvez passer à la formule Blaze dans la console Firebase. Pour associer un compte Cloud Billing, vous devez être propriétaire ou éditeur de votre projet.
Étape 1 : Créer un projet Firebase
Si vous ne l'avez pas encore fait, accédez à la console Firebase et créez un projet Firebase.
Étape 2 : Exécuter un test
Test d'instrumentation
Dans la barre de navigation de la console Firebase, cliquez sur Test Lab, puis sur Get Started > Run an Instrumentation test (Premiers pas > Exécuter un test d'instrumentation).
Cliquez sur Parcourir, puis recherchez l'APK ou l'AAB de votre application et l'APK ou l'AAB de test avant de cliquer sur Continuer.
Définissez votre matrice de test en sélectionnant les appareils, les niveaux d'API Android, les orientations d'écran et les paramètres régionaux avec lesquels vous souhaitez tester votre application. Vous pouvez sélectionner uniquement les combinaisons d'appareils et de niveaux d'API Android que vous souhaitez cibler pour les tests.
(Facultatif) Cliquez sur Afficher les options avancées pour modifier le délai d'expiration du test, qui détermine la durée maximale de chaque exécution du test.
(Facultatif) Pour vous aider à identifier et à localiser vos matrices de test dans la consoleFirebase, vous pouvez ajouter une étiquette à votre matrice de test en saisissant un nom d'étiquette dans le champ Étiquette de la matrice de test (facultatif).
Cliquez sur Démarrer N tests, où "N" correspond au nombre de configurations de test valides de la matrice de test que vous définissez sur cet écran. Chaque test en attente est représenté par une icône d'horloge bleue lorsqu'il est en attente d'exécution. Cette icône se transforme en coche verte une fois le test terminé.
Une fois chaque test exécuté, cliquez sur l'appareil listé dans la colonne "Exécution du test" pour afficher les résultats des tests, y compris les scénarios de test, les journaux, les captures d'écran et les vidéos.
Test Robo
Dans la barre de navigation de la console Firebase, cliquez sur Test Lab, puis sur Premiers pas > Exécuter un test Robo.
Cliquez sur Parcourir, accédez à l'APK de votre application, puis cliquez sur Continuer.
Définissez votre matrice de test en sélectionnant les appareils, les niveaux d'API Android, les orientations d'écran et les paramètres régionaux avec lesquels vous souhaitez tester votre application.
(Facultatif) Cliquez sur Afficher les options avancées pour modifier les options suivantes :
Le délai avant expiration du test détermine la durée maximale de chaque exécution de test.
Les identifiants de compte de test sont utilisés pour fournir les identifiants d'un compte de test.
Des champs supplémentaires sont utilisés pour fournir des entrées de texte pour d'autres champs de texte de votre application.
(Facultatif) Pour vous aider à identifier et à localiser vos matrices de test dans la console Firebase, vous pouvez ajouter un libellé à votre matrice de test en saisissant un nom de libellé dans le champ Libellé de la matrice de test (facultatif).
Cliquez sur Démarrer N tests, où "N" correspond au nombre de configurations de test valides de la matrice de test que vous définissez sur cet écran. Chaque test en attente est indiqué par une icône d'horloge bleue pendant qu'il attend d'être exécuté. Cette icône se transforme en coche verte une fois le test terminé.
Une fois chaque test terminé, cliquez sur l'appareil listé dans la colonne "Exécution du test" pour afficher les résultats, y compris les scénarios de test, les journaux, les captures d'écran et les vidéos.
Sur la page Test Lab de la console Firebase, cliquez sur Run Your First Test > Run an Android Game Loop (Exécuter votre premier test > Exécuter une boucle de jeu Android).
Dans la section Importer l'application, cliquez sur Parcourir, puis sélectionnez le fichier APK de votre application (si vous ne l'avez pas encore fait, générez un fichier APK pour votre application).
(Facultatif) Pour vous aider à identifier et à localiser vos matrices de test dans la console Firebase, vous pouvez ajouter un libellé à votre matrice de test en saisissant un nom de libellé dans le champ Libellé de la matrice de test (facultatif).
(Facultatif) Si vous souhaitez exécuter plusieurs boucles ou scénarios à la fois, ou sélectionner des boucles spécifiques à exécuter, saisissez les numéros de boucle dans le champ Scénarios.
Par exemple, si vous saisissez "1-3, 5", Test Lab exécute les boucles 1, 2, 3 et 5.
Par défaut (si vous ne saisissez rien dans le champ Scénarios), Test Lab n'exécute que la boucle 1.
Dans la section Appareils, sélectionnez un ou plusieurs appareils physiques sur lesquels vous souhaitez tester votre application, puis cliquez sur Démarrer les tests.
Étape 3 : Examiner les résultats de vos tests
Lorsque le test commence, vous êtes automatiquement redirigé vers la page des résultats.
L'exécution des tests peut prendre plusieurs minutes, en fonction du nombre de configurations différentes que vous avez sélectionnées et de la durée du délai avant expiration définie pour vos tests. Une fois vos tests exécutés, vous pouvez examiner les résultats. Pour savoir comment interpréter les résultats du test, consultez Analyser les résultats Firebase Test Lab.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/16 (UTC).
[null,null,["Dernière mise à jour le 2025/08/16 (UTC)."],[],[],null,["\u003cbr /\u003e\n\nFirebase Test Lab provides cloud-based infrastructure for testing\nAndroid apps. This document describes how to get started with Test Lab using the\nFirebase console.\n\nTest Lab lets you run the following types of tests:\n\n- [Instrumentation test](/docs/test-lab/android/instrumentation-test):\n A test you write that allows you to drive the UI of your app with the actions\n you specify. An instrumentation test can also make explicit assertions about\n the state of your app to verify correct functionality using\n [AndroidJUnitRunnerAPIs](https://developer.android.com/reference/android/support/test/runner/AndroidJUnitRunner). Test Lab supports\n [Espresso](https://developer.android.com/training/testing/espresso)\n and\n [UI Automator](https://developer.android.com/training/testing/other-components/ui-automator) instrumentation test frameworks.\n\n- [Robo test](/docs/test-lab/android/robo-ux-test):\n A test that analyzes your app's interface and then explores it automatically\n by simulating user activities.\n\n- [Game loop test](/docs/test-lab/android/game-loop): A test\n that uses a \"demo mode\" to simulate player actions in game apps.\n\nBefore you begin\n\nYour Firebase project must be on the [pay-as-you-go Blaze pricing plan](/pricing), which means that\nyour project is linked to a Cloud Billing account. You can\n[upgrade to the Blaze pricing plan](//console.firebase.google.com/project/_/overview?purchaseBillingPlan=metered)\nin the Firebase console. You need to be an Owner or Editor for your project\nto link a Cloud Billing account.\n\nStep 1. Create a Firebase project\n\nIf you haven't yet, go to the [Firebase console](https://console.firebase.google.com/)\nand create a new Firebase project.\n| **Note:** If you're working on a shared Firebase project, you'll need to have ownership or edit permissions for the project.\n\nStep 2. Run a test \n\nInstrumentation test**Note:** If you want to run an instrumentation test with [Android Test Orchestrator](https://developer.android.com/training/testing/junit-runner.html#using-android-test-orchestrator), see [Enable Orchestrator](/docs/test-lab/android/instrumentation-test#orchestrator).\n\n1. On the [Firebase console](https://g.co/firebase) navigation bar,\n click **Test Lab** , and then click **Get Started -\\\u003e Run an Instrumentation\n test**.\n\n2. Click **Browse** , and then browse to your app APK or AAB and test APK or\n AAB before clicking **Continue**.\n\n3. Define your test matrix by selecting which devices, Android API levels,\n screen orientations and locales you want to test your app against. You can\n select only those device and Android API level combinations that you want\n to target for testing.\n\n4. (Optional) Click **Show advanced options** to change the Test timeout\n that determines the maximum duration of each test execution.\n\n5. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering a\n label name in the **Test matrix label (optional)** field.\n\n6. Click **Start *N* Tests**, where \"N\" is the number of valid test\n configurations from the test matrix that you define on this screen. Each\n pending test is shown with a blue clock icon while it is waiting to run,\n and that icon changes to a green check icon when the test has completed.\n\n7. After each test has run, click the device listed in the Test Execution\n column to see test results, including test cases, logs, screenshots and\n videos.\n\nRobo test\n\n1. On the [Firebase console](https://g.co/firebase) navigation bar,\n click **Test Lab** , and then click **Get Started -\\\u003e Run a Robo test**.\n\n2. Click **Browse** , browse to your app APK, and then click **Continue**.\n\n3. Define your test matrix by selecting which devices, Android API levels,\n screen orientations and locales you want to test your app against.\n\n4. (Optional) Click **Show advanced options** to change the following options:\n\n - Test timeout determines the maximum duration of each test execution.\n - Test account credentials are usedis used to provide credentials for a test account.\n\n | **Caution:** Never use this option with real user accounts.\n - Additional fields are used to provide text input for other text fields in your app.\n\n | **Note:** To learn more about Test account credentials and additional fields, see [Test account sign-in and predefined text](/docs/test-lab/robo-ux-test#test_account_sign-in_and_predefined_text_input).\n5. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering\n a label name in the **Test matrix label (optional)** field.\n\n6. Click **Start *N* Tests**, where \"N\" is the number of valid test\n configurations from the test matrix that you define on this screen. Each\n pending test is shown with a blue clock icon while it is waiting to run,\n and that icon changes to a green check when the test has completed.\n\n7. After each test finishes running, click the device listed in the Test\n Execution column to see test results, including test cases, logs,\n screenshots and videos.\n\nIf you want to create a script to guide the Robo test, see\n[Record a Robo script using Test Lab in Android Studio](/docs/test-lab/android/run-robo-scripts#record-android-studio).\n\nGame Loop test\n\n1. On the Test Lab page of the [Firebase console](https://console.firebase.google.com/project/_/%0Atestlab), click **Run Your First Test \\\u003e Run an Android Game Loop**.\n\n2. In the **Upload App** section, click **Browse** , then select your app's\n APK file (if you haven't already, [generate an APK file](https://firebase.google.com/docs/test-lab/android/game-loop#run-testlab) for your app).\n\n3. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering\n a label name in the **Test matrix label (optional)** field.\n\n4. (Optional) If you want to run multiple loops or scenarios at a time, or\n select specific loops to run, enter the loop numbers in the\n **Scenarios** field.\n\n For example, when you enter \"1-3, 5\", Test Lab runs loops 1, 2, 3, and 5.\n By default (if you don't enter anything in the **Scenarios** field),\n Test Lab only runs loop 1.\n5. In the **Devices** section, select one or more physical devices you\n want to test your app on, then click **Start Tests**.\n\nStep 3. Investigate your test results\n\nWhen the test starts, you're automatically redirected to the test results page.\nTests can take a number of minutes to run, depending on the number of different\nconfigurations you have selected and the test timeout duration set for your\ntests. After your tests have run, you can review test results. See\n[Analyzing Firebase Test Lab Results](/docs/test-lab/android/analyzing-results) to learn more\nabout how to interpret the test results.\n| **Note:** For all test types, any uncaught exception will cause a test failure."]]
