Skip to main content
No Result Found

Execute tests

Test your application on real devices using Maestro on BrowserStack’s App Automate

Prerequisites

  • BrowserStack Username and Access key, which you can find in your account profile. If you have not created an account yet, you can sign up for a Free Trial.
  • Application to test
  • Test suite

Refer to supported devices list for the list of supported Android and iOS devices. For more details on the supported APIs, refer to our REST API reference page.

iOS devices below version 15 are not supported.

Upload app

Upload your Android (.apk or .aab file) or iOS (.ipa) apps to BrowserStack servers using the following REST API request:

Terminal
Copy icon Copy

Here is a sample response:

{
    "app_name": "debug.apk",
    "app_url": "bs://c8ddcb5649a8280ca800075bfd8f151115bba6b3",
    "app_version": "1.2.0",
    "app_id": "c8ddcb5649a8280ca800075bfd8f151115bba6b3",
    "uploaded_at": "2020-05-05 14:52:54 UTC",
    "custom_id": "SampleApp",
    "shareable_id": "steve/SampleApp",
    "expiry" : "2020-06-05 14:52:54 UTC"
}

Upload test suite

Upload your Maestro test suite (.yml) file to BrowserStack servers using the following REST API request:

Terminal
Copy icon Copy

Here is a sample response:

{
    "test_suite_name": "Flows.zip",
    "test_suite_url": "bs://89c874f21852ba57957a3fdc33f47514288c4ba1",
    "test_suite_id": "89c874f21852ba57957a3fdc33f47514288c4ba1",
    "uploaded_at": "2020-09-09 15:35:00 UTC",
    "custom_id": "SampleTest",
    "shareable_id": "Steve/SampleTest",
    "framework": "maestro",
    "expiry": "2020-10-09 15:35:00 UTC"
}

Execute tests

You can execute tests on both Android and iOS devices.

Starting a build
To initiate test execution on BrowserStack, your API request must include:

Optional parameters can customize test execution. Each build receives a unique build_id in the response. For more information on executing tests, refer to our REST API reference page.

Terminal
Copy icon Copy
Terminal
Copy icon Copy

Here is a sample response:

{
    "message": "Success",
    "build_id": "5c5ab4338cec13aeb78f7a6977344556ac00bccd6"
}

View test results

After initiating your Maestro test execution via the REST API:

  • Navigate to your App Automate dashboard and select your test.

  • You can access the following on the dashboard:

    • Live test results

    • Debugging logs (network, device, video etc.)

    • Comprehensive execution details

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 Check Circle