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

Android 通用环境检查

本文件只读检查，不安装软件、不修改设备。

项目检查

1. 确认项目根目录。
2. 确认 .pouch/tester/catalog.yaml 存在且 validate 通过。
3. 只选择 driver: mobile 的用例。
4. 读取 .pouch/tester/local.yaml；缺少 Android 目标配置时停止，不猜目标。

推荐的本地配置字段：

ANDROID_TARGET_MODE: device
ANDROID_SERIAL: ""
ANDROID_AVD: ""
ANDROID_PACKAGE: ""
ANDROID_APK: ""
ANDROID_ACTIVITY: ""

主机检查

• uname -m 必须是 x86_64。
• adb 必须可执行。
• 模拟器路径还必须有 emulator、sdkmanager 和 KVM。
• 记录 Android SDK 根目录、工具版本和当前用户。

未安装工具属于 environment-fail。不要在普通测试运行中顺手安装；安装只能进入 明确的 Debian 安装模式。

运行前报告

先报告：

目标: 真机 | 模拟器
项目测试目录: 已找到 | 缺失
ADB: 通过 | 缺失
模拟器工具链: 通过 | 缺失 | 不适用
KVM: 通过 | 缺失 | 不适用
目标设备: 已解析 | 未解析
结论: 可执行 | environment-fail