Skip to main content
Transform your testing process with: Real Device Features, Company-wide Licences, & App Percy

Upload apps from filesystem

In order to test your native and hybrid apps on BrowserStack using XCUITest, you first need to upload your app to BrowserStack servers. Its easy to upload an iOS app (.ipa file) from your local filesystem or CI/CD server to BrowserStack using the REST API.

Here is an example cURL request to upload an iOS app :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/xcuitest/v2/app" \
-F "file=@/path/to/app/file/app-debug.ipa"

A sample response to the above API request is shown below :

{
    "app_url":"bs://f7c874f21852ba57957a3fdc33f47514288c4ba4"
}

Please note the value of app_url in the API response (bs://f7c874f21852.... in the above example). This value will be used later to specify the application under test for your XCUI test execution.

You can manage your uploaded apps by using our REST API. Use the recent apps API endpoint to list your recently uploaded apps. You can delete your uploaded apps by using the delete app API endpoint. By default, we will delete the uploaded app after 30 days from the date of upload.

Note:
  1. App upload will take a few seconds to about a minute depending on the size of your app. Do not interrupt the cURL command until you get the response back.
  2. For iOS app uploads, we will re-sign the app with our own provisioning profile to be able to install your app on our devices during test execution. However, if your app is signed using the Apple Developer Enterprise Program, you can disable this behavior to test features such as push notifications on BrowserStack devices. To disable re-signing, use the resignApp parameter and set it to false in the REST API request while executing your XCUI test-suite.

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback

Is this page helping you?

Yes
No

We're sorry to hear that. Please share your feedback so we can do better

Contact our Support team for immediate help while we work on improving our docs.

We're continuously improving our docs. We'd love to know what you liked






Thank you for your valuable feedback!

Talk to an Expert
Download Copy