获取当前应用信息
获取当前应用信息 用于读取当前运行的移动应用信息（如包名、版本等）。它常用于确认目标应用是否处于前台、记录被测应用版本，或根据应用信息做后续分支判断，结果通过输出变量保存后供后续节点引用。
指令标识：MobileGetAppInfo
指令类型：手机指令
指令描述：获取当前运行的移动应用信息
先选使用方式
Section titled “先选使用方式”工作流支持「可视化编排」和「代码编排」两种创建方式。获取当前应用信息 在两种方式里都能用，核心业务参数一致，区别主要是你通过界面配置，还是通过 Python 脚本配置。
| 方式 | 怎么用 | 适合人群 |
|---|---|---|
| 可视化编排（推荐先学） | 拖入「获取当前应用信息」节点，配置「将结果保存至」 | 大多数用户，零代码，适合快速搭建和调试 |
| 代码编排（Python） | 在脚本中调用 bots.mobileGetAppInfo(outKey="appInfo") | 熟悉代码、需要复用脚本或批量生成流程的用户 |
第一次使用建议先用可视化编排跑通，再迁移到 Python 代码编排。下方「参数说明」同时给出界面字段和代码参数名，方便两种方式对应。
什么时候用？
Section titled “什么时候用？”- 需要确认当前前台应用是否为目标应用。
- 在自动化测试报告中记录被测应用的包名与版本信息。
- 根据应用信息执行差异化的后续操作。
- 当前流程已经连接并占用了一台可用的手机设备。
- 目标应用已经启动并处于可识别状态。
- 已规划好用于保存结果的输出变量名，便于后续节点引用。
可视化编排：从 0 到跑通
Section titled “可视化编排：从 0 到跑通”下面用一个常见场景演示：启动应用后确认前台应用并记录其信息。按 3 步即可跑起来：
- 在工作流画布中添加 获取当前应用信息 指令，通常放在 打开应用 之后。
- 在右侧配置面板的 将结果保存至 中填写一个变量名，例如
appInfo。 - 点击运行，确认运行日志中输出了应用信息，再在后续节点中引用该变量。
【图片占位 | command-mobilegetappinfo-config】
截图内容建议： 截一张可视化编排页面，画布选中「获取当前应用信息」节点，右侧属性面板展示「将结果保存至」区域。
标注建议： 用 ① 标出画布中的节点，用 ② 标出「将结果保存至」输入框，用 ③ 标出运行按钮或成功状态。
用户看完应能明白： 这个指令不需要输入参数，核心是配置一个输出变量来接收当前前台应用信息。
该指令无业务输入参数，仅依赖已连接的设备上下文，默认读取当前前台运行的应用信息。
| 界面名称 | 代码属性名 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| 将结果保存至 | outKey | JSON | 否 | 保存获取到的应用信息。后续节点通过该变量名引用结果。 |
获取当前应用信息节点运行结束后状态为成功。- 运行日志中没有参数缺失、超时或执行失败等错误。
- 如果配置了输出变量，后续节点能够读取到符合预期的结果。
- 后续节点能够继续执行，流程没有因为该节点异常中断。
| 现象 / 报错原文 | 可能原因 | 处理建议 |
|---|---|---|
日志报 Mobile device not configured | 流程未连接设备 | 先执行连接/占用设备节点，或在全局变量中配置设备上下文 |
日志报 Mobile API ... business error | 移动端服务异常或设备失联 | 检查设备在线状态与移动端服务连通性，重连设备后重试 |
| 获取到的应用不是预期应用 | 目标应用未在前台 | 先用 打开应用 启动并切到目标应用，再获取信息 |
| 输出变量为空 | 未配置「将结果保存至」 | 检查是否填写了 outKey，并确认后续引用的变量名一致 |
Python 代码编排
Section titled “Python 代码编排”代码编排以 Python 为主。运行上下文由代码编排模板创建，示例里只需要关注业务指令本身。
# 获取当前前台应用信息并保存到变量 appInfobots.mobileGetAppInfo(outKey="appInfo")可视化表单里的「将结果保存至」对应代码里的 outKey。
如果你想在工作流中通过节点动态编排指令，可使用 执行指令（XML）节点。
Q1：获取到的是哪个应用的信息？
Section titled “Q1：获取到的是哪个应用的信息？”A： 获取的是当前前台运行的应用信息。建议在启动目标应用后再调用，确保拿到预期应用。
Q2：返回信息包含哪些字段？
Section titled “Q2：返回信息包含哪些字段？”A： 通常包含应用包名等基础信息，具体字段随平台和应用而不同。建议先保存到变量后查看实际内容再做引用。