鸿蒙5.0开发进阶:@ohos.bundle.bundleManager (bundleManager模块)

鸿蒙开发常见错误总结—包管理开发常见问题 使用bundleManager模块的getApplicationInfo接口(仅系统应用可以使用)获取待检验应用的ApplicationInfo,根据ApplicationInfo中systemApp字段判断,若为true,则是系统应用,否则为非系统应用。 阅读详情

往期鸿蒙全套实战文章必看:(文中附带全栈鸿蒙学习资料)


@ohos.bundle.bundleManager (bundleManager模块)

本模块提供应用信息查询能力,支持BundleInfo、ApplicationInfo、AbilityInfo、ExtensionAbilityInfo等信息的查询。

说明

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

导入模块

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

枚举

BundleFlag

包信息标志,指示需要获取的包信息的内容。

系统能力: SystemCapability.BundleManager.BundleFramework.Core。

名称值说明
GET_BUNDLE_INFO_DEFAULT0x00000000

用于获取默认bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息。

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

GET_BUNDLE_INFO_WITH_APPLICATION0x00000001

用于获取包含applicationInfo的bundleInfo,获取的bundleInfo不包含signatureInfo、hapModuleInfo、ability、extensionAbility和permission的信息。

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

GET_BUNDLE_INFO_WITH_HAP_MODULE0x00000002

用于获取包含hapModuleInfo的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、ability、extensionAbility和permission的信息。

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

GET_BUNDLE_INFO_WITH_ABILITY0x00000004

用于获取包含ability的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、extensionAbility和permission的信息。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。

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

GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY0x00000008

用于获取包含extensionAbility的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、ability 和permission的信息。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。

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

GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION0x00000010

用于获取包含permission的bundleInfo。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、extensionAbility和ability的信息。

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

GET_BUNDLE_INFO_WITH_METADATA0x00000020

用于获取applicationInfo、moduleInfo和abilityInfo中包含的metadata。它不能单独使用,它需要与GET_BUNDLE_INFO_WITH_APPLICATION、GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY一起使用。

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

GET_BUNDLE_INFO_WITH_DISABLE0x00000040

用于获取application被禁用的BundleInfo和被禁用的Ability信息。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息。

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

GET_BUNDLE_INFO_WITH_SIGNATURE_INFO0x00000080

用于获取包含signatureInfo的bundleInfo。获取的bundleInfo不包含applicationInfo、hapModuleInfo、extensionAbility、ability和permission的信息。

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

GET_BUNDLE_INFO_WITH_MENU11+0x00000100

用于获取包含fileContextMenuConfig的bundleInfo。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。

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

GET_BUNDLE_INFO_WITH_ROUTER_MAP12+0x00000200

用于获取包含routerMap的bundleInfo。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。

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

GET_BUNDLE_INFO_WITH_SKILL12+0x00000800

用于获取包含skills的bundleInfo。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY一起使用。

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

ExtensionAbilityType

指示扩展组件的类型。

系统能力: SystemCapability.BundleManager.BundleFramework.Core。

名称值说明
FORM0

FormExtensionAbility:卡片扩展能力,提供卡片开发能力。

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

