Google is committed to advancing racial equity for Black communities. See how.

Firebase Test Lab Overview

Firebase Test Lab lets you test your app on a range of devices and configurations, to give you a better idea of how it'll perform in your users' hands. To facilitate such broad testing, Test Lab runs your tests in batches called test matrices. In each matrix, your app is tested against multiple combinations of device configurations. For information about Test Lab quotas and billing plans, see Usage, Quotas, and Pricing.

Devices × Test Executions = Test Matrix

A device you run a test on, such as a phone, a tablet, or a wearable device. Devices in a test matrix are identified by device model, OS version, locale, and screen orientation.
Test execution
A test run on a device. In a typical test matrix there is one test execution per selected device.
Test matrix
A set of test executions. If any test execution in a matrix fails, the whole matrix fails as well.

You can choose how to initiate testing of your app, as follows:

  • Android Studio integration lets you test your app from your development environment.
  • The gcloud command line interface enables you to run tests from the command line interactively, and is also well suited for scripting as part of your automated build and testing process.
  • The Test Lab UI in the Firebase console lets you upload an app binary and initiate testing from anywhere.

You can also test your app with Test Lab when you upload and publish your app's APK files to the Play Store using either the alpha or beta channel. For more information, see Use pre-launch reports to identify issues and Robo tests.

Choose your testing method

You can use Test Lab to validate the stability of your app's user experience and the compatibility of your app across a range of devices.

Two testing methods are available to help you test your app: You can run Instrumentation tests and the Test Lab Robo test.

Instrumentation tests

Instrumentation tests are tests that you or your team have written specifically to test your app, using the Espresso and UI Automator 2.0 Android test frameworks. Instrumentation tests run for up to 45 minutes on physical devices, and for up to 60 minutes on virtual devices. Test results are provided for all test cases that complete execution during that time. To learn about running instrumentation tests, read Instrumentation tests.

When you write an instrumentation test, you create a second APK module that you later upload to Test Lab along with the APK module for your app. To learn about creating test APKs, see Test your app.

Robo test

Even if you have not written any instrumentation tests for your app, you can use Robo test to exercise your app by simulating user actions. To learn more, see Robo tests.

Game Loop test

To support game app testing, Test Lab now includes support for using a "demo mode" where the game app runs while simulating the actions of a player. This mode can include multiple loops (or scenarios), which can be logically organized using labels so that you can run related loops together. To learn more, see Game loop tests.

Choose your device type

Test Lab supports testing on several makes and models of Android devices installed and running in a Google data center. Tests on devices help you to detect issues that might not occur when testing your app using the Android emulator. To learn more, see Available devices.

Review your test results

Regardless of how you initiate your tests, all your test results are managed by Test Lab and can be viewed online. Test results include test logs and the details of any app failure. For Robo test, videos and screenshots are also available. For more details, see Analyze Firebase Test Lab Results.

When you initiate a test from Android Studio, you can also review test results from inside your development environment.

Test Lab and Google Play services

Test Lab devices usually run the most recent version of Google Play services. Because of the number of devices and configurations, however, it sometimes takes a few days for Test Lab to update the devices after a new Google Play services release. To ensure your tests run properly, check that your app uses a version of the Google Play services SDK at or below the one listed below.

Current supported Google Play services SDK: 11.8.0

Test Lab and mobile advertising

For app developers that use or work with digital advertising providers (for example, ad networks, demand-side platforms) and for digital advertising providers:

Test Lab provides developers with a scalable app testing infrastructure that automates app testing. Unfortunately, this capability could be misused by malicious apps designed to generate fraudulent ad revenue.

To mitigate this issue:

  • App developers should notify any digital advertising providers they work with to filter out revenues and all corresponding traffic generated from devices that belong to testing providers, including Test Lab.

  • Digital advertising providers can filter ad revenues and all corresponding traffic generated from Test Lab by filtering traffic originating from the following IP address blocks (note that you can also access this list by using the gcloud beta firebase test ip-blocks list command in the gcloud CLI):

Platform and device type CIDR IP address block
Android and iOS physical devices (added 03-2020) (added 04-2020) (added 04-2020) (added 04-2020)

Android virtual devices (added 11-2019) (added 11-2019) (added 11-2019) (added 11-2019) (added 7-2019)

Device cleanup

Google takes the security of your app data very seriously. For the physical devices used by Test Lab, we follow industry-standard best practices to remove app data from those devices after every test run to ensure that they are ready to run new tests. For devices that we can flash with a custom recovery image, we go one step further by flashing these devices between test runs.

For the virtual devices used by Test Lab, device instances are deleted after they are used so that each test run uses a new virtual device instance.