reactivecircus/Android Emulator Runner
Installs, configures and starts an Android Emulator directly on hardware-accelerated runners.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Activelast commit Jul 5, 2026
- License
- Apache 2.0
Pinned Snippet
uses: reactivecircus/android-emulator-runner@a421e43855164a8197daf9d8d40fe71c6996bb0d # v2.38.0tags can be moved; commit SHAs can't. why a SHA?
Inputs
| name | description | required | default |
|---|---|---|---|
| api-level | API level of the platform and system image - e.g. 23, 33, 35-ext15, Baklava | yes | — |
| system-image-api-level | API level of the system image - e.g. 34-ext10, 35-ext15. If not set the `api-level` input will be used. | no | — |
| target | target of the system image - e.g. default, google_apis, google_apis_ps16k, google_apis_playstore, google_apis_playstore_16k, aosp_atd, google_atd, android-wear, android-wear-cn, android-tv, google-tv, android-automotive, android-automotive-playstore or android-desktop | — | default |
| arch | CPU architecture of the system image - x86, x86_64 or arm64-v8a | — | x86 |
| profile | hardware profile used for creating the AVD - e.g. `Nexus 6` | — | — |
| cores | the number of cores to use for the emulator | — | 2 |
| ram-size | size of RAM to use for this AVD, in KB or MB, denoted with K or M. - e.g. `2048M` | — | — |
| heap-size | size of heap to use for this AVD in MB. - e.g. `512M` | — | — |
| sdcard-path-or-size | path to the SD card image for this AVD or the size of a new SD card image to create for this AVD, in KB or MB, denoted with K or M. - e.g. `path/to/sdcard`, or `1000M` | — | — |
| disk-size | disk size to use for this AVD. Either in bytes or KB, MB or GB, when denoted with K, M or G | — | — |
| avd-name | custom AVD name used for creating the Android Virtual Device | — | test |
| force-avd-creation | whether to force create the AVD by overwriting an existing AVD with the same name as `avd-name` - `true` or `false` | — | true |
| emulator-boot-timeout | Emulator boot timeout in seconds. If it takes longer to boot, the action would fail - e.g. `300` for 5 minutes | — | 600 |
| emulator-port | Port to run emulator on, allows to run multiple emulators on the same physical machine | — | 5554 |
| emulator-options | command-line options used when launching the emulator - e.g. `-no-window -no-snapshot -camera-back emulated` | — | -no-window -gpu swiftshader_indirect -no-snapshot -noaudio -no-boot-anim |
| disable-animations | whether to disable animations - true or false | — | true |
| disable-spellchecker | whether to disable the Android spell checker framework, a common source of flakiness in text fields - `true` or `false` | — | false |
| disable-linux-hw-accel | whether to disable hardware acceleration on Linux machines - `true` or `false` or `auto` | — | auto |
| enable-hw-keyboard | whether to enable hardware keyboard - `true` or `false`. | — | false |
| emulator-build | build number of a specific version of the emulator binary to use - e.g. `6061023` for emulator v29.3.0.0 | — | — |
| working-directory | A custom working directory - e.g. `./android` if your root Gradle project is under the `./android` sub-directory within your repository | — | — |
| ndk | version of NDK to install - e.g. 21.0.6113669 | — | — |
| cmake | version of CMake to install - e.g. 3.10.2.4988404 | — | — |
| channel | Channel to download the SDK components from - `stable`, `beta`, `dev`, `canary` | — | stable |
| script | custom script to run - e.g. `./gradlew connectedCheck` | yes | — |
| pre-emulator-launch-script | custom script to run after creating the AVD and before launching the emulator - e.g. `./adjust-emulator-configs.sh` | — | — |
Outputs
no outputs