---

name: emumanager description: > Manages Android SDK, emulators, and AVDs. Use when bootstrapping Android SDK, creating/starting/stopping AVDs, downloading system images, or troubleshooting emulator issues. Supports mobile, Wear OS, TV, and Automotive devices. Covers sdkmanager, avdmanager, emulator CLI. Triggers: android emulator, android virtual device, avd, system image, wear os emulator, tv emulator, automotive emulator, bootstrap android sdk.

Android Emulator Manager

Important: Use Script First

ALWAYS use scripts/emumanager over raw sdkmanager, avdmanager, or emulator commands. The script provides features that raw commands do not:

• Automatic system image selection for device types (--mobile, --wear, --tv)
• Boot completion detection with timeout
• Sensible defaults and helpful error messages
• Diagnostics via doctor subcommand

When to read the script source: If the script doesn't do exactly what you need, or fails due to missing dependencies, read the script source. It encodes solutions to SDK quirks and boot detection edge cases—use it as reference when building similar functionality.

Quick Start

Environment Variables

Copyexport ANDROID_HOME="${ANDROID_HOME:-$HOME/.local/share/android-sdk}"
export ANDROID_USER_HOME="${ANDROID_USER_HOME:-$HOME/.android}"

Prerequisites

• Java 17 or higher
• Hardware acceleration: KVM on Linux, HVF (Hypervisor Framework) on macOS
• Network access for downloading SDK components

Highest-Value Commands

Copy# First-time setup (installs cmdline-tools, platform-tools, build-tools, emulator)
scripts/emumanager bootstrap

# Diagnose issues (Java version, hardware acceleration, disk space)
scripts/emumanager doctor

# Create a mobile/phone AVD with latest API
scripts/emumanager create my_phone --mobile

# Start the AVD
scripts/emumanager start my_phone

# List all AVDs (shows running status)
scripts/emumanager list

# Show detailed AVD information
scripts/emumanager info my_phone

Subcommand Overview

bootstrap

Set up SDK environment. Installs cmdline-tools, platform-tools, build-tools, emulator, and a platform.

Copyscripts/emumanager bootstrap
scripts/emumanager bootstrap --no-emulator  # Skip emulator installation

doctor

Run diagnostics to check for common issues: Java version, hardware acceleration, SDK tools, disk space, orphaned AVD files.

Copyscripts/emumanager doctor

list

List all available AVDs with running status.

Copyscripts/emumanager list              # Show all AVDs with status
scripts/emumanager list --names-only # Just AVD names
scripts/emumanager list --running-only
scripts/emumanager list --stopped-only

info

Show detailed information about an AVD: system image, API level, screen config, RAM, storage, Play Store status.

Copyscripts/emumanager info my_phone

create

Create a new AVD with device type or specific image.

Copyscripts/emumanager create my_phone --mobile   # Mobile/phone (default)
scripts/emumanager create my_watch --wear     # Wear OS
scripts/emumanager create my_tv --tv          # Android/Google TV
scripts/emumanager create my_car --auto       # Android Automotive

# With specific system image
scripts/emumanager create my_avd "system-images;android-36;google_apis_playstore;arm64-v8a"

start

Start an AVD. Waits for boot to complete.

Copyscripts/emumanager start my_phone              # Quick Boot (fast)
scripts/emumanager start my_phone --cold-boot  # Cold boot (bypass snapshots)
scripts/emumanager start my_phone --wipe-data  # Factory reset + cold boot

stop

Stop a running AVD.

Copyscripts/emumanager stop my_phone

delete

Delete an AVD and clean up files. Stops the AVD first if running.

Copyscripts/emumanager delete my_phone

download

Download a specific system image.

Copyscripts/emumanager download "system-images;android-36;google_apis_playstore;arm64-v8a"

images

List available system images for the host architecture (API level >= 33). Installed images are marked with *.

Copyscripts/emumanager images

outdated

Show outdated SDK packages.

Copyscripts/emumanager outdated

update

Update all installed SDK packages to latest versions.

Copyscripts/emumanager update

Device Types

The create command supports device type flags that automatically select the latest appropriate system image for the host architecture:

If no device type or image is specified, defaults to mobile/phone.

Start Mode Options

Common Workflows

First-Time Setup

Copyscripts/emumanager bootstrap
scripts/emumanager doctor

Creating and Running a Phone Emulator

Copyscripts/emumanager create my_phone --mobile
scripts/emumanager start my_phone

Creating a Wear OS Emulator

Copyscripts/emumanager create my_watch --wear
scripts/emumanager start my_watch

Factory Resetting an AVD

Copyscripts/emumanager start my_phone --wipe-data

Checking for SDK Updates

Copyscripts/emumanager outdated
scripts/emumanager update

Safety Notes

• Script requires Java 17+ to run SDK tools
• Hardware acceleration (KVM/HVF) is required for x86_64/arm64 emulators
• System image downloads can be several GB
• Some operations require network access
• The script avoids destructive actions unless explicitly requested
• Use ANDROID_SERIAL environment variable when multiple emulators are running

Reference Documentation

• references/command-index.md - Detailed subcommand reference
• references/troubleshooting.md - Common issues and solutions