WORK_SCHEDULER1WorkSchedulerExtensionAbility:延时任务扩展能力,允许应用在系统闲时执行实时性不高的任务。
INPUT_METHOD2InputMethodExtensionAbility:输入法扩展能力,用于开发输入法应用。
SERVICE3ServiceExtensionAbility:后台服务扩展能力,提供后台运行并对外提供相应能力。
ACCESSIBILITY4AccessibilityExtensionAbility:无障碍服务扩展能力,支持访问与操作前台界面。
DATA_SHARE5DataShareExtensionAbility :数据共享扩展能力,用于对外提供数据读写服务。
FILE_SHARE6FileShareExtensionAbility:文件共享扩展能力,用于应用间的文件分享。预留能力,仅系统应用支持。
STATIC_SUBSCRIBER7StaticSubscriberExtensionAbility :静态广播扩展能力,用于处理静态事件,比如开机事件。
WALLPAPER8WallpaperExtensionAbility:壁纸扩展能力,用于实现桌面壁纸。预留能力,仅系统应用支持。
BACKUP9BackupExtensionAbility:数据备份扩展能力,提供应用数据的备份恢复能力。
WINDOW10WindowExtensionAbility:界面组合扩展能力,允许系统应用进行跨应用的界面拉起和嵌入。
ENTERPRISE_ADMIN11EnterpriseAdminExtensionAbility:企业设备管理扩展能力,提供企业管理时处理管理事件的能力,比如设备上应用安装事件、锁屏密码输入错误次数过多事件等。
THUMBNAIL13ThumbnailExtensionAbility:文件缩略图扩展能力,用于为文件提供图标缩略图的能力。预留能力,仅系统应用支持。
PREVIEW14PreviewExtensionAbility:文件预览扩展能力,提供文件预览的能力,其他应用可以直接在应用中嵌入显示。预留能力,仅系统应用支持。
PRINT10+15PrintExtensionAbility:文件打印扩展能力,提供应用打印照片、文档等办公场景。仅系统应用支持。
SHARE10+16ShareExtensionAbility:提供分享业务能力,为开发者提供基于UIExtension的分享业务模板。
PUSH10+17PushExtensionAbility:推送扩展能力,提供推送场景化消息能力。预留能力,仅系统应用支持。
DRIVER10+18DriverExtensionAbility:驱动扩展能力,提供外设驱动扩展能力,仅系统应用支持。
ACTION10+19ActionExtensionAbility:自定义服务扩展能力,为开发者提供基于UIExtension的自定义操作业务模板。
ADS_SERVICE11+20AdsServiceExtensionAbility:广告服务扩展能力,对外提供后台自定义广告业务服务,仅系统应用支持。
EMBEDDED_UI12+21EmbeddedUIExtensionAbility:嵌入式UI扩展能力,提供跨进程界面嵌入的能力。
INSIGHT_INTENT_UI12+22InsightIntentUIExtensionAbility:为开发者提供能被小艺意图调用,以窗口形态呈现内容的扩展能力。
UNSPECIFIED255不指定类型,配合queryExtensionAbilityInfo接口可以查询所有类型的ExtensionAbility。

PermissionGrantState

指示权限授予状态。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core。

名称值说明
PERMISSION_DENIED-1拒绝授予权限。
PERMISSION_GRANTED0授予权限。

SupportWindowMode

标识该组件所支持的窗口模式。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core。

名称值说明
FULL_SCREEN0窗口支持全屏显示。
SPLIT1窗口支持分屏显示。
FLOATING2支持窗口化显示。

LaunchType

指示组件的启动方式。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core。

名称值说明
SINGLETON0ability的启动模式,表示单实例。
MULTITON1ability的启动模式,表示普通多实例。
SPECIFIED2ability的启动模式,表示该ability内部根据业务自己指定多实例。

AbilityType

指示Ability组件的类型。

模型约束: 仅可在FA模型下使用

系统能力: SystemCapability.BundleManager.BundleFramework.Core。

名称值说明
PAGE1UI界面类型的Ability。表示基于Page模板开发的FA,用于提供与用户交互的能力。
SERVICE2后台服务类型的Ability,无UI界面。表示基于Service模板开发的PA,用于提供后台运行任务的能力。
DATA3表示基于Data模板开发的PA,用于对外部提供统一的数据访问对象。

DisplayOrientation

标识该Ability的显示模式。该标签仅适用于page类型的Ability。

系统能力: SystemCapability.BundleManager.BundleFramework.Core。

名称值说明
UNSPECIFIED0

表示未定义方向模式,由系统判定。

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

LANDSCAPE1

表示横屏显示模式。

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

PORTRAIT2

表示竖屏显示模式。

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

FOLLOW_RECENT3

表示跟随上一个显示模式。

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

LANDSCAPE_INVERTED4

表示反向横屏显示模式。

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

PORTRAIT_INVERTED5

表示反向竖屏显示模式。

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

AUTO_ROTATION6

表示传感器自动旋转模式。

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

AUTO_ROTATION_LANDSCAPE7

表示传感器自动横向旋转模式。

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

