更新记录

1.0.0（2026-09-01） 下载此版本

• 首个版本发布
• 跨 Android / iOS / HarmonyOS NEXT 三端统一退出应用 API：AppQuit.exit(options?)

平台兼容性

uni-app(4.87)

uni-app x(4.87)

AppQuit 退出应用插件

跨 Android / iOS / HarmonyOS NEXT 三端的统一退出应用 UTS 插件。不依赖宿主 uni.exit()，各端使用原生能力实现退出，在 uni-app x 与传统 uni-app（vue2/vue3）双宿主下行为一致。

安装

1. 将 uni_modules/w-app-quit 目录复制到项目根目录 uni_modules/ 下；
2. 若已发布到 DCloud 插件市场，可直接在 HBuilderX 中通过插件市场导入。

使用

import { AppQuit } from "@/uni_modules/w-app-quit"

AppQuit.exit()                          // 默认彻底退出
AppQuit.exit({ killProcess: false })    // 退到后台（进程存活）

API

AppQuit.exit(options?: AppQuitOptions): void

• options.killProcess?: boolean：true = 彻底退出（默认）；false = 退到后台、进程存活。
• 返回值：无返回值，无法判断退出是否发起成功。
• 传入 { killProcess: undefined } 或空对象等同无参，默认彻底退出。

三端行为

兼容性

• 鸿蒙 uts 编译需 HBuilderX 4.22+。
• UTSHarmony 上下文工具：uni-app x 需 HBuilderX/HarmonyOS 运行时 4.61+；传统 uni-app 鸿蒙 UTS 插件需 4.31+。
• 仅支持 HarmonyOS NEXT（API 12+）。

注意事项

• iOS App Store 审核：exit(0) 硬退出存在被审核拒绝的风险，企业内部应用不受影响；是否使用由调用方自行评估。
• Android ROM 拦截：killProcess=true 属强杀，个别 ROM 可能拦截或产生异常统计；如需更稳妥，可改用 exit({ killProcess: false }) 退到后台。

常见问题

• 调用后无法确认是否退出成功：AppQuit.exit() 无返回值，调用即发起，成功与否由各端运行时决定；请在页面存活期间调用。