大网数据广告活动
OpenHarmony 设备与应用开发

应用退出

· 52CE 我爱测

开发应用时,应用退出指操作系统彻底销毁应用的进程,回收所有内存与线程。组件退出仅销毁特定组件实例(如UIAbility),但其宿主进程依然在后台存活。

应用退出

概述

开发应用时,应用退出指操作系统彻底销毁应用的进程,回收所有内存与线程。组件退出仅销毁特定组件实例(如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。

开发步骤:

  1. 在UIAbility中获取UIAbilityContext实例。
  2. 调用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 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
OpenHarmony 文档贡献者
适用范围
master 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。