通知开发者,可以在此进行该HAP的初始化(如资源预加载,线程创建等)能力

2024-01-22 18:54 更新

AbilityStage是HAP的运行时类。

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

说明

本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

本模块接口仅可在Stage模型下使用。

导入模块

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

AbilityStage.onCreate

onCreate(): void

当应用创建时调用。

系统能力: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时触发的事件。

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

参数:

参数名类型必填说明
wantWantWant类型参数,传入需要启动的ability的信息,如Ability名称,Bundle名称等。

返回值:

类型说明
string用户返回一个ability标识,如果之前启动过标识的ability,不创建新的实例并拉回栈顶,否则创建新的实例并启动。

示例:

  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;

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

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

参数:

参数名类型必填说明
newConfigConfiguration发生全局配置变更时触发回调,当前全局配置包括系统语言、深浅色模式。

示例:

  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;

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

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

参数:

参数名类型必填说明
levelAbilityConstant.MemoryLevel回调返回内存微调级别,显示当前内存使用状态。

示例:

  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的上下文。

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

属性名类型说明
contextAbilityStageContext在Ability启动阶段进行初始化时回调,获取到该Ability的context值。
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号