{"id":21944831,"url":"https://github.com/browserstack/browserstack-bitrise-espresso-step","last_synced_at":"2026-03-10T22:03:22.986Z","repository":{"id":41275355,"uuid":"505761759","full_name":"browserstack/browserstack-bitrise-espresso-step","owner":"browserstack","description":"The official Browserstack Espresso Bitrise Step, using which users can integrate their Bitrise CI/CD pipelines with Browserstack ","archived":false,"fork":false,"pushed_at":"2023-11-06T08:54:25.000Z","size":72,"stargazers_count":1,"open_issues_count":2,"forks_count":5,"subscribers_count":5,"default_branch":"main","last_synced_at":"2026-02-16T05:58:34.020Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/browserstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":"CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-06-21T08:47:14.000Z","updated_at":"2024-10-17T13:21:59.000Z","dependencies_parsed_at":"2024-06-20T23:29:28.215Z","dependency_job_id":null,"html_url":"https://github.com/browserstack/browserstack-bitrise-espresso-step","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/browserstack/browserstack-bitrise-espresso-step","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Fbrowserstack-bitrise-espresso-step","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Fbrowserstack-bitrise-espresso-step/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Fbrowserstack-bitrise-espresso-step/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Fbrowserstack-bitrise-espresso-step/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browserstack","download_url":"https://codeload.github.com/browserstack/browserstack-bitrise-espresso-step/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserstack%2Fbrowserstack-bitrise-espresso-step/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30357614,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-10T21:41:54.280Z","status":"ssl_error","status_checked_at":"2026-03-10T21:40:59.357Z","response_time":106,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-29T04:17:12.870Z","updated_at":"2026-03-10T22:03:22.969Z","avatar_url":"https://github.com/browserstack.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BrowserStack App Automate - Espresso\n\n## 🧩 Get started\n\nAdd this step directly to your workflow in the [Bitrise Workflow Editor](https://devcenter.bitrise.io/en/steps-and-workflows/introduction-to-workflows.html).\n\n## Run Espresso tests on BrowserStack\n\n\u003cdetails\u003e\n\u003csummary\u003eDescription\u003c/summary\u003e\n\nRun your Espresso tests on BrowserStack App Automate. This step collects the built APK from `$BITRISE_APK_PATH` and test apk from `$BITRISE_TEST_APK_PATH` environment variables.\n\n## Configure the Step\n\nTo add and configure the \"BrowserStack App Automate - Espresso\" step in Bitrise, complete the following steps:\n\n1. Open the Workflow you want to use in the Workflow Editor.\n​\n2. Before adding this step, add the [Android Build for UI testing](https://www.bitrise.io/integrations/steps/android-build-for-ui-testing) Step to your Workflow \u0026 configure it.\n​\n4. Add the **BrowserStack App Automate - Espresso** step right after the **Android Build for UI testing** step.\n​\n5. Add your BrowserStack Username and Access Key in the **Authentication** step input.\n​\n6. For **App \u0026 Test Suite** step inputs, the **Android Build for UI Testing** step exports an APK and a test APK, and their paths get automatically set in the APK path and Test APK path input fields. If you are not using **Android Build for UI Testing** step, make sure the **App path** input points to the path of the APK or AAB file of your app and test suite.\n​\n7. Add one or more devices in the **Devices** step input.\n​\n8. Configure additional step inputs like **Debug logs** and **Test Configurations** and start your build.\n\n\u003c/details\u003e\n\n## ⚙️ Configuration\n\n\u003cdetails\u003e\n\u003csummary\u003eInputs\u003c/summary\u003e\n\n| Key | Description | Flags | Default |\n| --- | --- | --- | --- |\n| `Android app under test` | Path of the app (.apk) file. | required | |\n| `Espresso test suite` | Path of the test suite (.apk) file . | required | |\n| `Devices` | Name of one or more device-OS combination in new line. For example: \u003cbr /\u003e `Samsung Galaxy S9 Plus-9.0` \u003cbr /\u003e`Google Pixel 3a-9.0` | required |  |\n| `instrumentation_logs` | Generate instrumentation logs of the test session  |  | `true` |\n| `Network logs` | Generate network logs of your Espresso test sessions to capture network traffic, latency, etc. |  | `false` |\n| `Android logcat logs` | Generate device logs (Android logcat) |  | `false` |\n| `Capture Screenshots` | Capture the screenshots of the test execution|  | `false` |\n| `Video recording` | Record video of the test execution  |  | `true` |\n| `Project name` | Project name of the tests |  |  |\n| `Notify project status` | A callback URL to enable BrowserStack notify about completion of build under a given project.   |  |  |\n| `Local testing` | Enable local testing to retrieve app data hosted on local/private servers  |  | `false` |\n| `Test sharding` | Enable test sharding to split tests cases into different groups instead of running them sequentially. \u003cbr /\u003eAdd the sharding value json here. Examples: **Input for auto strategy**: \u003cbr /\u003e ```{\"numberOfShards\": 2}, \"devices\": [\"Google Pixel 3-9.0\"]``` \u003cbr /\u003e **Input for package strategy**:```{\"numberOfShards\": 2, \"mapping\": [{\"name\": \"Shard 1\", \"strategy\": \"package\", \"values\": [\"com.foo.login\", \"com.foo.logout\"]}, {\"name\": \"Shard 2\", \"strategy\": \"package\", \"values\": [\"com.foo.dashboard\"]}]}```  **Input for class strategy**: ```{\"numberOfShards\": 2, \"mapping\": [{\"name\": \"Shard 1\", \"strategy\": \"class\", \"values\": [\"com.foo.login.user\", \"com.foo.login.admin\"]}, {\"name\": \"Shard 2\", \"strategy\": \"class\", \"values\": [\"com.foo.logout.user\"]}]}```|  |  |\n| `Clear app data` | Enable to clear app data after every test run|  | `false`  |\n| `Filter tests` | Key-value pairs of filters to run tests from supported test filtering strategies: class, package, annotation, size \u003cbr /\u003e Examples: **For class filtering strategy**: `class com.android.foo.ClassA, class com.android.foo.ClassB,class com.android.foo.ClassC` \u003cbr /\u003e **For package filtering strategy**: `package com.android.foo` \u003cbr /\u003e **For annotation filtering strategy**: `size small`,`size medium`,`size large`  |  |  |\n| `Single runner invocation` | Enable to run all tests in a single instrumentation process to reduce overall build time.  |  | `false`  |\n| `Mock server` | Enable to mock a web server in your espresso tests to mock your API responses. Learn more. |  | `false` |\n| `Build Status` | Wait for BrowserStack to complete the execution and get the test results  |  | `true` |\n| `Test capabilities` |\"New line separated variables, key and value seperated by `=` For example: `coverage=true` \u003cbr /\u003e`geoLocation=CN\"` |  |  |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eOutputs\u003c/summary\u003e\n\n| Environment Variable | Description |\n| --- | --- |\n| `$BROWSERSTACK_BUILD_URL` |BrowserStack Dashboard url for the executed build|\n| `$BROWSERSTACK_BUILD_STATUS`| Status of the executed build. Check out the [test results guide](https://www.browserstack.com/docs/app-automate/espresso/view-test-results) to learn about available status  |\n\n\u003c/details\u003e\n\n## Troubleshooting\n\nFor internal troubleshooting, we would recommend that you start from [here](https://devcenter.bitrise.io/en/builds/build-data-and-troubleshooting.html).\n\nIf you are still unable to figure out the problem, please feel free to create an [issue](https://github.com/browserstack/browserstack-bitrise-espresso-step/issues), we will look into it ASAP.\n\n## Contribution Guidelines\n\n1. Fork this [repository](https://github.com/browserstack/browserstack-bitrise-espresso-step)\n2. Add your changes\n3. Test your changes\n4. Raise a PR against this [repository](https://github.com/browserstack/browserstack-bitrise-espresso-step)\n5. Work on comments, if any\n6. Once approved by our maintainers, we will merge the PR\n7. We will mention your name when we publish our [release](https://github.com/browserstack/browserstack-bitrise-espresso-step/releases) with your contribution. :slightly_smiling_face:\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserstack%2Fbrowserstack-bitrise-espresso-step","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowserstack%2Fbrowserstack-bitrise-espresso-step","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserstack%2Fbrowserstack-bitrise-espresso-step/lists"}