完整的UIAbility生命周期回调顺序，请参见UIAbility组件生命周期。
您当前正在浏览新版开发者文档中心，目录分类和层级有所调整。点击左侧当前文档分类名称前的“☰”图标，可切换文档分类。 了解新版目录
应用退出
本文导读
概述
在应用开发中，组件销毁（如UIAbility）仅销毁特定实例，其宿主进程仍常驻后台；只有当进程内所有组件均被销毁，进程才会触发销毁流程，直至应用所属的所有进程被操作系统彻底销毁、回收全部内存与线程时，应用才算真正退出。
应用退出机制
由于应用可能包含多个进程，每个进程中又能运行多个UIAbility组件，因此当某个进程中的最后一个UIAbility组件退出后，该进程随之退出，而当应用的最后一个进程退出时，整个应用即完成退出过程。其中UIAbility的退出机制根据触发诱因和系统处理方式的不同，主要分为正常退出与异常退出两大类。
-
正常退出：由用户主动交互或开发者编码触发。包含开发者显式调用退出接口（如terminateSelf()）、用户点击返回键、在多任务管理界面清理卡片，以及通过Dock栏右键关闭等。在此类场景下，系统会严格遵循生命周期规范，依次触发标准的销毁回调，允许应用执行数据保存和资源释放。
-
异常退出：由于不可控因素或系统干预导致的非预期中断。包含应用内部发生未捕获的严重崩溃（Crash）、内存泄漏，或由于违反系统管控策略被强行终止。异常退出时，系统会直接强制终止应用进程，此时往往无法保证生命周期回调的完整执行。
不同退出场景下，UIAbility的生命周期执行情况如下表所示：
| 退出类型 | 具体触发场景 | 是否触发onDestroy |
|---|---|---|
| 用户主动退出（正常退出） | 用户侧滑返回或按返回键退出；用户在多任务管理界面中上滑清理单个卡片，或点击"清除全部"按钮。 | 是 |
| 应用主动退出（正常退出） | 开发者显式调用terminateSelf()终止当前应用进程，常见场景包括：应用检测到致命错误，主动终止进程以避免数据损坏；完成应用内一键清理缓存等核心任务后，主动结束生命周期。 | 是 |
| 系统强制终止（异常退出） | 应用进程崩溃或被系统强制终止（如jscrash、指针异常等）；系统因资源回收等原因自动清理UIAbility（如系统内存紧张、电量优化、权限变更等）。 | 否 |
应用退出流程
在应用开发中，理解UIAbility组件、AbilityStage与应用进程之间的退出关系，对应用开发至关重要。组件销毁（如UIAbility）仅销毁特定实例，其宿主进程仍常驻后台。只有当进程内所有组件均被销毁，进程才会触发销毁流程。直至应用所属的所有进程被操作系统彻底销毁、回收全部内存与线程时，应用才算真正退出。
UIAbility、AbilityStage与进程的关系
一个应用进程可以包含多个AbilityStage，每个AbilityStage对应一个Module。一个AbilityStage下可以包含多个UIAbility。它们之间的层级关系如下：
应用进程 ├── AbilityStage (Module A) │ ├── UIAbility 1 │ └── UIAbility 2 ├── AbilityStage (Module B) │ └── UIAbility 3 └── ...
退出流程
应用退出时，系统按照"UIAbility -> AbilityStage -> 进程"的顺序依次销毁，具体流程如下：
-
UIAbility销毁：当某个UIAbility实例被销毁时，系统依次回调onWindowStageWillDestroy()、onWindowStageDestroy()，最后回调onDestroy()生命周期。开发者可以在onDestroy()中执行该UIAbility实例的资源释放操作，如关闭网络连接、释放文件句柄等。
-
AbilityStage销毁：当某个AbilityStage下所有的UIAbility对象均被销毁后，系统回调该AbilityStage的onDestroy()生命周期。开发者可以在该回调中执行Module级别的资源释放操作，如释放Module级别的缓存、关闭Module级别的数据库连接等。
-
进程退出：当应用进程内所有AbilityStage均被销毁后，应用进程退出，操作系统回收该进程的全部内存与线程资源。
说明
用户主动退出
用户通过返回退出
场景示例：在手机类设备上，用户按下返回键时，系统回调UIAbility的onBackPressed()回调，该回调默认返回true，系统将UIAbility置于后台而不是销毁。
开发实现：开发者可以通过重写onBackPressed()方法返回true来改变返回键的默认行为，例如在onBackPressed()中调用terminateSelf()，实现按下返回键时直接退出UIAbility。
开发步骤：
默认情况下，按下返回键会将UIAbility置于后台。如果需要按下返回键时直接退出UIAbility，可以重写onBackPressed()方法退出应用。
在UIAbility中重写onBackPressed()方法。
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';
const DOMAIN = 0x0000;
export default class OnBackPressedAbility extends UIAbility {
// ...
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时可能不会触发onDestroy()回调，而是直接终止进程。
应用主动退出
应用主动退出时，其包含的UIAbility组件也会正常退出。UIAbility正常退出是指组件在符合业务预期的情况下的退出过程。在此场景下，系统会触发onDestroy()生命周期回调，允许应用释放持有的系统资源。
场景示例：用户点击应用内自定义的"退出"按钮；或者由UIAbility承载的广告页面倒计时结束，需要自动关闭。
开发实现：开发者可以在业务逻辑执行完毕后，通过调用terminateSelf()接口主动退出当前UIAbility。
开发步骤：
- 在UIAbility中获取UIAbilityContext实例。
- 调用terminateSelf()接口退出UIAbility。
import { AbilityConstant, ConfigurationConstant, UIAbility, Want } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';
import { window } from '@kit.ArkUI';
const DOMAIN = 0x0000;
export default class EntryAbility extends UIAbility {
// ...
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生命周期回调：
比如：系统温度过高、整机可用内存不足、应用升级等。
