应用退出
概述
开发应用时,应用退出指操作系统彻底销毁应用的进程,回收所有内存与线程。组件退出仅销毁特定组件实例(如UIAbility),但其宿主进程依然在后台存活。
只有当进程中所有的应用组件都销毁,进程进入销毁流程。当应用中的所有进程都销毁,则应用退出。
应用退出机制
由于应用可能包含多个进程,每个进程中又能运行多个UIAbility组件,因此当某个进程中的最后一个UIAbility组件退出后,该进程随之退出,而当应用的最后一个进程退出时,整个应用即完成退出过程。其中UIAbility的退出机制根据触发诱因和系统处理方式的不同,主要分为正常退出与异常退出两大类。
-
正常退出:由用户主动交互或开发者编码触发。包含开发者显式调用退出接口(如terminateSelf())、用户点击返回键、在多任务管理界面清理卡片,以及通过Dock栏右键关闭等。在此类场景下,系统会严格遵循生命周期规范,依次触发标准的销毁回调,允许应用执行数据保存和资源释放。
-
异常退出:由于不可控因素或系统干预导致的非预期中断。包含应用内部发生未捕获的严重崩溃(Crash)、内存泄漏,或由于违反系统管控策略被强行终止。异常退出时,系统会直接强制终止应用进程,此时往往无法保证生命周期回调的完整执行。
不同退出场景下,UIAbility的生命周期执行情况如下表所示:
| 退出类型 | 具体触发场景 | 是否触发onDestroy |
|---|---|---|
| 用户主动退出 | 用户侧滑返回或按返回键退出;用户在多任务管理界面中上滑清理单个卡片,或点击"清除全部"按钮。 | 是 |
| 应用主动退出 | 开发者显式调用terminateSelf()终止当前应用进程,常见场景包括:应用检测到致命错误,主动终止进程以避免数据损坏;完成应用内一键清理缓存等核心任务后,主动结束生命周期。 | 是 |
| 系统强制终止 | 应用进程崩溃或被系统强制终止(如jscrash、指针异常等);系统因资源回收等原因自动清理UIAbility(如系统内存紧张、电量优化、权限变更等)。 | 否 |
用户主动退出
用户通过返回退出
场景示例:在手机类设备上,用户按下返回键时,系统回调UIAbility的onBackPressed()回调,该回调默认返回true,系统将UIAbility置于后台而不是销毁。
开发实现:开发者可以通过重写onBackPressed()方法返回true来改变返回键的默认行为,例如在onBackPressed()中调用terminateSelf(),实现按下返回键时直接退出UIAbility。
开发步骤:
默认情况下,按下返回键会将UIAbility置于后台。如果需要按下返回键时直接退出UIAbility,可以重写onBackPressed()方法退出应用。
在UIAbility中重写onBackPressed()方法。
const DOMAIN = 0x0000;
// ...
onBackPressed() {
// 调用terminateSelf退出UIAbility
this.context.terminateSelf().then(() => {
console.info('Succeeded in terminating self.');
}).catch((err: BusinessError) => {
console.error(`Failed to terminate self. Code is ${err.code}, message is ${err.message}`);
});
// 返回true表示消费该事件,不再进行默认处理
return true;
}
}
用户主动清理UIAbility
用户可以通过各种方式主动退出UIAbility:
- 单任务清理:上滑清理单个任务卡片,对应的UIAbility实例会退出并执行onDestroy生命周期回调。
- 一键清理:点击"一键清理"按钮,批量清除所有任务卡片,所有UIAbility实例都会退出并执行onDestroy生命周期回调。
- Dock栏退出:在PC/2in1或Tablet设备上,用户通过Dock栏退出,UIAbility的onDestroy不保证回调。
应用主动退出
应用主动退出时,其包含的UIAbility组件也会正常退出。UIAbility正常退出是指组件在符合业务预期的情况下的退出过程。在此场景下,系统会触发onDestroy()生命周期回调,允许应用释放持有的系统资源。
场景示例:用户点击应用内自定义的"退出"按钮;或者由UIAbility承载的广告页面倒计时结束,需要自动关闭。
开发实现:开发者可以在业务逻辑执行完毕后,通过调用terminateSelf()接口主动退出当前UIAbility。
开发步骤:
- 在UIAbility中获取UIAbilityContext实例。
- 调用terminateSelf()接口退出UIAbility。
const DOMAIN = 0x0000;
// ...
onForeground(): void {
// Ability has brought to foreground
hilog.info(DOMAIN, 'testTag', '%{public}s', 'Ability onForeground');
// 获取UIAbilityContext
let context = this.context;
setTimeout(() => {
context.terminateSelf().then(() => {
console.info('Succeeded in terminating self.');
}).catch((err: BusinessError) => {
console.error(`Failed to terminate self. Code is ${err.code}, message is ${err.message}`);
});
}, 2000);
}
// ...
}
系统强制终止
应用异常
当应用出现异常情况时,例如JavaScript崩溃、空指针异常等,应用直接崩溃退出。这种情况下不会执行onDestroy生命周期回调。
系统清理
系统在某些场景下会强制清理应用进程,不会执行onDestroy生命周期回调:
比如:系统温度过高、整机可用内存不足、应用升级等。
本文来自 OpenHarmony 文档贡献者,按 CC BY 4.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。
