UIAbility生命周期UIAbility的生命周期包括 Create、 Foreground、 Background

当用户打开、切换和返回到应用时，UIAbility实例会在其生命周期的不同状态之间转换。UIAbility类提供了一系列回调，通过这些回调可以知道当前UIAbility实例的某个状态发生改变，UIAbility实例的创建和销毁，或者UIAbility实例发生了前后台的状态切换。

UIAbility的生命周期包括 Create、 Foreground、 Background、 Destroy四个状态,具体如下图所示：

1、Create状态

在应用首次创建UIAbility实例时触发，此时系统会调用onCreate()函数回调。可以在该回调中进行应用初始化操作，例如变量定义资源加载等，用于后续的UI界面展示。

// EntryAbility.ts
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
...

export default class EntryAbility extends UIAbility {
  ...
  onCreate(want, launchParam) {
    // 初始化应用
    ...
  }
  ...
}

WindowStageCreate和WindowStageDestory状态

UIAbility实例创建完成之后，在进入Foreground状态之前，系统会创建一个WindowStage。WindowStage创建完成后会进入onWindowStageCreate()回调，可以在该回调中设置UI界面加载、设置WindowStage的事件订阅。具体的关系图如下：

onWindowStageCreate()

在onWindowStageCreate()回调中通过loadContent()方法设置应用要加载的页面，并根据需要调用on('windowStageEvent')方法订阅WindowStage的事件（获焦/失焦、可见/不可见）。

// EntryAbility.ts
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
...

export default class EntryAbility extends UIAbility {
  ...
  windowStageEventFunc: (data: window.WindowStageEventType) => void = (data: window.WindowStageEventType): void => {
    hilog.info(
      this.domain,
      'Succeeded in enabling the listener for window stage event changes. Data: %{public}',
      JSON.stringify(data) ?? ''
    );
  }
  ...
  onWindowStageCreate(windowStage: window.WindowStage) {
    // 设置WindowStage事件订阅（获取/失焦、可见/不可见）
    try {
      windowStage.on('windowStageEvent', this.windowStageEventFunc);
    } catch (exception) {
      hilog.error(
        this.domain,
        'Failed to enable the listener for window stage event changes. Cause: %{public}',
        JSON.stringify(exception) ?? ''
      );
    }
    // 设置UI加载
    windowStage.loadContent('pages/LifeCyclePage', (err, data) => {
      ...
    });
  }
  ...
}

2、Foreground状态

(1)、Foreground 状态是在UIAbility实例切换至前台时触发对应于onForeground()回调。

(2)、onForeground()回调，在UIAbility的UI界面可见之前，如UIAbility切换至前台时触发。可以在onForeground()回调中申请系统需要的资源，或者重新申请在onBackground()中释放的资源。

场景: 应用在使用过程中需要使用用户定位时，假设应用已获得用户的定位权限授权。在UI界面显示之前，可以在onForeground()回调中开启定位功能，从而获取到当前的位置信息。

// EntryAbility.ts
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
...

export default class EntryAbility extends UIAbility {
 ...
 onForeground() {
   // 申请系统所需的资源或在onBackground中申请释放的资源
   ...
 }
}

3、Background状态

(1)、Background状态分别在UIAbility实例切换至后台时触发，对应于onBackground()回调。

（2）、onBackground()回调，在UIAbility的UI界面完全不可见之后，如UIAbility切换至后台时候触发。可以在onBackground()回调中释放UI界面不可见时无用的资源，或者在此回调中执行较为耗时的操作，例如状态保存等。

场景: 当应用切换到后台状态，可以在onBackground()回调中停止定位功能，以节省系统的资源消耗。

// EntryAbility.ts
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
...

export default class EntryAbility extends UIAbility {
  
  onBackground() {
    // UI不可见时释放无用资源，或在此回调中执行耗时操作
    // 例如，状态保存
    ...
  }
}

4、Destory状态

Destroy状态在UIAbility实例销毁时触发。可以在onDestroy()回调中进行系统资源的释放、数据的保存等操作。

场景:调用terminateSelf()方法停止当前UIAbility实例，从而完成UIAbility实例的销毁；或者用户使用最近任务列表关闭该UIAbility实例，完成UIAbility的销毁。

// EntryAbility.ts
import { AbilityConstant, UIAbility, Want } from '@kit.AbilityKit';
...

export default class EntryAbility extends UIAbility {
  ...
  onDestroy() {
    // 释放系统资源，保存数据
    ...
  }
  ...
}