Change screen orientation for XCUI tests

Change screen orientation of the device for your XCUI test executions on BrowserStack App Automate.

You can change the screen orientation of an iOS device to set your application in portrait or landscape mode during the execution of the test. To change screen orientation, pass the deviceOrientation parameter as shown in the table below.

REST API endpoint:

POST /app-automate/xcuitest/v2/build

Example cURL request:

Change the screen orientation to landscape:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/build" \
-d '{"deviceOrientation": "landscape", "devices": ["iPhone 8 Plus-11.0"], "app": "bs://f5L3azt9pLzE995f49376eb1fa3c284dc321f8d", "testSuite": "bs://6eb1fa3c284ddbe9971b2d1aee0d52943b9c081"}' \
-H "Content-Type: application/json"

Related topics

• Manage your uploaded app or test suite using our upload app REST API and upload test suite REST API.

• Use the get app API endpoint and list test suites API endpoint to list your recently uploaded apps and test suites.

• Delete your uploaded app or test suite using the delete app API endpoint and delete test suite API endpoint.