# Android UI Verification

> 当需要在 Android 模拟器上自主验证 RN/原生 App 的 UI 变更、复现交互或布局 Bug、为 PR 留存截图时使用；做基于 ADB 的设备校准、UI dump 取坐标、点击/滑动/输入交互、截图与 logcat 双重验证，产出 artifacts/ 下的截图与视图快照；不适用于真机集群测试、iOS、纯单元/E2E 框架（Espresso/Detox）。触发词：adb、uiautomator、模拟器 UI 验证

- Skill: `findscripter/android-ui-verification` (Agent Skill)
- Install (CLI): `npx skillmds@latest add findscripter/android-ui-verification`
- Raw SKILL.md: https://api.skillmd.com/api/skills/findscripter/android-ui-verification/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: findscripter (https://skillmd.com/u/findscripter)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/findscripter/android-ui-verification

---

## 何时使用

适用：
- 验证 React Native 或原生 Android App 的 UI 变更是否生效。
- 自主排查布局错位、交互失效等 Bug，无需人工反复点。
- 手动测试太慢、希望脚本化跑通某条功能路径。
- 为 PR/文档自动抓取截图作为证据。

前置条件：
- Android 模拟器已启动；`adb` 已安装并在 PATH 中。
- App 以 debug 模式运行（否则 logcat 拿不到 JS 日志）。

不该用（负边界）：
- 真机/设备农场的大规模兼容性测试。
- iOS 端验证。
- 已有成熟 E2E 框架（Espresso、Detox、Maestro）的项目——优先用框架而非裸 ADB。
- 缺少必要输入、权限、安全边界或成功判据时，先停下问清楚，不要盲点。

## 步骤

### 1. 设备校准（取真实分辨率）
交互前先确认屏幕尺寸，保证点击坐标准确。布局常被缩放，以返回的物理尺寸为坐标计算基准。
```bash
adb shell wm size
```

### 2. UI 探查（发现状态）
dump 当前界面树，定位按钮/输入框的精确边界：
```bash
adb shell uiautomator dump /sdcard/view.xml && adb pull /sdcard/view.xml ./artifacts/view.xml
```
在 `view.xml` 中按 `text`、`content-desc` 或 `resource-id` 搜索元素；`bounds="[x1,y1][x2,y2]"` 即可点击区域。

### 3. 交互指令
- 点击：`adb shell input tap <x> <y>`（取元素 bounds 的中心点）。
- 滑动/滚动：`adb shell input swipe <x1> <y1> <x2> <y2> <duration_ms>`。
- 文本输入：`adb shell input text "<message>"`（特殊字符支持有限）。
- 按键事件：`adb shell input keyevent <code_id>`（如 66 = Enter）。

### 4. 验证与报告
视觉验证——交互后截图确认 UI 变化：
```bash
adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png ./artifacts/test_result.png
```
分析验证——实时查 JS 控制台日志，捕获报错或成功标记：
```bash
adb logcat -d | grep "ReactNativeJS" | tail -n 20
```
清理：所有生成文件统一放进 `artifacts/` 目录，满足项目组织规范。

## 指令

- 中心点坐标：对 `[x1,y1][x2,y2]` 取算术平均，`cx=(x1+x2)/2, cy=(y1+y2)/2`，命中最稳。
- 交互与验证之间插入 1-2 秒等待，避免动画未结束就截图/读日志。
- 在代码里打独特日志标记（如 `✅ Action Successful`），方便 `grep` 精确匹配验证结果。

## 示例

验证「点击登录按钮后出现首页」一条路径：
```bash
# 1. 校准
adb shell wm size
# 2. dump 取登录按钮 bounds，例如 [432,1200][648,1320] → 中心 (540,1260)
adb shell uiautomator dump /sdcard/view.xml && adb pull /sdcard/view.xml ./artifacts/view.xml
# 3. 点击并等待动画
adb shell input tap 540 1260
sleep 2
# 4. 截图 + 日志双重验证
adb shell screencap -p /sdcard/screen.png && adb pull /sdcard/screen.png ./artifacts/test_result.png
adb logcat -d | grep "ReactNativeJS" | tail -n 20
```

## 注意事项

- 快速失败：若 `uiautomator dump` 失败或找不到预期文本，立刻停下排查，不要凭猜测盲点坐标。
- 坐标随分辨率/缩放变化，换设备或换 emulator 配置后务必重新校准，不要复用硬编码坐标。
- `input text` 对中文及特殊字符支持有限，必要时改用粘贴或 ADB IME 方案。
- 不要把本技能输出当作环境特定校验、专家评审的替代品。

## 互见

- 研发/testing 域内其他 E2E 与回归验证技能。
- 截图/日志分析类技能可与本技能的 artifacts 产物串联。

---
采编自 sickn33/antigravity-awesome-skills（MIT License）。