跳转到scheme页面
跳转到scheme页面 用于在移动设备上通过自定义的 Scheme 协议打开应用内指定页面。它常用于深度链接、应用间跳转、第三方调用等场景，让流程直接进入目标页面。
指令标识：NavigateToScheme
指令类型：移动端指令
指令描述：跳转到APP的指定scheme页面
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。跳转到scheme页面 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「跳转到scheme页面」节点，在右侧表单填写 Scheme 地址 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.navigateToScheme(url="iexample://example.com/home") | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。
什么时候用？
Section titled “什么时候用？”- 在应用内通过 Scheme 协议快速跳转到指定页面，无需手动逐级导航。
- 测试应用的深度链接功能，验证 Scheme 协议是否正确配置。
- 从一个应用跳转到另一个应用的指定页面。
- 直接跳转到特定页面进行自动化测试，提高测试效率。
- 验证营销活动链接是否能正确跳转到目标页面。
- 移动设备已连接，目标应用已启动（可先用 打开应用）。
- 目标应用支持要跳转的 Scheme 协议，且格式正确（
scheme://host/path?params）。 - iOS 需在
Info.plist配置URL Scheme；Android 12+ 需在清单中声明Scheme。
【图片占位 | command-navigatetoscheme-config】
截图内容建议： 截一张可视化编排页面，画布选中「跳转到scheme页面」节点，右侧属性面板展示「app中的url链接」输入区。
标注建议： 用 ① 标出画布中的节点，用 ② 标出 Scheme 地址输入框，用 ③ 标出运行按钮或跳转后的页面状态。
用户看完应能明白： 该指令主要只需要填写一个有效的 Scheme 地址即可跳转。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：通过 Scheme 直接进入应用首页。按 3 步即可跑起来：
- 先用 打开应用 启动目标应用。
- 在工作流画布中添加 跳转到scheme页面 节点，在 app中的url链接 填写 Scheme 地址：
iexample://example.com/home- 点击运行，确认应用跳转到了对应页面。
| 界面名称 | 代码属性名 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|---|
| app中的url链接 | url | String | 是 | - | 要跳转的 Scheme URL 地址，格式为 scheme://host/path?params，不能为空。 |
该指令无业务输出参数，执行结果通过运行日志和页面跳转状态确认。
- 运行日志中节点为成功状态。
- 应用跳转到 Scheme 对应的目标页面。
- 后续节点针对跳转后页面的操作正常执行。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
| 跳转无效果 | 目标应用未启动 | 先用「打开应用」启动目标应用再跳转 |
| 跳转失败 | Scheme 格式错误或应用不支持 | 确认目标应用支持的 Scheme 格式（scheme://host/path?params） |
| Android 12+ 跳转失败 | 清单未声明 Scheme | 在 AndroidManifest.xml 中声明对应 Scheme 后重试 |
| 跳转后页面未加载完成 | 页面加载需要时间 | 跳转后配合等待指令再继续操作 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 通过 Scheme 协议打开应用内指定页面bots.navigateToScheme(url="iexample://example.com/home")可视化表单里的「app中的url链接」对应代码里的 url。
如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：Scheme URL 格式有什么要求？
Section titled “Q1：Scheme URL 格式有什么要求？”A： url 必须使用有效的 Scheme 协议格式（eg：scheme://host/path?params）。不同应用的 Scheme 协议可能不同，使用前需确认目标应用支持的格式。
Q2：跳转前需要先启动应用吗？
Section titled “Q2：跳转前需要先启动应用吗？”A： 建议在跳转前确保目标应用已启动，否则可能跳转失败。可先使用 打开应用 启动应用。
Q3：iOS 和 Android 配置有什么区别？
Section titled “Q3：iOS 和 Android 配置有什么区别？”A： iOS 需在 Info.plist 中配置 URL Scheme；Android 需在 AndroidManifest.xml 中配置 Intent Filter，且 Android 12+ 需在清单中声明 Scheme，未声明时跳转会失败。
Q4：跳转后页面加载需要等待吗？
Section titled “Q4：跳转后页面加载需要等待吗？”A： 跳转后页面加载可能需要时间，建议配合等待指令使用。Harmony 使用 hdc aa Start 调用，需要 ability 已注册。