Start testing with the Firebase console

Instrumentation test

1. On the Firebase console navigation bar, click Test Lab, and then click Get Started -> Run an Instrumentation test.

2. Click Browse, and then browse to your app APK or AAB and test APK or AAB before clicking Continue.

3. Define your test matrix by selecting which devices, Android API levels, screen orientations and locales you want to test your app against. You can select only those device and Android API level combinations that you want to target for testing.

4. (Optional) Click Show advanced options to change the Test timeout that determines the maximum duration of each test execution.

5. (Optional) To help you identify and locate your test matrices in the Firebase console, you can add a label to your test matrix by entering a label name in the Test matrix label (optional) field.

6. Click Start N Tests, where "N" is the number of valid test configurations from the test matrix that you define on this screen. Each pending test is shown with a blue clock icon while it is waiting to run, and that icon changes to a green check icon when the test has completed.

7. After each test has run, click the device listed in the Test Execution column to see test results, including test cases, logs, screenshots and videos.

Robo test

1. On the Firebase console navigation bar, click Test Lab, and then click Get Started -> Run a Robo test.

2. Click Browse, browse to your app APK, and then click Continue.

3. Define your test matrix by selecting which devices, Android API levels, screen orientations and locales you want to test your app against.

4. (Optional) Click Show advanced options to change the following options:

   • Test timeout determines the maximum duration of each test execution.
   • Test account credentials are usedis used to provide credentials for a test account.
   • Additional fields are used to provide text input for other text fields in your app.

5. (Optional) To help you identify and locate your test matrices in the Firebase console, you can add a label to your test matrix by entering a label name in the Test matrix label (optional) field.

6. Click Start N Tests, where "N" is the number of valid test configurations from the test matrix that you define on this screen. Each pending test is shown with a blue clock icon while it is waiting to run, and that icon changes to a green check when the test has completed.

7. After each test finishes running, click the device listed in the Test Execution column to see test results, including test cases, logs, screenshots and videos.

If you want to create a script to guide the Robo test, see Record a Robo script using Test Lab in Android Studio.

Game Loop test

1. On the Test Lab page of the Firebase console, click Run Your First Test > Run an Android Game Loop.

2. In the Upload App section, click Browse, then select your app's APK file (if you haven't already, generate an APK file for your app).

3. (Optional) To help you identify and locate your test matrices in the Firebase console, you can add a label to your test matrix by entering a label name in the Test matrix label (optional) field.

4. (Optional) If you want to run multiple loops or scenarios at a time, or select specific loops to run, enter the loop numbers in the Scenarios field.

   For example, when you enter "1-3, 5", Test Lab runs loops 1, 2, 3, and 5. By default (if you don't enter anything in the Scenarios field), Test Lab only runs loop 1.

5. In the Devices section, select one or more physical devices you want to test your app on, then click Start Tests.