If it's your first test, clickGet Startedunder iOS. If you
previously ran a test, clickRun a Test, and then selectRun an XCTest.
ClickBrowse, and find the.zipfile you
created.
Check the box for each device, version, orientation, and locale you'd like to
test against.
(Optional) To help you identify and locate your test matrices in theFirebaseconsole, you can add a label to your test matrix by entering a
label name in theTest matrix label (optional)field.
ClickStart Tests.
Game Loop test
On theTest Labpage of theFirebaseconsole,
clickRun Your First Test > Run an iOS Game Loop.
In theUpload Appsection, clickBrowse, then select your app's
IPA file (if you haven't already,generate an IPA filefor your app).
(Optional) To help you identify and locate your test matrices in theFirebaseconsole, you can add a label to your test matrix by entering
a label name in theTest matrix label (optional)field.
(Optional) If you want to run multiple loops (aka scenarios) at a time or
select specific loops to run, enter the loop numbers in theScenariosfield.
For example, when you enter "1-3, 5",Test Labruns loops 1, 2, 3, and 5.
By default (if you don't enter anything in theScenariosfield),Test Labonly runs loop 1.
In theDevicessection, select one or more physical devices you want to
test your app on, then clickStart 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. SeeAnalyzingFirebase Test LabResultsto learn more
about how to interpret the test results.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["\u003cbr /\u003e\n\nThis guide describes how to run iOS tests using the Firebase console.\n\nStep 1. Create a Firebase project\n\nIf you haven't yet, go to the [Firebase console](https://console.firebase.google.com/)\nand create a new Firebase project.\n| **Note:** If you're working on a shared Firebase project, you'll need to have ownership or edit permissions for the project.\n\nStep 2. Upload and run your test \n\nXCTest\n\n1. Open Test Lab in the [Firebase console](https://console.firebase.google.com/project/_/testlab).\n\n2. If it's your first test, click **Get Started** under iOS. If you\n previously ran a test, click **Run a Test** , and then select\n **Run an XCTest**.\n\n3. Click **Browse** , and find the `.zip` file you\n created.\n\n4. Check the box for each device, version, orientation, and locale you'd like to\n test against.\n\n5. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering a\n label name in the **Test matrix label (optional)** field.\n\n6. Click **Start Tests**.\n\nGame Loop test\n\n1. On the Test Lab page of the [Firebase console](https://console.firebase.google.com/project/_/testlab),\n click **Run Your First Test \\\u003e Run an iOS Game Loop**.\n\n2. In the **Upload App** section, click **Browse** , then select your app's\n IPA file (if you haven't already, [generate an IPA file](/docs/test-lab/ios/run-game-loop-test#package-app)\n for your app).\n\n3. (Optional) To help you identify and locate your test matrices in the\n Firebase console, you can add a label to your test matrix by entering\n a label name in the **Test matrix label (optional)** field.\n\n4. (Optional) If you want to run multiple loops (aka scenarios) at a time or\n select specific loops to run, enter the loop numbers in the **Scenarios**\n field.\n\n For example, when you enter \"1-3, 5\", Test Lab runs loops 1, 2, 3, and 5.\n By default (if you don't enter anything in the **Scenarios** field),\n Test Lab only runs loop 1.\n5. In the **Devices** section, select one or more physical devices you want to\n test your app on, then click **Start Tests**.\n\nStep 3. Investigate your test results\n\nWhen the test starts, you're automatically redirected to the test results page.\nTests can take a few minutes to run, depending on the number of different\nconfigurations you have selected and the test timeout duration set for your\ntests. After your tests have run, you can review test results. See\n[Analyzing Firebase Test Lab Results](/docs/test-lab/ios/analyzing-results) to learn more\nabout how to interpret the test results."]]
