> For the complete CircleCI developer hub index, see [llms.txt](https://circleci.com/developer/llms.txt)

# emulator-wtf/run-tests

Emulator.wtf is an Android cloud emulator laser-focused on performance to deliver quick feedback to your PRs.
With this orb you can easily run your Android instrumentation tests with emulator.wtf.


## Commands

### run-tests

Run Android instrumentation tests using emulator.wtf.


| Parameter | Type | Default | Description |
|---|---|---|---|
| `additional-apks` | string |  | Additional apks to install, one per line |
| `app` | string |  | Path to application apk file |
| `cache-version` | string | 1 | cache version, change this in case of cache corruption |
| `clear-package-data` | boolean | false | Whether to clear app data between every test (requires use-orchestrator) |
| `devices` | string |  | Device configurations to use, in the form of model=X,version=Y per line |
| `directories-to-pull` | string |  | Directories to pull from device and store in outputs-dir, one per line |
| `environment-variables` | string |  | Environment variables to pass to AndroidJUnitRunner, comma-separated list of key-value pairs: key=value,key2=value2 |
| `num-shards` | integer | 0 | Set to a number larger than 1 to randomly split your tests into multiple shards to be executed in parallel |
| `num-uniform-shards` | integer | 0 | Set to a number larger than 1 to randomly split your tests into multiple shards to be executed in parallel |
| `outputs-dir` | string |  | Location to store test outputs in |
| `test` | string |  | Path to test apk file |
| `use-orchestrator` | boolean | false | Whether to use the Android Test Orchestrator |
| `version` | string | 0.0.47 | ew-cli version to use |
| `with-coverage` | boolean | false | Set to true to collect coverage files and save them to outputs-dir |

## Examples

### example

Sample example description.


```yaml
version: '2.1'
orbs:
  <orb-name>: <namespace>/<orb-name>@1.2.3
workflows:
  use-my-orb:
    jobs:
      - <orb-name>/<job-name>
```