# Android 模拟器路径

## 环境检查

执行：

```bash
emulator -accel-check
emulator -list-avds
```

必须同时满足：

- KVM 可用。
- 指定 AVD 存在。
- AVD 的 system image 与 x86_64 主机匹配。
- 没有被 VirtualBox、VMware 或 Docker 等外层虚拟化阻断。

## 启动与等待

- 如果目标 AVD 已运行，检查序列号和 AVD 名称后复用。
- 如果没有运行，启动用户指定的 AVD，不创建替代 AVD。
- 使用 ADB 等待设备出现，并等待 `sys.boot_completed=1`。
- 启动失败、启动超时或 KVM 失效都记为 `environment-fail`。
- 无桌面服务器时可使用 `-no-window -no-audio`，但必须先确认测试不需要可视化交互。

## 执行与收尾

- 一轮测试只绑定一个 AVD。
- 需要安装 APK 或清数据时按 mutating 规则处理。
- 测试失败时保存 logcat、模拟器信息和截图。
- 只关闭本轮由 skill 启动且配置为临时会话的模拟器。
- 不删除 AVD、不修改系统镜像、不覆盖用户已有配置。