# 应用退出

## 概述

在应用开发中，组件销毁（如UIAbility）仅销毁特定实例，其宿主进程仍常驻后台；只有当进程内所有组件均被销毁，进程才会触发销毁流程，直至应用所属的所有进程被操作系统彻底销毁、回收全部内存与线程时，应用才算真正退出。

## 应用退出机制

由于应用可能包含多个进程，每个进程中又能运行多个UIAbility组件，因此当某个进程中的最后一个UIAbility组件退出后，该进程随之退出，而当应用的最后一个进程退出时，整个应用即完成退出过程。其中UIAbility的退出机制根据触发诱因和系统处理方式的不同，主要分为正常退出与异常退出两大类。

* **正常退出**：由用户主动交互或开发者编码触发。包含开发者显式调用退出接口（如terminateSelf()）、用户点击返回键、在多任务管理界面清理卡片，以及通过Dock栏右键关闭等。在此类场景下，系统会严格遵循生命周期规范，依次触发标准的销毁回调，允许应用执行数据保存和资源释放。

* **异常退出**：由于不可控因素或系统干预导致的非预期中断。包含应用内部发生未捕获的严重崩溃（Crash）、内存泄漏，或由于违反系统管控策略被强行终止。异常退出时，系统会直接强制终止应用进程，此时往往无法保证生命周期回调的完整执行。

不同退出场景下，UIAbility的生命周期执行情况如下表所示：

|退出类型|具体触发场景|是否触发[onDestroy](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-uiability#ondestroy)|
|:-----------|:----------------------------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------|
|用户主动退出（正常退出）|用户侧滑返回或按返回键退出；用户在多任务管理界面中上滑清理单个卡片，或点击"清除全部"按钮。|是|
|应用主动退出（正常退出）|开发者显式调用terminateSelf()终止当前应用进程，常见场景包括：应用检测到致命错误，主动终止进程以避免数据损坏；完成应用内一键清理缓存等核心任务后，主动结束生命周期。|是|
|系统强制终止（异常退出）|应用进程崩溃或被系统强制终止（如jscrash、指针异常等）；系统因资源回收等原因自动清理UIAbility（如系统内存紧张、电量优化、权限变更等）。|否|

## 应用退出流程

在应用开发中，理解UIAbility组件、AbilityStage与应用进程之间的退出关系，对应用开发至关重要。组件销毁（如UIAbility）仅销毁特定实例，其宿主进程仍常驻后台。只有当进程内所有组件均被销毁，进程才会触发销毁流程。直至应用所属的所有进程被操作系统彻底销毁、回收全部内存与线程时，应用才算真正退出。

**UIAbility、AbilityStage与进程的关系**

一个应用进程可以包含多个AbilityStage，每个AbilityStage对应一个Module。一个AbilityStage下可以包含多个UIAbility。它们之间的层级关系如下：

```plaintext
应用进程
├── AbilityStage (Module A)
│   ├── UIAbility 1
│   └── UIAbility 2
├── AbilityStage (Module B)
│   └── UIAbility 3
└── ...
```

**退出流程**

应用退出时，系统按照"UIAbility -> AbilityStage -> 进程"的顺序依次销毁，具体流程如下：

1. **UIAbility销毁** ：当某个UIAbility实例被销毁时，系统依次回调[onWindowStageWillDestroy()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-uiability#onwindowstagewilldestroy12)、[onWindowStageDestroy()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-uiability#onwindowstagedestroy)，最后回调[onDestroy()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-uiability#ondestroy)生命周期。开发者可以在onDestroy()中执行该UIAbility实例的资源释放操作，如关闭网络连接、释放文件句柄等。

2. **AbilityStage销毁** ：当某个AbilityStage下所有的UIAbility对象均被销毁后，系统回调该AbilityStage的[onDestroy()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-abilitystage#ondestroy12)生命周期。开发者可以在该回调中执行Module级别的资源释放操作，如释放Module级别的缓存、关闭Module级别的数据库连接等。

3. **进程退出**：当应用进程内所有AbilityStage均被销毁后，应用进程退出，操作系统回收该进程的全部内存与线程资源。

> 说明
>
> 完整的UIAbility生命周期回调顺序，请参见[UIAbility组件生命周期](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/uiability-lifecycle)。

## 用户主动退出

### 用户通过返回退出

**场景示例** ：在手机类设备上，用户按下返回键时，系统回调UIAbility的[onBackPressed()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-uiability#onbackpressed10)回调，该回调默认返回true，系统将UIAbility置于后台而不是销毁。

**开发实现** ：开发者可以通过重写[onBackPressed()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-uiability#onbackpressed10)方法返回true来改变返回键的默认行为，例如在onBackPressed()中调用terminateSelf()，实现按下返回键时直接退出UIAbility。

**开发步骤**：

默认情况下，按下返回键会将UIAbility置于后台。如果需要按下返回键时直接退出UIAbility，可以重写onBackPressed()方法退出应用。

在UIAbility中重写onBackPressed()方法。

```TypeScript
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()](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/uiability-lifecycle#ondestroy)回调，而是直接终止进程。

## 应用主动退出

应用主动退出时，其包含的UIAbility组件也会正常退出。UIAbility正常退出是指组件在符合业务预期的情况下的退出过程。在此场景下，系统会触发onDestroy()生命周期回调，允许应用释放持有的系统资源。

**场景示例**：用户点击应用内自定义的"退出"按钮；或者由UIAbility承载的广告页面倒计时结束，需要自动关闭。

**开发实现** ：开发者可以在业务逻辑执行完毕后，通过调用[terminateSelf()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inner-application-uiabilitycontext#terminateself-1)接口主动退出当前UIAbility。

**开发步骤**：

1. 在UIAbility中获取UIAbilityContext实例。
2. 调用terminateSelf()接口退出UIAbility。

```TypeScript
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生命周期回调：

比如：系统温度过高、整机可用内存不足、应用升级等。