UIAbility組件生命周期

概述

當(dāng)用戶打開、切換和返回到對應(yīng)應(yīng)用時(shí)，應(yīng)用中的UIAbility實(shí)例會在其生命周期的不同狀態(tài)之間轉(zhuǎn)換。UIAbility類提供了一系列回調(diào)，通過這些回調(diào)可以知道當(dāng)前UIAbility實(shí)例的某個狀態(tài)發(fā)生改變，會經(jīng)過UIAbility實(shí)例的創(chuàng)建和銷毀，或者UIAbility實(shí)例發(fā)生了前后臺的狀態(tài)切換。

UIAbility的生命周期包括Create、Foreground、Background、Destroy四個狀態(tài)，如下圖所示。

圖1 UIAbility生命周期狀態(tài)

生命周期狀態(tài)說明

Create狀態(tài)

Create狀態(tài)為在應(yīng)用加載過程中，UIAbility實(shí)例創(chuàng)建完成時(shí)觸發(fā)，系統(tǒng)會調(diào)用onCreate()回調(diào)?？梢栽谠摶卣{(diào)中進(jìn)行頁面初始化操作，例如變量定義資源加載等，用于后續(xù)的UI展示。

import type AbilityConstant from '@ohos.app.ability.AbilityConstant';
import UIAbility from '@ohos.app.ability.UIAbility';
import type Want from '@ohos.app.ability.Want';

export default class EntryAbility extends UIAbility {
  onCreate(want: Want, launchParam: AbilityConstant.LaunchParam): void {
    // 頁面初始化
  }
  // ...
}

說明 ：
開發(fā)前請熟悉鴻蒙開發(fā)指導(dǎo)文檔 ：[gitee.com/li-shizhen-skin/harmony-os/blob/master/README.md]
[Want]是對象間信息傳遞的載體，可以用于應(yīng)用組件間的信息傳遞。Want的詳細(xì)介紹請參見[信息傳遞載體Want]。

WindowStageCreate和WindowStageDestroy狀態(tài)

UIAbility實(shí)例創(chuàng)建完成之后，在進(jìn)入Foreground之前，系統(tǒng)會創(chuàng)建一個WindowStage。WindowStage創(chuàng)建完成后會進(jìn)入onWindowStageCreate()回調(diào)，可以在該回調(diào)中設(shè)置UI加載、設(shè)置WindowStage的事件訂閱。

圖2 WindowStageCreate和WindowStageDestroy狀態(tài)

在onWindowStageCreate()回調(diào)中通過[loadContent()]方法設(shè)置應(yīng)用要加載的頁面，并根據(jù)需要調(diào)用[on('windowStageEvent')]方法訂閱WindowStage的[事件]（獲焦/失焦、可見/不可見）。

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
import hilog from '@ohos.hilog';

const TAG: string = '[EntryAbility]';
const DOMAIN_NUMBER: number = 0xFF00;

export default class EntryAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    // 設(shè)置WindowStage的事件訂閱（獲焦/失焦、可見/不可見）
    try {
      windowStage.on('windowStageEvent', (data) = > {
        let stageEventType: window.WindowStageEventType = data;
        switch (stageEventType) {
          case window.WindowStageEventType.SHOWN: // 切到前臺
            hilog.info(DOMAIN_NUMBER, TAG, 'windowStage foreground.');
            break;
          case window.WindowStageEventType.ACTIVE: // 獲焦?fàn)顟B(tài)
            hilog.info(DOMAIN_NUMBER, TAG, 'windowStage active.');
            break;
          case window.WindowStageEventType.INACTIVE: // 失焦?fàn)顟B(tài)
            hilog.info(DOMAIN_NUMBER, TAG, 'windowStage inactive.');
            break;
          case window.WindowStageEventType.HIDDEN: // 切到后臺
            hilog.info(DOMAIN_NUMBER, TAG, 'windowStage background.');
            break;
          default:
            break;
        }
      });
    } catch (exception) {
      hilog.error(DOMAIN_NUMBER, TAG, 'Failed to enable the listener for window stage event changes. Cause:' + JSON.stringify(exception));
    }
    hilog.info(DOMAIN_NUMBER, TAG, '%{public}s', 'Ability onWindowStageCreate');
    // 設(shè)置UI加載
    windowStage.loadContent('pages/Index', (err, data) = > {
      // ...
    });
  }
}

說明：

WindowStage的相關(guān)使用請參見[窗口開發(fā)指導(dǎo)]。

對應(yīng)于onWindowStageCreate()回調(diào)。在UIAbility實(shí)例銷毀之前，則會先進(jìn)入onWindowStageDestroy()回調(diào)，可以在該回調(diào)中釋放UI資源。

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';
import hilog from '@ohos.hilog';
import type { BusinessError } from '@ohos.base';

const TAG: string = '[EntryAbility]';
const DOMAIN_NUMBER: number = 0xFF00;

