Android Emulator Driver

jumpstarter-driver-androidemulator manages Android emulator lifecycle with ADB tunneling through Jumpstarter. It provides power control (start/stop) for the Android emulator and combines it with the ADB driver for device access.

Installation

pip3 install --extra-index-url https://pkg.jumpstarter.dev/simple/ jumpstarter-driver-androidemulator

For the optional Python ADB API:

pip3 install --extra-index-url https://pkg.jumpstarter.dev/simple/ "jumpstarter-driver-androidemulator[python-api]"

Prerequisites

• Android SDK with emulator and platform-tools installed
• emulator and adb available on PATH (or specify emulator_path)
• An AVD created via Android Studio or avdmanager

Quick AVD Setup

# Apple Silicon (arm64)
sdkmanager "system-images;android-35;google_apis;arm64-v8a"
avdmanager create avd -n Pixel_6 -k "system-images;android-35;google_apis;arm64-v8a" -d pixel_6

# Intel/AMD (x86_64)
sdkmanager "system-images;android-35;google_apis;x86_64"
avdmanager create avd -n Pixel_6 -k "system-images;android-35;google_apis;x86_64" -d pixel_6

Configuration

Example exporter configuration:

export:
  android:
    type: jumpstarter_driver_androidemulator.driver.AndroidEmulator
    config:
      avd_name: "Pixel_6"
      headless: true
      console_port: 5554
      adb_server_port: 15037

Configuration Parameters

Usage

CLI

# Power on the emulator
j android power on

# Check ADB devices through the tunnel
j android adb devices

# Run ADB commands
j android adb shell getprop ro.product.model

# Create a persistent ADB tunnel
j android adb tunnel

# Power off the emulator
j android power off

Python API

from jumpstarter.common.utils import serve
from jumpstarter_driver_androidemulator.driver import AndroidEmulator

driver = AndroidEmulator(avd_name="Pixel_6")
with serve(driver) as client:
    client.power.on()

    # Wait for boot and get an adbutils device
    with client.adb_device(timeout=180) as device:
        print(device.prop.model)
        print(device.shell("pm list packages"))

    client.power.off()

Architecture

This is a composite driver with two children:

• adb (AdbServer from jumpstarter-driver-adb): Manages the ADB server and provides TCP tunneling for remote ADB access
• power (AndroidEmulatorPower): Controls the emulator process lifecycle via the standard PowerInterface (on/off/read)

The emulator registers with the custom ADB server on port 15037 (via the ANDROID_ADB_SERVER_PORT environment variable) to avoid conflicts with any local ADB server on the standard port 5037.

API Reference

Driver

.. autoclass:: jumpstarter_driver_androidemulator.driver.AndroidEmulator()
    :members:

.. autoclass:: jumpstarter_driver_androidemulator.driver.AndroidEmulatorPower()
    :members: on, off, read

Client

.. autoclass:: jumpstarter_driver_androidemulator.client.AndroidEmulatorClient()
    :members: adb_device