通知開發(fā)者,可以在此進行該HAP的初始化(如資源預加載,線程創(chuàng)建等)能力

2024-01-22 18:54 更新

AbilityStage是HAP的運行時類。

AbilityStage類提供在HAP加載的時候,通知開發(fā)者,可以在此進行該HAP的初始化(如資源預加載,線程創(chuàng)建等)能力。

說明

本模塊首批接口從API version 9 開始支持。后續(xù)版本的新增接口,采用上角標單獨標記接口的起始版本。

本模塊接口僅可在Stage模型下使用。

導入模塊

  1. import AbilityStage from '@ohos.app.ability.AbilityStage';

AbilityStage.onCreate

onCreate(): void

當應用創(chuàng)建時調(diào)用。

系統(tǒng)能力:SystemCapability.Ability.AbilityRuntime.Core

示例:

  1. import AbilityStage from '@ohos.app.ability.AbilityStage';
  2. class MyAbilityStage extends AbilityStage {
  3. onCreate() {
  4. console.log('MyAbilityStage.onCreate is called');
  5. }
  6. }

AbilityStage.onAcceptWant

onAcceptWant(want: Want): string;

啟動一個specified ability時觸發(fā)的事件。

系統(tǒng)能力:SystemCapability.Ability.AbilityRuntime.Core

參數(shù):

參數(shù)名類型必填說明
wantWantWant類型參數(shù),傳入需要啟動的ability的信息,如Ability名稱,Bundle名稱等。

返回值:

類型說明
string用戶返回一個ability標識,如果之前啟動過標識的ability,不創(chuàng)建新的實例并拉回棧頂,否則創(chuàng)建新的實例并啟動。

示例:

  1. import AbilityStage from '@ohos.app.ability.AbilityStage';
  2. class MyAbilityStage extends AbilityStage {
  3. onAcceptWant(want) {
  4. console.log('MyAbilityStage.onAcceptWant called');
  5. return 'com.example.test';
  6. }
  7. }

AbilityStage.onConfigurationUpdate

onConfigurationUpdate(newConfig: Configuration): void;

環(huán)境變化通知接口,發(fā)生全局配置變更時回調(diào)。

系統(tǒng)能力:SystemCapability.Ability.AbilityRuntime.Core

參數(shù):

參數(shù)名類型必填說明
newConfigConfiguration發(fā)生全局配置變更時觸發(fā)回調(diào),當前全局配置包括系統(tǒng)語言、深淺色模式。

示例:

  1. import AbilityStage from '@ohos.app.ability.AbilityStage';
  2. class MyAbilityStage extends AbilityStage {
  3. onConfigurationUpdate(config) {
  4. console.log('onConfigurationUpdate, language:' + config.language);
  5. }
  6. }

AbilityStage.onMemoryLevel

onMemoryLevel(level: AbilityConstant.MemoryLevel): void;

當系統(tǒng)已決定調(diào)整內(nèi)存時調(diào)用。例如,當該功能在后臺運行時,沒有足夠的內(nèi)存來運行盡可能多的后臺進程時可以使用。

系統(tǒng)能力:SystemCapability.Ability.AbilityRuntime.Core

參數(shù):

參數(shù)名類型必填說明
levelAbilityConstant.MemoryLevel回調(diào)返回內(nèi)存微調(diào)級別,顯示當前內(nèi)存使用狀態(tài)。

示例:

  1. import AbilityStage from '@ohos.app.ability.AbilityStage';
  2. class MyAbilityStage extends AbilityStage {
  3. onMemoryLevel(level) {
  4. console.log('onMemoryLevel, level:' + JSON.stringify(level));
  5. }
  6. }

AbilityStage.context

context: AbilityStageContext;

指示AbilityStage的上下文。

系統(tǒng)能力:SystemCapability.Ability.AbilityRuntime.Core

屬性名類型說明
contextAbilityStageContext在Ability啟動階段進行初始化時回調(diào),獲取到該Ability的context值。
以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號