.pouch/skills/android-tester/references/emulator.md

Android 模拟器路径

环境检查

执行：

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、不修改系统镜像、不覆盖用户已有配置。