Upload custom files to BrowserStack-hosted devices using XCUITest

Upload custom files to BrowserStack-hosted devices to run your XCUITest tests on BrowserStack App Automate.

App Automate provides preloaded media files on BrowserStack remote devices to test scenarios that require access to files on the device.

Apart from preloaded media files, you can also upload your media or non-media files in App Automate.

Supported file types and OS version

The following tab lists the supported files types you can upload, and OS version on which you can upload the files.

Upload your file to BrowserStack

Run the following upload media cURL command to upload your file to BrowserStack servers:

  curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
  -X POST "https://api-cloud.browserstack.com/app-automate/upload-media" \
  -F "file=@/path/to/your/file" \
  -F "custom_id=SampleFile"

A sample response for the given cURL command is as follows. It returns the value of the media_url parameter.

{
  "media_url": "media://90c7a8h8dc82308108734e9a46c24d8f01de12881",
  "custom_id": "SampleFile"
}

The file you uploaded will be available in the following folders on the device:

Set uploadMedia parameter when executing build

In the execute build cURL command, set the uploadMedia parameter to the value of the media_url parameter returned in the API response.

The following sample cURL command shows the parameter used to access your uploaded files for testing on iPhone 8 Plus with iOS 11.0:

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

Need help?

If you need any help with this feature, get in touch with us.