安卓返回键
安卓返回键 用于在 Android 移动设备上模拟点击系统返回键，等价于用户在手机上的返回操作。它常用于返回上一级页面、关闭弹窗或退出应用等流程。
指令标识：MobilePressBack
指令类型：移动端指令
指令描述：在安卓设备上执行点击返回键操作
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。安卓返回键 在两种方式里都能用，无需配置业务参数，区别主要是你通过界面拖入节点，还是通过 Python 脚本调用。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 在需要返回的位置拖入「安卓返回键」节点即可 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobilePressBack() | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。
什么时候用？
Section titled “什么时候用？”- 在应用中返回到上一级页面，实现页面导航。
- 通过返回键关闭弹出的对话框或提示窗口。
- 在应用根页面点击返回键，退出应用。
- 在自动化测试中模拟用户的返回操作。
- 验证应用的返回逻辑是否正确、页面栈管理是否合理。
- 当前设备为 Android 设备（iOS 无物理/虚拟返回键，不支持该操作）。
- 设备已连接，且目标页面已加载完成。
- 目标页面本身支持返回操作（部分内嵌网页可能拦截返回键）。
【图片占位 | command-mobilepressback-config】
截图内容建议： 截一张可视化编排页面，画布选中「安卓返回键」节点，展示该节点位于某次页面跳转之后。
标注建议： 用 ① 标出画布中的「安卓返回键」节点，用 ② 标出运行按钮或返回后的页面状态。
用户看完应能明白： 该指令无需任何参数，放入流程即可触发一次返回操作。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：进入二级页面后返回上一级。按 3 步即可跑起来：
- 在工作流画布中添加 安卓返回键 节点，并确保 Android 设备已连接。
- 将该节点放在需要返回的位置（如进入详情页之后）。
- 点击运行，确认页面已返回到上一级。
该指令无业务输入参数，执行时直接触发一次系统返回操作。
该指令无业务输出参数，执行结果通过运行日志和页面跳转状态确认。
- 运行日志中节点为成功状态。
- 页面已返回到上一级，或弹窗/对话框被关闭。
- 后续节点针对返回后页面的操作正常执行。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
返回 code=ANDRIOD_STEPHANDLER_NULL | 在 iOS 设备上执行了该指令 | 该指令仅支持 Android 设备，请改用对应的页面返回方式 |
| 返回键无效果 | 内嵌网页拦截了返回键 | 确认页面支持返回操作，或改用其他方式返回 |
| 返回后页面未及时更新 | 页面脚本或设备性能导致延迟 | 在返回后增加等待，或等待目标元素出现 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 点击安卓返回键，返回上一级页面bots.mobilePressBack()如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：该指令支持哪些设备？
Section titled “Q1：该指令支持哪些设备？”A： 仅支持 Android 设备。iOS 设备无物理/虚拟返回键，若传入 iOS 设备将直接返回 code=ANDRIOD_STEPHANDLER_NULL。执行前需确保设备已连接且页面已加载完成。
Q2：内嵌网页如何处理？
Section titled “Q2：内嵌网页如何处理？”A： 某些应用的内嵌网页可能会阻止返回键的正常功能，请确认目标页面本身支持返回操作，建议先验证页面类型再执行。
Q3：返回键操作有延迟怎么办？
Section titled “Q3：返回键操作有延迟怎么办？”A： 返回键操作可能受页面脚本或设备性能影响，建议适当等待页面响应。可使用 延迟 指令或等待元素出现来确保页面已完成跳转。