auto-android

UI 控件树分析

在线可视化分析 uiautomator dump 导出的 XML 控件树:截图联动点选控件,查看 resource-id、text、bounds 等属性,一键生成 XPath、UiSelector、Appium、Maestro、Auto.js 定位代码。

拖入 uiautomator dump 的 XML 文件(可同时拖入截图)

或点击选择文件 · 数据仅在浏览器本地解析,不会上传

使用步骤

  1. 1在设备上执行 adb shell uiautomator dump /sdcard/window_dump.xml,再用 adb pull /sdcard/window_dump.xml 拉取到电脑(可在「ADB 命令生成」中直接复制这条命令)。
  2. 2可选:执行 adb exec-out screencap -p > screen.png 获取同一界面的截图。
  3. 3把 XML(和截图)拖入上方区域,左侧显示截图与控件边界,右侧显示控件树。
  4. 4点击截图或控件树选中控件,查看属性,并复制自动生成的 XPath、UiSelector、Appium、Maestro、Auto.js 定位代码。

常见问题

文件会上传到服务器吗?
不会。XML 与截图都只在浏览器内存中解析和渲染,页面关闭即释放,不会发送到任何服务器。
为什么点击截图选不中想要的控件?
点击时会命中该坐标下面积最小的控件。如果命中的是子元素,可以在右侧控件树中点击其父节点;搜索框也支持按 text、resource-id、class 快速定位。
生成的 XPath 唯一吗?
生成器会优先使用 resource-id、text 等属性构造表达式,并在当前控件树中校验唯一性;若存在多个匹配,会自动追加索引。注意界面变化后表达式可能需要重新生成。
支持哪些自动化框架?
目前支持 XPath、UiAutomator UiSelector(Java)、uiautomator2(Python)、Appium(Java/Python)、Maestro YAML、Auto.js,以及 adb 坐标点击命令。