Android¶

Android devices can be created from either:

an SDK-discovered system image
a managed snapshot image captured from an existing device

1. List Available Images¶

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

An SDK-backed image usually looks like Pixel 8 Android 14.

2. Create The Device¶

curl -s http://127.0.0.1:8000/api/devices \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "android-lab-01",
    "platform": "android",
    "model": "Pixel 8",
    "os_version": "14",
    "image": "Pixel 8 Android 14",
    "vm_config": {
      "no_graphics": true
    }
  }'

If you want to create from a captured snapshot instead, include its image_id as well.

3. Start The Device¶

curl -s http://127.0.0.1:8000/api/devices/<device-id>/power \
  -H 'Content-Type: application/json' \
  -d '{"action":"start"}'

4. Check Runtime State¶

curl -s http://127.0.0.1:8000/api/devices/<device-id>/runtime

5. Save A Snapshot Later¶

After you stop the emulator, capture it into a managed image:

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-lab-01-snapshot"
  }'

Note

Android vm_config currently focuses on no_graphics. iOS-specific CPU, memory, and disk settings are not used for Android device creation.