Single runner invocation

By default, each XCUI test case is invoked separately in a different process to produce segregated debugging logs for each test case. However, this process increases overall execution time for your build as each test case run spawns a new process. Alternatively, you can disable this behavior and execute all test cases together (on each device) in one process and still get segregated logs for individual test cases. This can help significantly speed up the test execution time and ensure improved consistency in execution times. To do so, you can use the singleRunnerInvocation parameter in the REST API request for XCUI tests or REST API request for XCTestPlan tests to start your test execution.

REST API endpoints:

POST /app-automate/xcuitest/v2/build
POST /app-automate/xcuitest/v2/xctestrun-build

Example cURL request to start the execution of your XCUI tests:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"singleRunnerInvocation": "true", "devices": ["iPhone 14-16"], "app": "bs://f7c874f21852ba57957a3fdc33f47514288c4ba4", "testSuite": "bs://e994db8333e32a5863938666c3c3491e778352ff"}' \
-H "Content-Type: application/json"

Example cURL request to start the execution of your XCTestPlan tests:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/xctestrun-build" \
-d '{"singleRunnerInvocation": "true", "devices": ["iPhone 14-16"], "app": "bs://f7c874f21852ba57957a3fdc33f47514288c4ba4", "testSuite": "bs://e994db8333e32a5863938666c3c3491e778352ff"}' \
-H "Content-Type: application/json"