AUTO_ROTATION_PORTRAIT8

表示传感器自动竖向旋转模式。

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

AUTO_ROTATION_RESTRICTED9

表示受开关控制的自动旋转模式。

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

AUTO_ROTATION_LANDSCAPE_RESTRICTED10

表述受开关控制的自动横向旋转模式。

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

AUTO_ROTATION_PORTRAIT_RESTRICTED11

表示受开关控制的自动竖向旋转模式。

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

LOCKED12

表示锁定模式。

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

AUTO_ROTATION_UNSPECIFIED12+13

受开关控制和由系统判定的自动旋转模式。

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

FOLLOW_DESKTOP12+14

跟随桌面的旋转模式。

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

CompatiblePolicy10+

标识共享库的版本兼容类型。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

名称值说明
BACKWARD_COMPATIBILITY1该字段表明共享库是向后兼容类型。

ModuleType

标识模块类型。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

名称值说明
ENTRY1应用的主模块。
FEATURE2应用的动态特性模块。
SHARED3应用的动态共享库模块。

BundleType

标识应用的类型。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

名称值说明
APP0该Bundle是应用。
ATOMIC_SERVICE1该Bundle是元服务。

MultiAppModeType12+

标识应用多开的模式类型。

系统能力: SystemCapability.BundleManager.BundleFramework.Core。

名称值说明
UNSPECIFIED0未指定类型。
MULTI_INSTANCE1多实例模式。
APP_CLONE2分身模式。

接口

bundleManager.getBundleInfoForSelf

getBundleInfoForSelf(bundleFlags: number): Promise<BundleInfo>

以异步方法根据给定的bundleFlags获取当前应用的BundleInfo,使用Promise形式返回结果。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
bundleFlagsnumber是指定返回的BundleInfo所包含的信息。

返回值:

类型说明
Promise<BundleInfo>Promise对象,返回当前应用的BundleInfo。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例:

// 额外获取带有metadataArray信息的appInfo
import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA;

try {
  bundleManager.getBundleInfoForSelf(bundleFlags).then((data) => {
    hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf successfully. Data: %{public}s', JSON.stringify(data));
  }).catch((err: BusinessError) => {
    hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed. Cause: %{public}s', err.message);
  });
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message);
}

bundleManager.getBundleInfoForSelf

getBundleInfoForSelf(bundleFlags: number, callback: AsyncCallback<BundleInfo>): void

以异步方法根据给定的bundleFlags获取当前应用的BundleInfo,使用callback形式返回结果。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
bundleFlagsnumber是指定返回的BundleInfo所包含的信息。
callbackAsyncCallback<BundleInfo>是回调函数,当获取成功时,err为null,data为获取到的当前应用的BundleInfo;否则为错误对象。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例:

// 额外获取带有permissions信息的abilitiesInfo
import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_ABILITY | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION;

try {
  bundleManager.getBundleInfoForSelf(bundleFlags, (err, data) => {
    if (err) {
      hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', err.message);
    } else {
      hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf successfully: %{public}s', JSON.stringify(data));
    }
  });
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message);
}

bundleManager.getProfileByAbility

getProfileByAbility(moduleName: string, abilityName: string, metadataName: string, callback: AsyncCallback<Array<string>>): void

以异步方法根据给定的moduleName、abilityName和metadataName(module.json中metadata标签下的name)获取相应配置文件的json格式字符串,使用callback形式返回结果。

如果配置文件信息采用了资源引用格式,则返回值将保持资源引用格式(例如 $string:res_id),开发者可以通过资源管理模块的相关接口,来获取引用的资源。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
moduleNamestring是表示Module名称。
abilityNamestring是表示UIAbility组件的名称。
metadataNamestring是表示UIAbility组件的元信息名称,即module.json5配置文件中abilities标签下的metadata标签的name。
callbackAsyncCallback<Array<string>>是回调函数,当获取成功时,err为null,data为获取到的Array<string>;否则为错误对象。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
17700002The specified moduleName is not existed.
17700003The specified abilityName is not existed.
17700024Failed to get the profile because there is no profile in the HAP.
17700026The specified bundle is disabled.
17700029The specified ability is disabled.

