3步抓取Android界面布局：AYA布局检查器与XPath定位快速上手

3步抓取Android界面布局：AYA布局检查器与XPath定位快速上手

【免费下载链接】ayaAndroid ADB desktop app项目地址: https://gitcode.com/gh_mirrors/aya/aya

AYA是一款Android ADB桌面工具，它的布局检查器能一键抓取连接设备的界面层级结构，用树状视图展示每个控件，并为选中元素生成 XPath 定位路径，适合做界面调试的开发者与测试人员。

先花30秒看懂布局检查器

• 它帮你省掉手动执行uiautomator dump的麻烦，一键拉取当前屏幕的 XML 层级。
• 它把界面变成一棵树，View 套了几层、尺寸多大、文案是什么，一眼看清。
• 它给每个元素发"门牌号"，选中任意节点就能复制 XPath 定位符，自动化脚本直接用。

三步完成界面层级抓取

第1步：连接设备。打开 AYA，插上手机或启动模拟器，授权 ADB 调试。设备列表出现该设备后选中它。

第2步：进入布局页并刷新。切到 Layout 标签页，点工具栏的刷新按钮。AYA 会先截一张屏，再从设备拉取界面层级 XML，两者同时渲染到页面上。

第3步：点选节点看结果。页面分三栏：左侧元素树、中间截图（选中元素会画出边框）、右侧元素详情。树底部实时显示 XPath，点复制按钮即可拿走；工具栏还能把完整 XML 存成window_hierarchy.xml或整段复制。

原理一瞥：uiautomator 抓取与树形转换

底层的做法并不神秘：AYA 在设备上跑一条uiautomator dump命令，和你自己在终端敲的完全一样：

adb shell uiautomator dump /data/local/tmp/aya_uidump.xml

区别在于，AYA 会把拉回来的 XML 解析成树，再做两件事：把class属性变成节点标签，让你直接看到LinearLayout、TextView这些真实类名；把bounds坐标换算成x / y / width / height，并且默认只保留关键属性，树不会一团乱码。

XPath 你可以理解成"给每个界面元素发门牌号"：从根节点出发，一层层写清楚"第几个孩子"，比如/LinearLayout[2]/TextView[1]。AYA 还会把定位符里的@id=自动换成 Android 原生的@resource-id=写法，一行代码完成整个转换。

三个高频场景与坑点

确认控件是否真的在界面上

自动化脚本报"找不到元素"时，不一定是脚本的锅。先抓一次层级，搜一下对应的resource-id：树里根本没有，说明控件可能在 WebView 里或者还没加载出来。uiautomator dump抓不到 WebView 内部内容，这时要换别的排查思路。

给自动化脚本写定位符

写 UI 自动化时优先用resource-id，它稳定且唯一；XPath 兜底。AYA 树底部生成的 XPath 可以直接复制使用，比手动数层级快得多，也不容易数错。

抓取时的三个高频坑

• 层级是快照。界面一旦刷新、弹层出现，旧数据就失效了，操作前先点刷新拿最新状态。
• 属性开关别常开。复杂界面下打开"显示属性"会让树明显变啰嗦，默认精简模式更好读，需要核对时再打开。
• 重复节点靠序号区分。同类控件出现两次时，XPath 会带[2]、[3]这类后缀，界面一变序号就可能漂移，脚本里尽量优先用resource-id。

AYA 把"连设备、抓层级、读树、拿定位符"压缩成几次点击，想看实现细节可以翻一翻 布局组件源码 和 ADB 命令源码。

【免费下载链接】ayaAndroid ADB desktop app项目地址: https://gitcode.com/gh_mirrors/aya/aya