跳到主要内容

文本元素抓取器

文本元素抓取器用于从设备当前画面中抓取可被系统识别的文本、按钮、输入框和其它界面元素。它适合生成点击、输入、滚动和判断页面是否出现某段文字的脚本代码。

打开方式

  • 打开 样本工作台,切换到顶部的 文本元素 页。
  • 在设备列表中右键目标设备,选择 文本元素抓取。这样会直接打开文本元素页,并带入该设备。

抓取当前页面

抓取前,先让设备停在要分析的 App 页面。可以通过远控面板操作设备,也可以直接在设备上切到目标页面。设备需要在线,并支持文本元素抓取。

  1. 点击面板右上角 设置
  2. 元素抓取设备 中点击 选择设备。如果已经设置开发测试设备,也可以选择 当前开发测试设备
  3. 点击 抓取文本元素
  4. 抓取完成后,左侧会显示截图和元素框,右侧会显示层级概览和元素详情。
  5. 在截图或层级树上移动鼠标查看元素范围,点击后固定选择。
  6. 在元素详情中选择动作并点击 复制代码

抓取结果会以标签形式保留。多次抓取不同画面时,可以在结果标签之间切换、拖动排序或关闭旧结果。

选择生成动作

常见选择:

  • 要点击按钮,选择 点击
  • 要判断页面是否出现某段文字,选择 判断存在
  • 要给输入框输入内容,选择 插入文本设置文本
  • 要清空输入框,选择 清空文本
  • 要翻动列表或页面,选择 滚动
  • 只是想先找到元素,选择 查找

普通脚本优先使用 复制代码。如果想自己组合条件,可以用 复制匹配字段复制 JSON 更适合排查问题或反馈给维护者,不建议作为日常写脚本的首选。

如果同一个元素要连续做多步操作,可以把生成方式切到 复用元素引用;只做一次点击或判断时,保持默认即可。

点不到或抓不到时

  • 抓取失败:点击 重试,并确认设备在线、当前页面没有频繁切换。
  • 结果为空:确认页面上确实有系统可识别的文本或控件;如果没有,可以改用 取色器 的坐标和颜色方案。
  • 元素框位置不准或生成的点击点不到:重新抓取当前页面,再在设置中调整 Hit 网格;必要时开启 强制命中 后重新抓取。
  • 提示当前设备不支持文本元素抓取:换用支持该能力的设备,或改用取色器完成定位。