示例:

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let moduleName = 'entry';
let abilityName = 'EntryAbility';
let metadataName = 'ability_metadata';

try {
  bundleManager.getProfileByAbility(moduleName, abilityName, metadataName, (err, data) => {
    if (err) {
      hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
    } else {
      hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully: %{public}s', JSON.stringify(data));
    }
  });
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message);
}

bundleManager.getProfileByAbility

getProfileByAbility(moduleName: string, abilityName: string, metadataName?: string): Promise<Array<string>>

以异步方法根据给定的moduleName、abilityName和metadataName(module.json中metadata标签下的name)获取相应配置文件的json格式字符串,使用Promise形式返回结果。

如果配置文件信息采用了资源引用格式,则返回值将保持资源引用格式(例如 $string:res_id),开发者可以通过资源管理模块的相关接口,来获取引用的资源。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
moduleNamestring是表示Module名称。
abilityNamestring是表示UIAbility组件的名称。
metadataNamestring否表示UIAbility组件的元信息名称,即module.json5配置文件中abilities标签下的metadata标签的name,默认值为空。

返回值:

类型说明
Promise<Array<string>>Promise对象,返回Array<string>。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
17700002The specified moduleName is not existed.
17700003The specified abilityName is not existed.
17700024Failed to get the profile because there is no profile in the HAP.
17700026The specified bundle is disabled.
17700029The specified ability is disabled.

示例:

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let moduleName = 'entry';
let abilityName = 'EntryAbility';

try {
  bundleManager.getProfileByAbility(moduleName, abilityName).then((data) => {
    hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully. Data: %{public}s', JSON.stringify(data));
  }).catch((err: BusinessError) => {
    hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
  });
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message);
}
import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let moduleName = 'entry';
let abilityName = 'EntryAbility';
let metadataName = 'ability_metadata';

try {
  bundleManager.getProfileByAbility(moduleName, abilityName, metadataName).then((data) => {
    hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully. Data: %{public}s', JSON.stringify(data));
  }).catch((err: BusinessError) => {
    hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
  });
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message);
}

bundleManager.getProfileByAbilitySync10+

getProfileByAbilitySync(moduleName: string, abilityName: string, metadataName?: string): Array<string>

以同步方法根据给定的moduleName、abilityName和metadataName(module.json中metadata标签下的name)获取相应配置文件的json格式字符串,返回对象为string数组。

如果配置文件信息采用了资源引用格式,则返回值将保持资源引用格式(例如 $string:res_id),开发者可以通过资源管理模块的相关接口,来获取引用的资源。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
moduleNamestring是表示Module名称。
abilityNamestring是表示UIAbility组件的名称。
metadataNamestring否表示UIAbility组件的元信息名称,即module.json5配置文件中abilities标签下的metadata标签的name,默认值为空。

返回值:

类型说明
Array<string>数组对象,返回Array<string>。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
17700002The specified moduleName is not existed.
17700003The specified abilityName is not existed.
17700024Failed to get the profile because there is no profile in the HAP.
17700026The specified bundle is disabled.
17700029The specified ability is disabled.

示例:

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let moduleName = 'entry';
let abilityName = 'EntryAbility';

try {
  let data = bundleManager.getProfileByAbilitySync(moduleName, abilityName);
  hilog.info(0x0000, 'testTag', 'getProfileByAbilitySync successfully. Data: %{public}s', JSON.stringify(data));
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByAbilitySync failed. Cause: %{public}s', message);
}

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let moduleName: string = 'entry';
let abilityName: string = 'EntryAbility';
let metadataName: string = 'ability_metadata';

try {
let data = bundleManager.getProfileByAbilitySync(moduleName, abilityName, metadataName);
hilog.info(0x0000, 'testTag', 'getProfileByAbilitySync successfully. Data: %{public}s', JSON.stringify(data));
} catch (err) {
let message = (err as BusinessError).message;
hilog.error(0x0000, 'testTag', 'getProfileByAbilitySync failed. Cause: %{public}s', message);
}

bundleManager.getProfileByExtensionAbility

getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, metadataName: string, callback: AsyncCallback<Array<string>>): void

