目录

AbilityStageContext

AbilityStageContext是AbilityStage的上下文环境,继承自Context。AbilityStageContext提供访问特定于AbilityStage的资源的能力,适用于需要在AbilityStage生命周期中访问模块信息和环境配置的场景,可帮助开发者快速获取模块信息和环境配置。

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

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

导入模块

import { common } from '@kit.AbilityKit';

属性

元服务API:从API version 11开始,该接口支持在元服务中使用。

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

名称 类型 只读 可选 说明
currentHapModuleInfo HapModuleInfo 否 否 AbilityStage对应的HapModuleInfo对象,可用来获取当前模块的名称、路径等信息。
config Configuration 否 否 环境配置对象。
launchElement24+ ElementName 否 是

创建AbilityStage时的元素名称信息。

元服务API:从API version 24开始,该接口支持在元服务中使用。

示例:

import { AbilityStage } from '@kit.AbilityKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

class MyAbilityStage extends AbilityStage {
  onCreate() {
    // 获取AbilityStageContext上下文
    let abilityStageContext = this.context;
    // 获取当前模块名
    let name = abilityStageContext.currentHapModuleInfo.name;
    // 获取当前模块语言
    let language = abilityStageContext.config.language;
    // 获取创建AbilityStage时的ElementName
    let elementName = abilityStageContext.launchElement;
    if (elementName) {
      hilog.info(0x0000, 'testTag', 'bundleName: %{public}s', elementName.bundleName);
      hilog.info(0x0000, 'testTag', 'moduleName: %{public}s', elementName.moduleName);
      hilog.info(0x0000, 'testTag', 'abilityName: %{public}s', elementName.abilityName);
    }
  }
}