android-test-emulator

name	android-test-emulator
description	Launch or create the local Android emulator required before running Android connected/instrumented tests in this repository. Use this whenever running Android tests is required and no suitable device is already connected.

Android Test Emulator

Use this skill before running Android connected tests such as connectedAndroidTest or connectedDebugAndroidTest.

The required AVD name is Unstyled_Tests. If it does not exist, create it with:

• API level: 23
• System image: system-images;android-23;default;x86_64
• Disk size: 2048M

Workflow

1. Check connected devices:

   adb devices
   

2. If a device is already connected and booted, use it.

3. Otherwise launch/create the project emulator:

   bash .agents/skills/android-test-emulator/scripts/launch_unstyled_tests_emulator.sh
   

4. Wait until boot is complete before running Android tests. The script waits for:

   adb shell getprop sys.boot_completed
   

5. After the emulator is ready, run the requested Android test task.

Notes

• Do not run Android tests until the emulator appears in adb devices as device and sys.boot_completed is 1.
• If emulator is not on PATH, use $ANDROID_HOME/emulator/emulator, $ANDROID_SDK_ROOT/emulator/emulator, or $HOME/Library/Android/sdk/emulator/emulator.
• The script uses the same runtime options expected for test execution: -no-snapshot-save -no-window -gpu swiftshader_indirect -noaudio -no-boot-anim -camera-back none.