点击

点击用于在移动设备上点击指定的页面元素。你可以通过元素选择器定位目标元素并执行点击，支持 Android、iOS 和 Harmony 设备，适用于按钮点击、链接跳转、菜单选择等各类 UI 交互场景。

指令标识：MobileTap
指令类型：移动端指令
指令描述：在移动设备上点击指定页面元素

先选使用方式

工作流支持「可视化编排」和「代码编排」两种创建方式。点击在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「点击」节点，捕获或填写元素选择器，按需设置超时时间	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileTap(selector="//*[@text='登录']")`	熟悉代码、需要复用脚本或批量生成流程的用户

第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。

什么时候用？

点击登录、提交、确认等各类按钮元素。
点击链接或导航元素，实现页面间跳转。
点击菜单项，展开或选择特定菜单选项。
在列表中点击特定列表项，查看详情或执行操作。
点击元素触发特定的交互事件或业务逻辑。

使用前确认

移动设备已连接，且目标页面已加载完成。
目标元素已出现，必要时先使用验证元素存在确认。
已准备好稳定的元素选择器（XPath、ID、text 等）。

【图片占位 | command-mobiletap-config】
截图内容建议： 截一张可视化编排页面，画布选中「点击」节点，右侧属性面板展示「元素选择器」「超时时间」配置区。
标注建议： 用 ① 标出画布中的节点，用 ② 标出元素选择器输入框，用 ③ 标出超时时间，用 ④ 标出运行按钮。
用户看完应能明白： 该指令主要需要指定要点击的元素，超时时间为按需高级项。

可视化编排：从 0 到跑通

下面用一个常见场景演示：点击页面上的「登录」按钮。按 3 步即可跑起来：

在工作流画布中添加点击节点，并确保设备已连接、目标页面已加载。
在 元素选择器 中填写或捕获目标元素，例如：

//*[@text='登录']

点击运行，确认目标元素被点击并触发了预期跳转或交互。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
元素选择器	`selector`	String	是	-	选择要点击的页面 UI 元素，可直接填写 `xpath`/`元素prompt`，或从元素库选择 `元素id`。
超时时间	`timeout`	Integer	否	`10000`	高级参数，查找元素的超时退出时间，单位毫秒（`ms`）。

输出参数

该指令无业务输出参数，执行结果通过运行日志和页面交互效果确认。

该指令为元素定位类操作，节点失败处理默认为「报错中止（STOP_ON_FAILURE）」：在超时时间内未找到元素时会抛出异常并中断流程。

成功标准

运行日志中节点为成功状态。
目标元素被成功点击，并触发了预期的跳转或交互效果。
后续节点针对点击后页面的操作正常执行。

失败排查

现象 / 报错原文	可能原因	处理建议
超时未找到元素，抛出异常	元素未渲染或选择器不准确	适当增大「超时时间」，或先用「验证元素存在」确认元素已加载
点击无效果	点中了不可交互区域	使用更精确的选择器定位可点击元素
定位不稳定	选择器依赖了易变属性	改用稳定的属性（如固定 `text`、`resource-id`）进行定位

Python 代码编排

代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。

# 点击文本为「登录」的元素
bots.mobileTap(
    selector="//*[@text='登录']",
    timeout=10000,
)

可视化表单里的「元素选择器」「超时时间」分别对应代码里的 selector、timeout。

如果你想在工作流中通过节点动态编排指令，可使用执行指令（XML）节点。

常见问题

Q1：元素选择器支持哪些定位方式？

A：支持 XPATH、ID、CLASS_NAME、TEXT、IMAGE、COORDINATE 等多种定位方式，移动端不支持 CSS选择器。定位器会按优先级尝试，找到第一个可用的即返回。

Q2：如何提高元素定位的成功率？

A：建议配合 timeout 参数，避免因元素未渲染而失败。可直接填写 xpath/元素prompt 或从元素库选择 元素id，并尽量使用稳定的属性定位。

Q3：动态加载的页面如何处理？

A：在动态加载的页面中，建议适当增加超时时间以确保元素完全加载，也可先使用验证元素存在确认元素已加载。

Q4：如果元素不存在会怎样？

A：如果在超时时间内未找到元素，指令会抛出异常并中断流程。建议在点击前先验证元素存在，或设置合适的超时时间。

点击