Function ensureAndroidEmulatorBooted

src/platforms/android/devices.ts:424–493

(params: {
  avdName: string;
  serial?: string;
  timeoutMs?: number;
  headless?: boolean;
})

}

export async function ensureAndroidEmulatorBooted(params: {
  avdName: string;
  serial?: string;
  timeoutMs?: number;
  headless?: boolean;
}): Promise<DeviceInfo> {
  await ensureAndroidSdkPathConfigured();
  const requestedAvdName = params.avdName.trim();
  if (!requestedAvdName) {
    throw new AppError('INVALID_ARGS', 'Android emulator boot requires a non-empty AVD name.');
  }
  const timeoutMs = params.timeoutMs ?? ANDROID_EMULATOR_BOOT_TIMEOUT_MS;

  if (!(await whichCmd('adb'))) {
    throw new AppError('TOOL_MISSING', 'adb not found in PATH');
  }
  if (!(await whichCmd('emulator'))) {
    throw new AppError('TOOL_MISSING', 'emulator not found in PATH');
  }

  const avdNames = await listAndroidAvdNames();
  const resolvedAvdName = resolveAndroidAvdName(avdNames, requestedAvdName);
  if (!resolvedAvdName) {
    throw new AppError('DEVICE_NOT_FOUND', `No Android emulator AVD named ${params.avdName}`, {
      requestedAvdName,
      availableAvds: avdNames,
      hint: 'Run `emulator -list-avds` and pass an existing AVD name to --device.',
    });
  }

  const startedAt = Date.now();
  const existing = findAndroidEmulatorByAvdName(
    await listAndroidDevices(),
    resolvedAvdName,
    params.serial,
  );
  const runningExisting = existing && isEmulatorSerial(existing.id) ? existing : undefined;
  if (!runningExisting) {
    const launchArgs = ['-avd', resolvedAvdName];
    if (params.headless) {
      launchArgs.push('-no-window', '-no-audio');
    }
    runCmdDetached('emulator', launchArgs);
  }

  const discovered =
    runningExisting ??
    (await waitForAndroidEmulatorByAvdName({
      avdName: resolvedAvdName,
      serial: params.serial,
      timeoutMs,
    }));

  const elapsedMs = Date.now() - startedAt;
  const remainingMs = Math.max(1_000, timeoutMs - elapsedMs);
  await waitForAndroidBoot(discovered.id, remainingMs);
  const refreshed = (await listAndroidDevices()).find((device) => device.id === discovered.id);
  if (refreshed) {