关闭应用

关闭应用 用于在移动设备上强制关闭指定的应用程序（终止其进程）。它支持在 Android、iOS 和 Harmony 设备上执行，常用于自动化测试中重置应用状态、验证冷启动或清理环境。

指令标识：MobileCloseApplication
指令类型：移动端指令
指令描述：在移动设备上强制关闭指定应用程序

先选使用方式

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

方式	怎么用	适合人群
可视化编排（推荐先学）	拖入「关闭应用」节点，在右侧表单从应用列表中选择目标应用	大多数用户，零代码，适合快速搭建和调试
代码编排（Python）	在脚本中调用 `bots.mobileCloseApplication(appPackage="...")`	熟悉代码、需要复用脚本或批量生成流程的用户

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

什么时候用？

测试前关闭应用，清除运行状态，确保每次测试从干净状态开始。
关闭应用后重新启动，验证冷启动性能和行为。
自动化测试完成后关闭应用，释放系统资源。
应用异常或卡死时，强制终止应用进程。
多应用测试场景中，关闭当前应用后切换到其他应用。

使用前确认

移动设备已连接，且目标应用已安装。
已从平台预置的应用列表中选定要关闭的目标应用。
Harmony 设备需开启 hdc debug 模式并完成授权，才能成功结束进程。

【图片占位 | command-mobilecloseapplication-config】
截图内容建议： 截一张可视化编排页面，画布选中「关闭应用」节点，右侧属性面板展示「应用包名」下拉选择区。
标注建议： 用 ① 标出画布中的节点，用 ② 标出应用包名下拉框，用 ③ 标出运行按钮或成功状态。
用户看完应能明白： 该指令主要从应用列表中选择目标应用即可执行关闭。

可视化编排：从 0 到跑通

下面用一个常见场景演示：测试前关闭目标应用以重置状态。按 3 步即可跑起来：

在工作流画布中添加 关闭应用 节点，并确保设备已连接。
在 应用包名 下拉框中从平台预置的应用列表里选择要关闭的目标应用。
点击运行，确认目标应用进程已被关闭。

参数说明

输入参数

界面名称	代码属性名	类型	必填	默认值	说明
应用包名	`appPackage`	Enum	是	-	目标应用，从平台预置的应用列表中选择，用于定位需要终止的应用（对应 Android 包名或 iOS/Harmony BundleId）。具体可选项以平台界面下拉列表为准。

输出参数

该指令无业务输出参数，执行结果通过运行日志和设备应用状态确认。

成功标准

运行日志中节点为成功状态。
设备上目标应用的进程已被关闭。
后续若重新启动该应用，可观察到冷启动效果。

失败排查

现象 / 报错原文	可能原因	处理建议
返回 `APP_NOT_EXIT_ERROR`	目标应用未安装或未运行	可忽略该提示，或根据返回码做分支处理
Android 端未完全清理	仅强制停止，缓存未清	必要时在停止后再清理应用数据
Harmony 端无法结束进程	未开启调试模式或未授权	开启 `hdc debug` 模式并完成授权后重试
设备无响应	设备未连接或连接中断	检查设备连接状态后重试

Python 代码编排

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

# 关闭目标应用（appPackage 取值与可视化下拉列表中的预置应用一致）
bots.mobileCloseApplication(appPackage="TARGET_APP")

可视化表单里的「应用包名」对应代码里的 appPackage，取值需与平台预置应用列表保持一致。

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

常见问题

Q1：如果目标应用未安装会怎样？

A：如果目标应用未安装或未运行，关闭操作会返回 APP_NOT_EXIT_ERROR，可忽略或根据返回码处理。

Q2：Android 端如何强制停止应用？

A： Android 端通过系统的强制停止能力终止应用运行。部分系统可能需要进一步清理应用数据才能完全清缓存。

Q3：关闭应用会丢失数据吗？

A：关闭应用会丢失当前应用状态和未保存的数据。Harmony 设备需开启 hdc debug 模式并授权才能成功结束进程。