Define custom ID for app

On every app upload, a new value for app_url is generated. You need to use this value to execute your Espresso tests with the latest build of the app.

If you want to use a constant value to specify the application under test and don’t want to modify your scripts after every build upload, you can define a custom ID for your app. Use the same custom ID every time you upload a new build of the app. Here is an example cURL request to upload an Android app with the custom ID defined as CalculatorApp :

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/upload" \
-F "file=@/path/to/app/file/Application-debug.apk" \
-F "custom_id=CalculatorApp"

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/upload" \
-F "url=https://www.browserstack.com/app-automate/sample-apps/android/WikipediaSample.apk" \
-F "custom_id=CalculatorApp"

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

 {
    "app_url":"bs://f7c874f21852ba57957a3fdc33f47514288c4ba4", 
    "custom_id":"CalculatorApp",
    "shareable_id":"exampleuser/CalculatorApp"
 }

While executing your Espresso tests, simply use the custom_id value (CalculatorApp in the above example) to specify the application under test. The test execution will pick the last uploaded build corresponding to that custom ID.