52 lines
1.9 KiB
Markdown
52 lines
1.9 KiB
Markdown
# android-tester
|
|
|
|
在 Android 真机或 Debian Linux Android 模拟器上执行测试；每次先检查环境，最后生成可追溯的测试结果。
|
|
|
|
## 什么时候使用
|
|
|
|
- 「检查 Android 真机测试环境」
|
|
- 「检查 Debian Android 模拟器环境」
|
|
- 「用真机跑 Android smoke」
|
|
- 「用 AVD 跑 Android full」
|
|
- 「安装 Debian 上的 Android 模拟器」
|
|
- 「查看本次 Android 测试结果」
|
|
|
|
## 使用前准备
|
|
|
|
- 项目已有 `.pouch/tester/` 和测试用例。
|
|
- 真机：开启 USB 调试并在设备上授权当前电脑。
|
|
- 模拟器：准备支持虚拟化的 Debian amd64 主机；首次使用可让 skill 安装 KVM、SDK
|
|
Command-line Tools、Platform-Tools、Emulator 和指定系统镜像。
|
|
- 需要安装或启动应用时，提供 APK、包名和启动组件，或提供项目自己的测试命令。
|
|
- 安装模式会使用 sudo、apt 和用户组变更；运行前会先展示变更范围。
|
|
|
|
## 使用示例
|
|
|
|
```text
|
|
检查 Android 真机环境，然后跑 smoke 测试
|
|
```
|
|
|
|
```text
|
|
在 Debian 上安装 Android 模拟器，使用项目需要的 Android API 创建 AVD
|
|
```
|
|
|
|
```text
|
|
用 Pixel_API_35 模拟器跑 Android full，失败时保留 logcat 和截图
|
|
```
|
|
|
|
## Agent 会做什么
|
|
|
|
1. 明确选择真机或模拟器，不在两者之间自动切换。
|
|
2. 先检查 ADB、KVM、AVD、设备授权、启动状态和项目测试配置。
|
|
3. 模拟器路径可在 Debian amd64 上安装主机依赖和 Android SDK 模拟器组件。
|
|
4. 执行 `.pouch/tester/` 中命中的 Android 用例。
|
|
5. 生成 YAML 运行快照、CSV 成绩单，失败时附带 logcat 和截图。
|
|
|
|
安装、安装 APK、清数据和修改设备设置都属于有副作用的操作，必须得到明确授权。
|
|
|
|
## 如何判断完成
|
|
|
|
- 环境检查有明确的通过项和阻塞项。
|
|
- 每条用例都有 `pass`、`fail`、`environment-fail`、`skipped` 或 `not-run` 结果。
|
|
- 运行记录位于 `.pouch/tester/runs/`，且 YAML 与 CSV 的 run id 一致。
|