harmony 鸿蒙@ohos.app.ability.application (Application)(系统接口)

2025-06-12
浏览 (7)

@ohos.app.ability.application (Application)(系统接口)

开发者可以通过该模块创建Context。

说明：

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

导入模块

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

application.createModuleContext¹²⁺

createModuleContext(context: Context, bundleName: string, moduleName: string): Promise<Context>

根据入参Context创建相应模块的Context。

说明：

从API version 18开始，Context支持获取当前应用的进程名processName。createModuleContext创建的Context中的processName属性与入参Context中的processName属性一致，其他属性根据入参Context、bundleName和moduleName获得相应的属性值。

该接口需要多次查询包信息、加载指定Module的全部资源，耗时较长。建议首次使用该接口时缓存创建的Context，以避免重复调用该接口创建Context。

元服务API： 从API version 12开始，该接口支持在元服务中使用。

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

系统接口：此接口为系统接口。

参数：

参数名	类型	必填	说明
context	Context	是	表示应用上下文。
bundleName	string	是	表示应用包名。取值为空字符串时，默认为当前应用。
moduleName	string	是	表示应用模块名。

返回值：

类型	说明
Promise<Context>	Promise对象。返回创建的Context。

错误码：

以下错误码详细介绍请参考元能力子系统错误码。

错误码ID	错误信息
201	Permission denied.
202	Permission denied, non-system app called system api.
401	Parameter error. Possible causes: 1.Mandatory parameters are left unspecified. 2.Incorrect parameter types.

示例：

import { UIAbility, application, common } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  onCreate() {
    let moduleContext: common.Context;
    try {
      application.createModuleContext(this.context, 'bundlename', 'entry').then((data: Context)=>{
        moduleContext = data;
        console.info('createModuleContext success!');
      }).catch((error : BusinessError)=>{
        console.error(`createModuleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
      })
    } catch (error) {
      console.error(`createModuleContext failed, error.code: ${(error as BusinessError).code}, error.message: ${(error as BusinessError).message}`);
    }
  }
}

application.createBundleContext¹²⁺

createBundleContext(context: Context, bundleName: string): Promise<Context>

根据入参Context创建相应应用的Context。

说明：

从API version 18开始，Context支持获取当前应用的进程名processName。createBundleContext创建的Context中的processName属性与入参Context中的processName属性一致，其他属性根据入参Context、bundleName和moduleName获得相应的属性值。