---
name: android-tester
description: >-
  检查并运行 Android 真机或模拟器测试；支持 Debian amd64 上安装
  Android Emulator、KVM 依赖、SDK 工具和 AVD。触发词：Android 测试、安卓测试、
  真机测试、Android 模拟器、AVD、ADB、安装安卓模拟器、检查 Android 环境。
---

# Android Tester

项目根是 `git rev-parse --show-toplevel`。本 skill 复用项目已有的
`.pouch/tester/` 用例和运行记录，不创建第二套测试目录。

## 模式路由

- 用户要求安装或配置 Android 模拟器：先读 `references/install-debian.md`。
- 用户要求检查环境：先读 `references/environment.md`，再按目标读 `device.md` 或
  `emulator.md`。
- 用户要求用真机测试：目标固定为 `device`，读 `device.md`。
- 用户要求用模拟器测试：目标固定为 `emulator`，读 `emulator.md`。
- 用户要求报告结果或复盘失败：读 `references/reporting.md`。

## 全局硬规则

- 每次运行测试前必须重新检查环境；检查失败记为 `environment-fail`，不伪装成产品失败。
- 真机与模拟器必须由用户明确选择，禁止自动 fallback。
- 运行范围和结果语义遵循 `tester`：默认 smoke、默认 readonly，使用
  `pass/fail/environment-fail/skipped/not-run`。
- 不自动构建 APK；只使用项目提供的测试命令或已有 APK。
- 安装 APK、清除数据、授予权限、修改设备设置属于 mutating，必须有明确授权。
- 不自动清空真机、重启真机、创建或删除未知 AVD。
- Debian 安装模式只接受 `ID=debian` 且 `amd64/x86_64`；Ubuntu、其他发行版、ARM
  主机必须停止并说明不在第一版范围内。
- 没有 `.pouch/tester/catalog.yaml` 时，不静默初始化，提示用户先初始化 `tester`。

## 运行顺序

1. 解析测试范围和目标模式。
2. 检查 `.pouch/tester/`、本地配置和工具链。
3. 检查真机或模拟器目标是否可用。
4. 必要时只启动本轮自己创建的模拟器会话。
5. 按 tester 用例顺序执行测试。
6. 失败时采集 logcat 和截图，生成 YAML/CSV 运行记录。
7. 按 `references/reporting.md` 输出结果，并执行目标会话的安全收尾。

## 安装安全边界

安装模式会运行 `apt`、修改用户组、下载 Android SDK 文件并可能创建 AVD。只有用户
明确要求安装时才执行；执行前先列出包、下载目录、SDK 镜像和需要重新登录的事项。
不要把 sudo 密码、账号或第三方 token 写入文件或输出。

## 验证

- `pouch check android-tester` 通过。
- Debian 安装后 `kvm-ok` 和 `emulator -accel-check` 通过。
- 真机和模拟器各完成一条 readonly smoke 用例，并分别生成运行快照和成绩单。