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

2024-01-22 18:54 更新

AbilityStage是HAP的運(yùn)行時(shí)類。

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

說(shuō)明

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

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

導(dǎo)入模塊

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

AbilityStage.onCreate

onCreate(): void

當(dāng)應(yīng)用創(chuàng)建時(shí)調(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;

啟動(dòng)一個(gè)specified ability時(shí)觸發(fā)的事件。

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

參數(shù):

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

返回值:

類型說(shuō)明
string用戶返回一個(gè)ability標(biāo)識(shí),如果之前啟動(dòng)過(guò)標(biāo)識(shí)的ability,不創(chuàng)建新的實(shí)例并拉回棧頂,否則創(chuàng)建新的實(shí)例并啟動(dò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ā)生全局配置變更時(shí)回調(diào)。

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

參數(shù):

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

示例:

  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;

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

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

參數(shù):

參數(shù)名類型必填說(shuō)明
levelAbilityConstant.MemoryLevel回調(diào)返回內(nèi)存微調(diào)級(jí)別,顯示當(dāng)前內(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

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

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)