Gradle Plugin
Documentation for running Espresso test using BrowserStack's Gradle Plugin.
Getting Started
You can easily build your app and execute the test using BrowserStack Gradle Plugin. In order to configure the plugin add below snippet in your app's build.gradle file.
plugins {
id: com.browserstack.gradle
}
runDebugBuildOnBrowserstack {
username = "BROWSERSTACK_USERNAME"
accessKey = "BROWSERSTACK_ACCESS_KEY"
devices = \"devices\": [\"Google Pixel-8.0\", \"Google Pixel-7.1\"]
}
Execute below command to build your app and run your Espresso test
gradle runDebugBuildOnBrowserstack
This will execute the following:
- Build debug and test apks, as dependencies are declared on assembleDebug and assembleDebugAndroidTest tasks.
- Find the latest app apk and test apk in the app directory recursively.
- Upload both the apks on BrowserStack server.
- Execute Espresso test using the uploaded apps on the devices mentioned in the configuration.
Complete list of supported parameters
- username (required): Your BrowserStack username
- accessKey (required): Your BrowserStack accessKey
-
devices (required): List of Device and OS version you want to run your tests on. Acceptable format is <devicename>-<os version>. Example:
devices = ["Google Pixel-8.0", "Samsung Galaxy S8-7.1"] - deviceLogs (optional): Set this parameter if you want to enable the device logs
- packages (optional): Set this parameter to test only some selected packages. Acceptable format is: ["com.browserstack", "com.browserstack1"]
- classes (optional): Set this parameter to test only some selected classes. Acceptable format is: ["com.browserstack.class1", "com.browserstack.class2"]
- annotations (optional): Set this parameter if you want to run tests only for particular annotations ["P1", "P2"]
- sizes (optional): Set this parameter if you want to run tests that have @SmallTest, @MediumTest and @LargeTest annotations. Acceptable format is: ["small", "medium"]
- video (optional): Set this parameter if you want to enable the video of the test run. By default its set to true
- local (optional): Set this parameter if you want to enable local testing. By default its set to false
-
localIdentifier (optional): If you are using same account to test multiple applications, you can setup named connection using the localIdentifier option. Example:
localIdentifier = "Test123" - callbackURL (optional): Set the callback url where we can send a confirmation once your test execution is completed
The test results are available on the command-line interface, as well as the App Automate dashboard. You have now run your first Espresso test using Gradle Plugin on BrowserStack App Automate.