以异步方法根据给定的moduleName、extensionAbilityName和metadataName(module.json中metadata标签下的name)获取相应配置文件的json格式字符串,使用callback形式返回结果。

如果配置文件信息采用了资源引用格式,则返回值将保持资源引用格式(例如 $string:res_id),开发者可以通过资源管理模块的相关接口,来获取引用的资源。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
moduleNamestring是表示Module名称。
extensionAbilityNamestring是表示ExtensionAbility组件的名称。
metadataNamestring是表示ExtensionAbility组件的名称。组件的元信息名称,即module.json5配置文件中extensionAbilities标签下的metadata标签的name。
callbackAsyncCallback<Array<string>>是回调函数,当获取成功时,err为null,data为获取到的Array<string>;否则为错误对象。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
17700002The specified moduleName is not existed.
17700003The specified extensionAbilityName not existed.
17700024Failed to get the profile because there is no profile in the HAP.
17700026The specified bundle is disabled.

示例:

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let moduleName = 'entry';
let extensionAbilityName = 'com.example.myapplication.extension';
let metadataName = 'ability_metadata';

try {
  bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName, metadataName, (err, data) => {
    if (err) {
      hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed: %{public}s', err.message);
    } else {
      hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully: %{public}s', JSON.stringify(data));
    }
  });
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed: %{public}s', message);
}

bundleManager.getProfileByExtensionAbility

getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, metadataName?: string): Promise<Array<string>>

以异步方法根据给定的moduleName、extensionAbilityName和metadataName(module.json中metadata标签下的name)获取相应配置文件的json格式字符串,使用Promise形式返回结果。

如果配置文件信息采用了资源引用格式,则返回值将保持资源引用格式(例如 $string:res_id),开发者可以通过资源管理模块的相关接口,来获取引用的资源。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
moduleNamestring是表示Module名称。
extensionAbilityNamestring是表示ExtensionAbility组件的名称。
metadataNamestring否表示ExtensionAbility组件的名称。组件的元信息名称,即module.json5配置文件中extensionAbilities标签下的metadata标签的name,默认值为空。

返回值:

类型说明
Promise<Array<string>>Promise对象,返回Array<string>对象。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
17700002The specified moduleName is not existed.
17700003The specified extensionAbilityName not existed.
17700024Failed to get the profile because there is no profile in the HAP.
17700026The specified bundle is disabled.

示例:

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let moduleName = 'entry';
let extensionAbilityName = 'com.example.myapplication.extension';
let metadataName = 'ability_metadata';

try {
  bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName).then((data) => {
    hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully. Data: %{public}s', JSON.stringify(data));
  }).catch((err: BusinessError) => {
    hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message);
  });
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', message);
}

try {
  bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName, metadataName).then((data) => {
    hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully. Data: %{public}s', JSON.stringify(data));
  }).catch((err: BusinessError) => {
    hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message);
  });
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', message);
}

bundleManager.getProfileByExtensionAbilitySync10+

getProfileByExtensionAbilitySync(moduleName: string, extensionAbilityName: string, metadataName?: string): Array<string>

以同步方法根据给定的moduleName、extensionAbilityName和metadataName(module.json中metadata标签下的name)获取相应配置文件的json格式字符串,返回对象为string数组。

如果配置文件信息采用了资源引用格式,则返回值将保持资源引用格式(例如 $string:res_id),开发者可以通过资源管理模块的相关接口,来获取引用的资源。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
moduleNamestring是表示Module名称。
extensionAbilityNamestring是表示ExtensionAbility组件的名称。
metadataNamestring否表示ExtensionAbility组件的名称。组件的元信息名称,即module.json5配置文件中extensionAbilities标签下的metadata标签的name,默认值为空。

返回值:

类型说明
Array<string>返回Array<string>对象。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
17700002The specified moduleName is not existed.
17700003The specified extensionAbilityName not existed.
17700024Failed to get the profile because there is no profile in the HAP.
17700026The specified bundle is disabled.

示例:

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let moduleName = 'entry';
let extensionAbilityName = 'com.example.myapplication.extension';
let metadataName = 'ability_metadata';

