# Android 通用环境检查

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

## 项目检查

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

推荐的本地配置字段：

```yaml
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 安装模式。

## 运行前报告

先报告：

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