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

Get started with Firebase Test Lab from the Firebase Console

This guide describes how to run iOS tests using the Firebase console.

Step 1: Create a Firebase project

If you don't have a Firebase project for your app, go to the Firebase console and click Create New Project to create one now. You will need ownership or edit permissions in your project.

Step 2: Upload and run your test

Run an XCTest

  1. Open Test Lab in the Firebase console.

  2. If it's your first test, click Get Started under iOS. If it isn't, click Run a Test, and then select Run an XCTest.

  3. Click Browse, and find the .zip file you created.

  4. Check the box for each device, version, orientation, and locale you'd like to test against.

  5. Click Start Tests.

Run a Game Loop test

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

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

  3. Optional: If you want to run multiple loops (aka 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.

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

Step 3: Investigate your test results

When the test starts, you're automatically redirected to the test results page. Tests can take a few minutes to run, depending on the number of different configurations you have selected and the test timeout duration set for your tests. After your tests have run, you can review test results. See Analyzing Firebase Test Lab Results to learn more about how to interpret the test results.