android-ui-verificationlisted

## 何时使用 适用： - 验证 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