try {
  let data = bundleManager.getProfileByExtensionAbilitySync(moduleName, extensionAbilityName);
  hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbilitySync successfully. Data: %{public}s', JSON.stringify(data));
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbilitySync failed. Cause: %{public}s', message);
}

try {
  let data = bundleManager.getProfileByExtensionAbilitySync(moduleName, extensionAbilityName, metadataName);
  hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbilitySync successfully. Data: %{public}s', JSON.stringify(data));
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbilitySync failed. Cause: %{public}s', message);
}

bundleManager.getBundleInfoForSelfSync10+

getBundleInfoForSelfSync(bundleFlags: number): BundleInfo

以同步方法根据给定的bundleFlags获取当前应用的BundleInfo。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
bundleFlagsnumber是指定返回的BundleInfo所包含的信息。

返回值:

类型说明
BundleInfo返回BundleInfo对象。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.

示例:

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION;

try {
  let data = bundleManager.getBundleInfoForSelfSync(bundleFlags);
  hilog.info(0x0000, 'testTag', 'getBundleInfoForSelfSync successfully: %{public}s', JSON.stringify(data));
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'getBundleInfoForSelfSync failed: %{public}s', message);
}

bundleManager.canOpenLink12+

canOpenLink(link: string): boolean

查询给定的链接是否可以打开。指定链接的scheme需要在module.json文件的querySchemes字段下配置。

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

系统能力: SystemCapability.BundleManager.BundleFramework.Core

参数:

参数名类型必填说明
linkstring是表示需要查询的链接。

返回值:

类型说明
boolean返回true表示给定的链接可以打开,返回false表示给定的链接不能打开。

错误码:

以下错误码的详细介绍。

错误码ID错误信息
401Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
17700055The specified link is invalid.
17700056The scheme of the specified link is not in the querySchemes.

示例:

import { bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import { hilog } from '@kit.PerformanceAnalysisKit';

try {
  let link = 'welink://';
  let data = bundleManager.canOpenLink(link);
  hilog.info(0x0000, 'testTag', 'canOpenLink successfully: %{public}s', JSON.stringify(data));
} catch (err) {
  let message = (err as BusinessError).message;
  hilog.error(0x0000, 'testTag', 'canOpenLink failed: %{public}s', message);
}

鸿蒙OS实例:同步获取应用配置的【versionCode和versionName】 鸿蒙大部分提供的方法都是异步的,所以可以使用async、await 转换,可以跟同步方法一样的使用...只是要注意这个会阻塞鸿蒙是完全具备无与伦比的机遇和潜力的;预计到年底将有 5,000 款的应用完成原生鸿蒙开发,这么多的应用需要开发,也就意味着需要有更多的鸿蒙人才。鸿蒙开发工程师也将会迎来爆发式的增长,学习鸿蒙势在必行! 阅读详情

相关推荐

如何使用命令行对RK开发板进行OpenHarmony版本烧录?

开发版烧录

m0_64420071的博客 2317

HarmonyOS实战开发:@ohos.bundle.bundleManager (bundleManager模块)

本模块提供应用信息查询能力

2401_84194030的博客 1597

鸿蒙HarmonyOS之使用ArkTs语言获取应用版本等信息

获取的版本号是在app.json里面配置的"versionName"参数值,例如: 1.0.0。

qq_46269365的博客 2333

鸿蒙应用开发--bundleManager模块是鸿蒙系统中的应用包管理核心模块,用于管理手机上的应用,功能: 查询所有已安装应用,检查某个应用是否安装,查询某个应用的版本号,跳转到另一个应用的功能页面

模块是,你可以将它理解为手机的。就像你手机里的假设你开发一个。

2401_88846919的博客 870

Isaac Sim仿真平台学习(2)系统架构

isaac sim系统架构

weixin_75067193的博客 2699

双向晶闸管交流调压基础知识及Multisim电路仿真

本文介绍了双向晶闸管交流调压电路的工作原理及应用。该电路由双向晶闸管、RC移相电路和双向触发二极管组成,通过调节电位器改变触发角实现电压调节。当电位器阻值减小时,触发角减小,输出电压升高;阻值增大时,触发角增大,输出电压降低。Multisim仿真展示了不同电位器档位下的波形特征:0%档位时全导通,50%档位时半导通,100%档位时基本关断。该电路结构简单、调节平滑,广泛应用于调光、调速等场合,但会产生谐波干扰。

XU157303764的博客 844

鸿蒙API14开发【@ohos.bundle.bundleManager (bundleManager模块)】应用框架api

本模块提供应用信息查询能力,支持[BundleInfo]、[ApplicationInfo]、[AbilityInfo]、[ExtensionAbilityInfo]等信息的查询。

bbq的博客 771

足球大数据分析入门:从赔率到预测的完整流程(附数据集)

本文提供了一份足球大数据分析的完整实战指南,涵盖从数据采集、清洗、特征工程到模型构建与评估的全流程。文章详细介绍了如何利用公开数据集与API获取数据,并通过逻辑回归、随机森林等模型进行比赛结果预测,最后强调了模型评估与策略回测的重要性,帮助读者构建自己的分析框架。

r7s8t的博客 411

鸿蒙API13开发【@ohos.bundle.bundleManager (bundleManager模块)】通用能力的接口

包信息标志,指示需要获取的包信息的内容。

鸿蒙的技术博客 949

CUBEMX ADC 单/多通道+DMA

本文使用的是STM3F103C8T6 Cubemx进行单/多通道DMA配置。

记录学习 1405

Simulink开发项1000例实战专栏--实例148:构建一个完整的电动汽车电池SOH评估仿真模型,包括电池建模模块、数据采集模块、SOH估算算法模块以及性能评估模块

电动汽车的动力电池是其核心部件,而电池的健康状态(State of Health, SOH)直接影响车辆的续航能力和使用寿命。SOH通常定义为当前电池容量与初始容量的比值,用百分比表示。通过基于MATLAB/Simulink平台的SOH评估仿真,可以实时监测电池的退化情况,并为电池管理系统(BMS)提供决策依据。本项目旨在构建一个完整的电动汽车电池SOH评估仿真模型,包括电池建模模块、数据采集模块、SOH估算算法模块以及性能评估模块,并通过仿真验证SOH评估的准确性。

xiaoheshang_123的博客 342

鸿蒙5.0开发进阶:ArkTS API-BundleInfo

应用包信息......

Androidbye的博客 1302

Windows 11 安装 JDK 21:下载、安装、配置环境变量、验证

本文详细介绍了在 Windows 11 系统中安装 JDK 21 的完整流程,包括从 Oracle 官网下载压缩包、解压至自定义目录、配置 JAVA_HOME 与 Path 环境变量,并验证安装是否成功。文章推荐使用 ZIP 压缩包而非安装程序,以实现绿色便携、多版本共存等优势,并通过一个包含 Java 21 新特性的示例程序进行功能验证,适合开发者快速上手。

寒水馨 · 轻量级技术文档 · hanshuixin.org 2530

【鸿蒙next教程】企业设备管理:@ohos.enterprise.bundleManager(包管理)

本文介绍了鸿蒙5.0设备管理应用中的包管理模块.........

m0_73088370的博客 1026

AutoSAR配置视频讲解:简介

AutoSAR实验视频讲解:闪烁一颗LED实验【简介】 大家好,欢迎来到雪云飞星的《AutoSAR实验课的视频讲解》专栏。看过《AutoSAR入门到精通系列讲解》的朋友们应该对博主不陌生,有很多朋友加了博主的微信成为了好友,还有朋友约过线下见面,博主很高兴大家能从我的博客中获得一些收获。在专栏里博主挖了很多坑,当时也说过想要录制一个AutoSAR的配置视频教程,素材在20年初就已经录好,中间各种原因足足鸽了一年。当时因为一些技术原因只能通过博客的图文形式展示出来,现在我们剪辑了视频,请了专业的配音,希望以视

雪云飞星的博客 9658

Qt 国产嵌入式操作系统实现文字转语音功能(ekho库)

Qt 国产嵌入式操作系统实现文字转语音功能(TTS)_tts驱动 转文字-优快云博客在继上篇文章之后,甲方粑粑不满意使用eSpeak发出的声音太难听了,这就不得不找个替代品,声音稍微好听了一些。使用ekho开源库。Ekho(余音)是一个免费、开源的中文语音合成软件。它目前支持粤语、普通话(国语)、诏安客语、藏语、雅言(中国古代通用语)和韩语(试验中),英文则通过Festival间接实现。Ekho支持Linux、Windows和Android平台。

希望能帮助大家,希望大家多多支持,你们的支持是我前进的动力。 2757

鸿蒙NEXT开发:ArkData数据管理-@ohos.data.commonType (数据通用类型)

数据通用类型(commonType)是数据管理中通用的数据类型。

ZPYQAQ的博客 771

复分析 阿尔福斯(Ahlfors) 第三版答案 英文

答案分为十章,有部分习题没有答案,全英文复分析阿尔福斯(Ahlfors) 第三版答案

鸿蒙API13开发【@ohos.bundle (Bundle模块)】接口依赖的元素及定义

本模块提供应用信息查询能力,支持[包信息]、[应用信息]、[Ability组件信息]等信息的查询,以及应用禁用状态的查询、设置等。

鸿蒙的技术博客 1440

jre9下载 jdk9

(Java SE Runtime Environment 9.0) 9.0u175 官方最新版 【x86|x64】

ET2012新版免狗免安装绿色软件

ET2012新版免狗免安祖昂绿色软件。,新界面,新视觉,

鸿蒙API14开发【@ohos.enterprise.bundleManager(包管理)】短距通信服务

本模块提供包管理能力,包括添加包安装白名单、获取包安装白名单、移除包安装白名单等。

鸿蒙的技术博客 679

怀旧版电脑GBC模拟器

再现原版GBC掌机的界面,电脑运行连游戏界面都一样大小,很怀旧,很真实,(英文版)强烈推荐,很小的文件,很难才找到的。

鸿蒙5.0开发进阶:ArkTS API-ExtensionAbilityInfo

ExtensionAbility信息...........

Androidbye的博客 779

鸿蒙5.0开发【如何获取当前HAP的BundleName】应用运维

很多开发朋友不知道需要学习那些鸿蒙技术?鸿蒙开发岗位需要掌握那些核心技术点?为此鸿蒙的开发学习必须要系统性的进行。而网上有关鸿蒙的开发资料非常的少,假如你想学好鸿蒙的应用开发与系统底层开发。你可以参考这份资料,少走很多弯路,节省没必要的麻烦。由两位前阿里高级研发工程师联合打造的《鸿蒙NEXT星河版OpenHarmony开发文档》里面内容包含了(

鸿蒙的技术博客 711

鸿蒙5.0开发进阶:ArkTS API-AbilityInfo

Ability信息..........

Androidbye的博客 664

【HarmonyOS】通过bundleManager获取module.json5中的metadata数据

通过配合与,我们能够方便地读取中的自定义 metadata 配置。这种方式既能减少重复代码,也能确保配置项的唯一性与可维护性,适合在 SDK 集成或业务参数配置场景中使用。

weixin_44640245的博客 514

鸿蒙NEXT版实战开发:如何获取当前HAP的BundleName?

通过bundleManager模块的getBundleInfoForSelf接口获取所有信息

qq_39652397的博客 496

鸿蒙NEXT版实战开发:如何获取指定Bundle Name的Ability信息?

以异步方法根据给定的bundleFlags获取当前应用的BundleInfo,使用Promise形式返回结果。

qq_39652397的博客 338

鸿蒙应用程序包管理模块

BundleInfoBundleFlagBundleFlag用于精确控制返回的BundleInfo包含哪些内容。某些标志位(如获取Ability信息)需要与组合使用才生效。

BlackWolfSky的博客 537
上一篇: 鸿蒙5.0开发进阶:@ohos.continuation.continuationManager (continuationManager)
下一篇: 鸿蒙5.0开发进阶:@ohos.bundle.defaultAppManager (默认应用管理)
懂你的大海
博客等级 码龄6年 9049粉丝 1381原创
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付:10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值