harmony(鸿蒙)@ohos.application.AbilityStage (AbilityStage)

  • 2022-08-09
  • 浏览 (1101)

@ohos.application.AbilityStage (AbilityStage)

AbilityStage是HAP包的运行时类。

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

说明:

本模块首批接口从API version 9 开始支持, 从API version 9废弃,替换模块为@ohos.app.ability.AbilityStage。后续版本的新增接口,采用上角标单独标记接口的起始版本。
本模块接口仅可在Stage模型下使用。

导入模块

import AbilityStage from '@ohos.application.AbilityStage';

AbilityStage.onCreate

onCreate(): void

当应用创建时调用。

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

示例:

  class MyAbilityStage extends AbilityStage {
      onCreate() {
          console.log("MyAbilityStage.onCreate is called")
      }
  }

AbilityStage.onAcceptWant

onAcceptWant(want: Want): string;

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

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

参数:

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

返回值:

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

示例:

  class MyAbilityStage extends AbilityStage {
      onAcceptWant(want) {
          console.log("MyAbilityStage.onAcceptWant called");
          return "com.example.test";
      }
  }

AbilityStage.onConfigurationUpdated

onConfigurationUpdated(config: Configuration): void;

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

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

参数:

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

示例:

  class MyAbilityStage extends AbilityStage {
      onConfigurationUpdated(config) {
          console.log('onConfigurationUpdated, language:' + config.language);
      }
  }

AbilityStage.onMemoryLevel

onMemoryLevel(level: AbilityConstant.MemoryLevel): void;

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

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

参数:

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

示例:

  class MyAbilityStage extends AbilityStage {
    onMemoryLevel(level) {
        console.log('onMemoryLevel, level:' + JSON.stringify(level));
    } 
  }

AbilityStage.context

context: AbilityStageContext;

AbilityStage的上下文对象。

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

属性名 类型 说明
context AbilityStageContext AbilityStage的上下文对象。

你可能感兴趣的鸿蒙文章

harmony(鸿蒙)接口

harmony(鸿蒙)开发说明

harmony(鸿蒙)BundleStatusCallback

harmony(鸿蒙)@ohos.bundle.innerBundleManager (innerBundleManager模块)

harmony(鸿蒙)@ohos.distributedBundle (分布式包管理)

harmony(鸿蒙)@ohos.bundle (Bundle模块)

harmony(鸿蒙)@ohos.enterprise.EnterpriseAdminExtensionAbility (EnterpriseAdminExtensionAbility)

harmony(鸿蒙)@ohos.WorkSchedulerExtensionAbility (延迟任务调度回调)

harmony(鸿蒙)@ohos.ability.ability (Ability)

harmony(鸿蒙)AbilityContext

0  赞