Skip to content

Start Emulator

Start an emulator and wait for it to boot. Supports cold boot, headless mode, and data wipe options.

The tool diffs adb devices before and after launching to identify the exact serial (e.g. emulator-5554) assigned to the emulator it just started, and polls that specific device with adb -s <serial> until sys.boot_completed is set. This means the reported result — and any boot-completion check — always refers to the emulator this call started, even if other emulators are already running.

ParameterTypeRequiredDefaultDescription
avdNamestringYesName of the AVD to start
coldBootbooleanNofalseForce cold boot (ignore snapshots)
noWindowbooleanNofalseRun headless (no GUI window)
wipeDatabooleanNofalseReset to factory state

Start the TestDevice emulator

Start the emulator with cold boot

Start the emulator in headless mode with wiped data