export default class EntryAbility extends UIAbility {
  windowStage: window.WindowStage | undefined = undefined;
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    this.windowStage = windowStage;
    // ...
  }
  onWindowStageDestroy() {
    // 釋放UI資源
    // 例如在onWindowStageDestroy()中注銷獲焦/失焦等WindowStage事件
    try {
      if (this.windowStage) {
        this.windowStage.off('windowStageEvent');
      }
    } catch (err) {
      let code = (err as BusinessError).code;
      let message = (err as BusinessError).message;
      hilog.error(DOMAIN_NUMBER, TAG, `Failed to disable the listener for windowStageEvent. Code is ${code}, message is ${message}`);
    };
  }
}

WindowStageWillDestroy狀態(tài)

對應(yīng)onWindowStageWillDestroy()回調(diào)，在WindowStage銷毀前執(zhí)行，此時(shí)WindowStage可以使用。

import UIAbility from '@ohos.app.ability.UIAbility';
import window from '@ohos.window';

export default class EntryAbility extends UIAbility {
  windowStage: window.WindowStage | undefined = undefined;
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    this.windowStage = windowStage;
    // ...
  }
  onWindowStageWillDestroy(windowStage: window.WindowStage) {
    // 釋放通過windowStage對象獲取的資源
  }
  onWindowStageDestroy() {
    // 釋放UI資源
  }
}

說明：

WindowStage的相關(guān)使用請參見[窗口開發(fā)指導(dǎo)]。

Foreground和Background狀態(tài)

Foreground和Background狀態(tài)分別在UIAbility實(shí)例切換至前臺和切換至后臺時(shí)觸發(fā)，對應(yīng)于onForeground()回調(diào)和onBackground()回調(diào)。

onForeground()回調(diào)，在UIAbility的UI可見之前，如UIAbility切換至前臺時(shí)觸發(fā)。可以在onForeground()回調(diào)中申請系統(tǒng)需要的資源，或者重新申請?jiān)?code>onBackground()中釋放的資源。

onBackground()回調(diào)，在UIAbility的UI完全不可見之后，如UIAbility切換至后臺時(shí)候觸發(fā)?？梢栽?code>onBackground()回調(diào)中釋放UI不可見時(shí)無用的資源，或者在此回調(diào)中執(zhí)行較為耗時(shí)的操作，例如狀態(tài)保存等。

例如應(yīng)用在使用過程中需要使用用戶定位時(shí)，假設(shè)應(yīng)用已獲得用戶的定位權(quán)限授權(quán)。在UI顯示之前，可以在onForeground()回調(diào)中開啟定位功能，從而獲取到當(dāng)前的位置信息。

當(dāng)應(yīng)用切換到后臺狀態(tài)，可以在onBackground()回調(diào)中停止定位功能，以節(jié)省系統(tǒng)的資源消耗。

import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
  // ...

  onForeground(): void {
    // 申請系統(tǒng)需要的資源，或者重新申請?jiān)趏nBackground()中釋放的資源
  }

  onBackground(): void {
    // 釋放UI不可見時(shí)無用的資源，或者在此回調(diào)中執(zhí)行較為耗時(shí)的操作
    // 例如狀態(tài)保存等
  }
}

當(dāng)應(yīng)用的UIAbility實(shí)例已創(chuàng)建，且UIAbility配置為[singleton]啟動模式時(shí)，再次調(diào)用[startAbility()]方法啟動該UIAbility實(shí)例時(shí)，只會進(jìn)入該UIAbility的[onNewWant()]回調(diào)，不會進(jìn)入其[onCreate()]和[onWindowStageCreate()]生命周期回調(diào)。應(yīng)用可以在該回調(diào)中更新要加載的資源和數(shù)據(jù)等，用于后續(xù)的UI展示。

import type AbilityConstant from '@ohos.app.ability.AbilityConstant';
import UIAbility from '@ohos.app.ability.UIAbility';
import type Want from '@ohos.app.ability.Want';

export default class EntryAbility extends UIAbility {
  // ...

  onNewWant(want: Want, launchParam: AbilityConstant.LaunchParam) {
    // 更新資源、數(shù)據(jù)
  }
}

`HarmonyOS與OpenHarmony鴻蒙文檔籽料：mau123789是v直接拿`

Destroy狀態(tài)

Destroy狀態(tài)在UIAbility實(shí)例銷毀時(shí)觸發(fā)。可以在onDestroy()回調(diào)中進(jìn)行系統(tǒng)資源的釋放、數(shù)據(jù)的保存等操作。

例如調(diào)用[terminateSelf()]方法停止當(dāng)前UIAbility實(shí)例，從而完成UIAbility實(shí)例的銷毀；或者用戶使用最近任務(wù)列表關(guān)閉該UIAbility實(shí)例，完成UIAbility的銷毀。

import UIAbility from '@ohos.app.ability.UIAbility';

export default class EntryAbility extends UIAbility {
  // ...

  onDestroy() {
    // 系統(tǒng)資源的釋放、數(shù)據(jù)的保存等
  }
}

審核編輯 黃宇