Clear application data

Some scenarios require a clean state of the app to run tests. For example, suppose you want to run multiple test cases where each test case requires logging into the app. While the first test is signed into the app with the login data, running the second test within the same session causes it to fail since the app is already logged in.

For such scenarios, App Automate provides parameters that you can set to clear app data after test runs.

In this section, you’ll learn about:

• Supported Android versions
• How to clear app data
• How to clear app data for a build that uses the single runner invocation feature

Supported Android versions

• Android 5.0 – Lollipop and higher.

Clear app data

Set the clearPackageData parameter to true in a cURL command for clearing app data after test runs in a normal test flow.

The following sample cURL command shows the parameters used to clear app data on Samsung Galaxy S8 with Android OS v7.0:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/espresso/v2/build" \
-d '{"clearPackageData": "true", "devices": ["Samsung Galaxy S8-7.0"], "app": "<app_id>", "testSuite": "<test_suite_id>"}' \
-H "Content-Type: app/json"

The following table lists the parameters used in a cURL request for clearing app data:

Clear app data for build that uses single runner invocation

The single runner invocation feature runs all test cases together rather than running them in a separate process. To use this feature and clear app data after each test run, you need to enable Android test orchestrator.

Set the useOrchestrator and clearPackageData parameters to true in the cURL request to enable Android test orchestrator and clear app data respectively.

The following sample cURL command shows how to use Android Test Orchestrator and clear app data on Samsung Galaxy S8 with Android OS v7.0:

curl -u "YOUR_USERNAME:YOUR_ACCESS_KEY" \
-X POST "https://api-cloud.browserstack.com/app-automate/espresso/v2/build" \
-d '{ “singleRunnerInvocation”:”true”, "useOrchestrator": "true", “clearPackageData”:”true”, "devices": ["Samsung Galaxy S8-7.0"], "app": "<app_id>", "testSuite": "<test_suite_id>"}' \
-H "Content-Type: app/json"

The following table lists the parameters used in a cURL request for clearing app data when using the single runner invocation feature: