Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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 haven't yet, go to the Firebase console and create a new Firebase 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.