Android Image (Android SDK)¶

Android works a little differently from iOS. Installed Android SDK system images are discovered automatically by the agent and exposed as available images.

1. Install Android Tooling¶

Make sure the agent host has:

a JDK
Android command line tools
adb
emulator
avdmanager
sdkmanager

Set ANDROID_SDK_ROOT to the SDK location if it is not already in the default path.

2. Install A System Image¶

Example for Android 14 on Apple Silicon:

yes | sdkmanager --licenses
sdkmanager \
  "platform-tools" \
  "emulator" \
  "system-images;android-34;google_apis;arm64-v8a"

3. Verify Image Discovery¶

Once the agent reconnects, list images:

curl -s http://127.0.0.1:8000/api/images

You should see Android SDK-backed entries such as:

name: "Pixel 8 Android 14"
platform: "android"
source: "sdk"

The agent derives these from installed SDK system images and the supported Android device models it advertises.

4. Optional: Capture A Snapshot Image¶

After customizing a stopped Android device, save it as a reusable snapshot:

curl -s http://127.0.0.1:8000/api/images/from-device \
  -H 'Content-Type: application/json' \
  -d '{
    "device_id": "00000000-0000-0000-0000-000000000000",
    "name": "Android 14 QA Snapshot"
  }'

Snapshot images are stored under runtime/android-images/<image-id>.

Important

SDK-discovered Android images are read-only inventory. You can create devices from them, but you cannot rename or delete the SDK entries themselves.