一、说明
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官方开发文档整理