Get started with Firebase Test Lab for iOS

Firebase Test Lab lets you quality test your app on a range of devices and configurations. This guide provides an overview of Test Lab's key concepts, iOS offerings, and instructions on how to start testing.

For information about Test Lab quotas and pricing plans, see Usage, Quotas, and Pricing.

Key concepts and terms

When you run a test or a set of test cases against devices and configurations you've selected, Test Lab runs the test against your app in a batch, then displays the results as a test matrix.

Devices × Test Executions = Test Matrix

A physical or virtual device (Android only) you run a test on, such as a phone, tablet, or wearable device. Devices in a test matrix are identified by device model, OS version, screen orientation, and locale (also known as geography and language settings).
Test, test execution
A test (or a set of test cases) to be run on a device. You can run one test per device, or optionally shard the test and run its test cases on different devices.
Test matrix
Contains the statuses and test results for your test executions. If any test execution in a matrix fails, the whole matrix fails.

Step 1: Prepare your test for uploading to Test Lab

You can run the following tests with Test Lab. Note that all test types can run up to a maximum of 45 minutes on physical devices, and any uncaught exception will cause a test failure.

  • XCTest (including XCUITests): A unit test you've written using the XCTest framework. Visit Create an XCTest for instructions on modifying an XCTest to run with Test Lab.

  • Game Loop test: A test that uses a "demo mode" to simulate player actions in gaming apps. This is a fast and scalable way to verify that your game performs well for users. When you choose to run a Game Loop test, you can:

    • Write tests native to your game engine.

    • Avoid writing the same code for different UIs or testing frameworks.

    • Optionally create multiple loops to run in a single test execution. You can also organize loops by using labels so you can keep track of them and re-run specific loops.

    Visit Run a Game Loop test for instructions on how to run your test in Test Lab.

Step 2: Choose a tool to run your test

You can choose the following tools to run your test with:

  • The Firebase console lets you upload an app and initiate testing from anywhere. See Test with the Firebase console for instructions on using this tool.

  • The gcloud command line interface (CLI) 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. See Test with the gcloud CLI for instructions on using this tool.

  • Before testing on real devices, run your test locally on a simulator to make sure it behaves as intended. See Test locally for instructions.

Step 3: Specify testing devices

With Test Lab, you can run your test against your app on a wide range of iOS devices and models hosted in a Google data center. To learn more, see Available devices.

Step 4: Review test results

Regardless of how you initiate your tests, all your test results are managed by Test Lab and can be viewed online.

The test result summary is automatically stored and can be viewed in the Firebase console. It contains the most relevant data for your test, including test case-specific videos, screenshots, the number of tests that passed, failed, or got flaky results, and more.

The raw test results contain test logs and app failure details, and is automatically stored in a Google Cloud bucket. If you specify a bucket, you are responsible for the cost of the storage. If you don't specify a bucket, Test Lab creates one for you at no cost.

For more details, see Analyze Firebase Test Lab Results.

Device cleanup

Google takes the security of your app data very seriously. We follow industry-standard best practices to remove app data and reset system settings for physical 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.

Allowing Test Lab devices to access private backend servers

Some mobile apps need to communicate with private backend services to function correctly during testing. If your backend servers are protected by firewall rules, you can allow access for Test Lab's physical and virtual devices by using the IP address blocks below to open routes through your firewall.

Mobile advertising

Test Lab provides a scalable infrastructure that automates app testing, and unfortunately, this capability can be misused by malicious apps designed to generate fraudulent ad revenue.

To mitigate this issue:

  • If you use or work with third-party digital advertising providers (for example, ad networks or demand-side platforms), you're recommended to use test ads rather than real ads during app development and testing.

  • If you must use real ads in your test, notify the digital advertising providers you work with to filter out revenues and all corresponding traffic generated from Test Lab by using the IP address blocks below. You don't need to notify Google-owned ad providers; Test Lab takes care of that for you.

IP addresses used by Test Lab devices

All network traffic generated by Test Lab devices originates from the following IP address blocks. You can also access this list by using the gcloud beta firebase test ip-blocks list command in the gcloud CLI. The list is updated on average once a year.

Platform and device type CIDR IP address block
Android and iOS physical devices, Arm virtual devices (added 02-2022) (added 02-2022) (expanded 02-2022) (added 02-2022) (added 02-2022) (added 02-2022) (added 02-2022)

2001:4860:1008::/48 (added 02-2022)

2001:4860:1018::/48 (added 02-2022)

2001:4860:1019::/48 (added 02-2022)

2001:4860:1020::/48 (added 02-2022)

2001:4860:1022::/48 (added 02-2022) (added 04-2024)

Android virtual devices (Non-Arm) (added 11-2019) (added 11-2019) (added 11-2019) (added 11-2019) (added 02-2022) (added 02-2022) (added 02-2022) (added 02-2022) (added 7-2019) (added 02-2022)

Device IP-blocks no longer being used (removed 02-2022) (removed 02-2022)