确定 XPath 和坐标的指南

使用 GPM UI Automator 工具获取手机屏幕上元素的 XPath 或坐标。

在 Phone - Action 和 Phone - Element 组中的许多 action 需要通过 XPath 或 坐标 指向手机屏幕上的一个元素。您可以使用 GPM UI Automator（Find XPath on BoxPhone）来获取这些值。

执行步骤：

1. 在 DEVICE 框中选择设备（例如 SM G960F）。如果未看到设备，请点击 Devices 刷新列表。
2. 打开手机上需要操作的正确屏幕，然后点击 Capture 以捕捉并重建界面树。可以查看树形结构（UI tree）或代码（XML），通过文本 / id / class 过滤快速查找。
3. 点击需要获取的元素——在树中或左侧的屏幕截图上。所选元素将高亮显示，并在右侧的 SELECTED ELEMENT 框中显示信息。

获取 XPath：

SUGGESTED XPATH 框中建议了多种类型的 XPath，并附有指示准确度的标签：

• UNIQUE: 仅匹配一个元素——应优先使用以确保稳定运行。
• n matches: 匹配多个元素，使用前需谨慎考虑。

建议的类型包括：CONTENT-DESC、DESC + CLASS、ABSOLUTE、CLASS、BY PARENT ID。点击 "click to copy" 复制 XPath，然后粘贴到 action 的 XPath 框中。可以通过 TEST XPATH 框进行检查，然后点击 Run。

获取坐标：

ATTRIBUTES 框显示元素的属性，其中 bounds 是坐标框的形式为 [x1,y1][x2,y2]。元素的中心坐标是该框的中点。点击 Test tap 尝试点击元素以进行检查。