UIAbility組件生命周期

概述

當用戶打開、切換和返回到對應(yīng)應(yīng)用時，應(yīng)用中的UIAbility實例會在其生命周期的不同狀態(tài)之間轉(zhuǎn)換。UIAbility類提供了一系列回調(diào)，通過這些回調(diào)可以知道當前UIAbility實例的某個狀態(tài)發(fā)生改變，會經(jīng)過UIAbility實例的創(chuàng)建和銷毀，或者UIAbility實例發(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實例創(chuàng)建完成時觸發(fā)，系統(tǒng)會調(diào)用onCreate()回調(diào)?？梢栽谠摶卣{(diào)中進行頁面初始化操作，例如變量定義資源加載等，用于后續(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的詳細介紹請參見[信息傳遞載體Want]。

WindowStageCreate和WindowStageDestroy狀態(tài)

UIAbility實例創(chuàng)建完成之后，在進入Foreground之前，系統(tǒng)會創(chuàng)建一個WindowStage。WindowStage創(chuàng)建完成后會進入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: // 獲焦狀態(tài)
            hilog.info(DOMAIN_NUMBER, TAG, 'windowStage active.');
            break;
          case window.WindowStageEventType.INACTIVE: // 失焦狀態(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實例銷毀之前，則會先進入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í)行，此時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實例切換至前臺和切換至后臺時觸發(fā)，對應(yīng)于onForeground()回調(diào)和onBackground()回調(diào)。

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

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

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

當應(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)需要的資源，或者重新申請在onBackground()中釋放的資源
  }

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

當應(yīng)用的UIAbility實例已創(chuàng)建，且UIAbility配置為[singleton]啟動模式時，再次調(diào)用[startAbility()]方法啟動該UIAbility實例時，只會進入該UIAbility的[onNewWant()]回調(diào)，不會進入其[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實例銷毀時觸發(fā)?？梢栽趏nDestroy()回調(diào)中進行系統(tǒng)資源的釋放、數(shù)據(jù)的保存等操作。

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

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

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

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

審核編輯 黃宇