鸿蒙原生应用/元服务开发-Stage模型能力接口（四）

一、说明

AbilityStage是HAP的运行时类。AbilityStage类提供在HAP加载的时候，通知开发者，可以在此进行该HAP的初始化（如资源预加载，线程创建等）能力。

本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。本模块接口仅可在Stage模型下使用。

二、导入模块
import AbilityStage from ‘@ohos.app.ability.AbilityStage’;

1.AbilityStage.onCreate
onCreate(): void

当应用创建时调用。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

示例：

import AbilityStage from ‘@ohos.app.ability.AbilityStage’;

class MyAbilityStage extends AbilityStage {

onCreate() {

    console.log('MyAbilityStage.onCreate is called');

}

}

2.AbilityStage.onAcceptWant
onAcceptWant(want: Want): string;

启动一个specified ability时触发的事件。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

返回值：

示例：

import AbilityStage from ‘@ohos.app.ability.AbilityStage’;

class MyAbilityStage extends AbilityStage {

onAcceptWant(want) {

    console.log('MyAbilityStage.onAcceptWant called');

    return 'com.example.test';

}

}

3.AbilityStage.onConfigurationUpdate
onConfigurationUpdate(newConfig: Configuration): void;

环境变化通知接口，发生全局配置变更时回调。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

示例：

import AbilityStage from ‘@ohos.app.ability.AbilityStage’;

class MyAbilityStage extends AbilityStage {

onConfigurationUpdate(config) {

    console.log('onConfigurationUpdate, language:' + config.language);

}

}

4.AbilityStage.onMemoryLevel
onMemoryLevel(level: AbilityConstant.MemoryLevel): void;

当系统已决定调整内存时调用。例如，当该功能在后台运行时，没有足够的内存来运行尽可能多的后台进程时可以使用。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

参数：

示例：

import AbilityStage from ‘@ohos.app.ability.AbilityStage’;

class MyAbilityStage extends AbilityStage {

onMemoryLevel(level) {

    console.log('onMemoryLevel, level:' + JSON.stringify(level));

}

}

5.AbilityStage.context
context: AbilityStageContext;

指示AbilityStage的上下文。

系统能力：SystemCapability.Ability.AbilityRuntime.Core

本文根据HarmonyOS官方开发文档整理