# @ohos.bundle.bundleManager (应用程序包管理模块) > phone 12+ | 2in1 13+ | tablet 12+ | tv 19+ | wearable 18+ 本模块提供应用信息的查询能力，支持应用包信息[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)、应用程序信息[ApplicationInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-applicationinfo)、UIAbility组件信息[AbilityInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-abilityinfo)、ExtensionAbility组件信息[ExtensionAbilityInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-extensionabilityinfo)等信息的查询。 > 说明 > > 本模块首批接口从API version 9开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 ## 导入模块 ```ts import { bundleManager } from '@kit.AbilityKit'; ``` ## BundleFlag 包信息标志，指示需要获取的包信息的内容。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:----------------------------------------|:---------|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |GET_BUNDLE_INFO_DEFAULT|0x00000000|获取默认包信息，不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_APPLICATION|0x00000001|用于获取包含applicationInfo的bundleInfo，获取的bundleInfo不包含signatureInfo、hapModuleInfo、ability、extensionAbility和permission的信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_HAP_MODULE|0x00000002|用于获取包含hapModuleInfo的bundleInfo，获取的bundleInfo不包含signatureInfo、applicationInfo、ability、extensionAbility和permission的信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_ABILITY|0x00000004|用于获取包含ability的bundleInfo，获取的bundleInfo不包含signatureInfo、applicationInfo、extensionAbility和permission的信息。单独使用不生效，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY|0x00000008|用于获取包含extensionAbility的bundleInfo，获取的bundleInfo不包含signatureInfo、applicationInfo、ability 和permission的信息。单独使用不生效，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION|0x00000010|用于获取包含permission的bundleInfo。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、extensionAbility和ability的信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_METADATA|0x00000020|用于获取applicationInfo、moduleInfo、abilityInfo和extensionAbilityInfo中包含的metadata。单独使用不生效，它需要与GET_BUNDLE_INFO_WITH_APPLICATION、GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY配合使用，其中： - 获取applicationInfo中包含的metadata，需要与GET_BUNDLE_INFO_WITH_APPLICATION一起使用。 - 获取moduleInfo中包含的metadata，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。 - 获取abilityInfo中包含的metadata，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY一起使用。 - 获取extensionAbilityInfo中包含的metadata，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY一起使用。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_DISABLE|0x00000040|用于获取application被禁用的BundleInfo和被禁用的Ability信息。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_SIGNATURE_INFO|0x00000080|用于获取包含signatureInfo的bundleInfo。获取的bundleInfo不包含applicationInfo、hapModuleInfo、extensionAbility、ability和permission的信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_MENU^11+^|0x00000100|用于获取包含fileContextMenuConfig的bundleInfo。单独使用不生效，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_ROUTER_MAP^12+^|0x00000200|用于获取包含routerMap的bundleInfo。单独使用不生效，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_SKILL^12+^|0x00000800|用于获取包含skills的bundleInfo。单独使用不生效，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY一起使用。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。| |GET_BUNDLE_INFO_WITH_ENTRY_MODULE^23+^|0x00010000|用于获取包含hapModuleInfo的bundleInfo，仅支持entry模块对应的bundleInfo.hapModulesInfo，如果entry模块不存在，bundleInfo.hapModulesInfo列表为空。获取的bundleInfo不包含signatureInfo、applicationInfo、ability、extensionAbility和permission的信息。 **元服务API：** 从API version 23开始，该接口支持在元服务中使用。| ## ExtensionAbilityType 扩展组件的类型。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:---------------------------|:--|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |FORM|0|[FormExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-form-formextensionability)：卡片扩展能力，提供卡片开发能力。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |WORK_SCHEDULER|1|[WorkSchedulerExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-workschedulerextensionability)：延时任务扩展能力，允许应用在系统闲时执行实时性不高的任务。| |INPUT_METHOD|2|[InputMethodExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-inputmethod-extension-ability)：输入法扩展能力，用于开发输入法应用。| |ACCESSIBILITY|4|[AccessibilityExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-application-accessibilityextensionability)：无障碍服务扩展能力，支持访问与操作前台界面。| |BACKUP|9|[BackupExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-application-backupextensionability)：数据备份扩展能力，提供应用数据的备份恢复能力。| |ENTERPRISE_ADMIN|11|[EnterpriseAdminExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-enterpriseadminextensionability)：企业设备管理扩展能力，提供企业管理时处理管理事件的能力。| |SHARE^10+^|16|[ShareExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-shareextensionability)：提供分享业务能力，为开发者提供基于UIExtension的分享业务模板。| |DRIVER^10+^|18|[DriverExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-driverextensionability)：驱动扩展能力，提供外设驱动扩展能力。应用配置了driver类型的ExtensionAbility后会被视为驱动应用，驱动应用在安装、卸载和恢复时不会区分用户，且创建新用户时也会安装设备上已有的驱动应用。例如，创建子用户时会默认安装主用户已有的驱动应用，在子用户上卸载驱动应用时，主用户上对应的驱动应用也会同时被卸载。| |ACTION^10+^|19|[ActionExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-actionextensionability)：自定义服务扩展能力，为开发者提供基于UIExtension的自定义操作业务模板。| |EMBEDDED_UI^12+^|21|[EmbeddedUIExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-embeddeduiextensionability)：嵌入式UI扩展能力，提供跨进程界面嵌入的能力。| |INSIGHT_INTENT_UI^12+^|22|InsightIntentUIExtensionAbility：为开发者提供能被系统入口调用，以窗口形态呈现内容的扩展能力。| |FENCE^18+^|24|[FenceExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-fenceextensionability)：为开发者提供地理围栏相关的能力，继承自ExtensionAbility。| |ASSET_ACCELERATION^18+^|26|AssetAccelerationExtensionAbility：资源预下载扩展能力，提供在设备闲时状态，进行后台资源预下载的能力。| |FORM_EDIT^18+^|27|[FormEditExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-form-formeditextensionability)：为开发者提供卡片编辑的能力，继承自UIExtensionAbility。| |DISTRIBUTED^20+^|28|[DistributedExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-distributedextensionability)：提供分布式相关扩展能力，提供分布式创建、销毁、连接的生命周期回调。| |APP_SERVICE^20+^|29|[AppServiceExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-appserviceextensionability)：为企业普通应用提供后台服务能力。| |LIVE_FORM^20+^|30|[LiveFormExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-form-liveformextensionability)：互动卡片相关扩展能力，提供互动卡片创建、销毁的生命周期回调。 **元服务API：** 从API version 20开始，该接口支持在元服务中使用。| |SELECTION^24+^|31|[SelectionExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-selectioninput-selectionextensionability)：为开发者提供划词弹窗能力的ExtensionAbility。 **模型约束**：此接口仅可在Stage模型下使用。| |WEB_NATIVE_MESSAGING^21+^|32|[WebNativeMessagingExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-web-webnativemessagingextensionability)：为开发者提供Web消息通信能力的ExtensionAbility。| |FAULT_LOG^21+^|33|[FaultLogExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-hiviewdfx-faultlogextensionability)：提供故障延迟通知的能力。| |NOTIFICATION_SUBSCRIBER^22+^|34|[NotificationSubscriberExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-notificationsubscriberextensionability)：提供通知订阅的相关功能。| |CRYPTO^22+^|35|[CryptoExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/huks-extension-ability-support-dev)：提供外部密钥管理扩展的相关功能。| |PARTNER_AGENT^23+^|36|[PartnerAgentExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-fusionconnectivity-partneragentextensionability)：基于蓝牙通信技术，提供设备发现与设备下线的通知功能。 **模型约束**：此接口仅可在Stage模型下使用。| |AGENT^24+^|37|[AgentExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-agent-agentextensionability)：提供智能体扩展能力，包括智能体服务的创建、销毁、连接、断开的生命周期回调接口，以及接收客户端所发送数据和安全认证的回调接口。 **模型约束**：此接口仅可在Stage模型下使用。| |AGENT_UI^24+^|38|[AgentUIExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-agent-agentuiextensionability)：为开发者提供接入端侧Agent UI界面显示能力。 **模型约束**：此接口仅可在Stage模型下使用。| |MODULAR_OBJECT|39|[modular_object_extension_ability](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/capi-modular-object-extension-ability-h)：提供[模块化对象](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/modular-object-extension-overview)扩展能力，可以将应用自身功能封装为独立的功能模块，开放给其他应用使用。 **模型约束**：此接口仅可在Stage模型下使用。 **起始版本：** 26.0.0| |UNSPECIFIED|255|不指定类型。| |CALLER_INFO_QUERY^19+^|25|[CallerInfoQueryExtensionAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/callservicekit-callerinfoquery-extension-ability)：为开发者提供来去电信息查询能力。| ## PermissionGrantState 权限授予状态。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:-----------------|:-|:------| |PERMISSION_DENIED|-1|拒绝授予权限。| |PERMISSION_GRANTED|0|授予权限。| ## SupportWindowMode 标识该组件所支持的窗口模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:----------|:-|:---------------| |FULL_SCREEN|0|窗口支持全屏显示。| |SPLIT|1|窗口支持分屏显示。| |FLOATING|2|支持窗口化显示，即显示悬浮窗口。| ## LaunchType 标识组件的[启动模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/uiability-launch-type)。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:--------|:-|:----------------------------------------| |SINGLETON|0|UIAbility的启动模式，表示单实例。| |MULTITON|1|UIAbility的启动模式，表示普通多实例。| |SPECIFIED|2|UIAbility的启动模式，表示该UIAbility内部根据业务自己指定多实例。| ## AbilityType 标识Ability组件的类型。 **模型约束：** 仅可在FA模型下使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:------|:-|:------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |PAGE|1|UI界面类型的Ability。表示基于Page模板开发的FA，用于提供与用户交互的能力。| |SERVICE|2|后台服务类型的Ability，无UI界面。表示基于Service模板开发的[ParticleAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-ability-particleability)，用于提供后台运行任务的能力，例如后台下载或者播放音乐。| |DATA|3|表示基于Data模板开发的[ParticleAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-ability-particleability)，用于对外部提供统一的数据访问对象。| ## DisplayOrientation 标识该Ability的显示模式。仅适用于FA模型的[PageAbility](https://developer.huawei.com/consumer/cn/doc/lite-wearable-guides/pageability-overview)。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:---------------------------------|:-|:-------------------------------------------------------------------| |UNSPECIFIED|0|表示未定义方向模式，由系统判定。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |LANDSCAPE|1|表示横屏显示模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |PORTRAIT|2|表示竖屏显示模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |FOLLOW_RECENT|3|表示跟随上一个显示模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |LANDSCAPE_INVERTED|4|表示反向横屏显示模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |PORTRAIT_INVERTED|5|表示反向竖屏显示模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |AUTO_ROTATION|6|表示传感器在旋转到横向和竖向时，页面会自动旋转。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |AUTO_ROTATION_LANDSCAPE|7|表示传感器在旋转到横向时，页面会自动旋转。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |AUTO_ROTATION_PORTRAIT|8|表示传感器在旋转到竖向时，页面会自动旋转。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |AUTO_ROTATION_RESTRICTED|9|表示受开关控制的自动旋转模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |AUTO_ROTATION_LANDSCAPE_RESTRICTED|10|表示受开关控制的自动横向旋转模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |AUTO_ROTATION_PORTRAIT_RESTRICTED|11|表示受开关控制的自动竖向旋转模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |LOCKED|12|表示锁定模式。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。| |AUTO_ROTATION_UNSPECIFIED^12+^|13|受开关控制和由系统判定的自动旋转模式。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。| |FOLLOW_DESKTOP^12+^|14|跟随桌面的旋转模式。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。| ## CompatiblePolicy^10+^ 标识动态共享库的版本兼容类型。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:---------------------|:-|:----------| |BACKWARD_COMPATIBILITY|1|共享库是向后兼容类型。| ## ModuleType 标识模块类型。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:------|:-|:--------------------------------------------------------------------------------------| |ENTRY|1|应用的主模块，作为应用的入口，提供了应用的基础功能。| |FEATURE|2|应用的动态特性模块，作为应用能力的扩展，可以根据用户的需求和设备类型进行选择性安装。| |SHARED|3|应用的[动态共享库](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/in-app-hsp)模块。| ## BundleType 标识应用的类型。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:-------------|:-|:-----------| |APP|0|该Bundle是应用。| |ATOMIC_SERVICE|1|该Bundle是元服务。| ## MultiAppModeType^12+^ 标识应用多开的模式类型。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:-------------|:-|:--------------------------------------------------------------------------------------------------------------------------------------| |UNSPECIFIED|0|未指定类型，表示[multiAppMode配置](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#multiappmode标签)未配置时的默认状态。| |MULTI_INSTANCE|1|[多实例模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/multiinstance)。常驻进程不支持该字段。| |APP_CLONE|2|[分身模式](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-clone)。| ## AbilityFlag^20+^ Ability组件信息标志，指示需要获取的Ability组件信息的内容。 **元服务API：** 从API version 20开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |名称|值|说明| |:--------------------------------|:---------|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |GET_ABILITY_INFO_DEFAULT|0x00000000|获取默认[AbilityInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-abilityinfo)，获取的AbilityInfo不包含permissions、metadata、被禁用Ability对应的AbilityInfo。| |GET_ABILITY_INFO_WITH_PERMISSION|0x00000001|获取包含permissions的AbilityInfo。| |GET_ABILITY_INFO_WITH_APPLICATION|0x00000002|获取包含applicationInfo的AbilityInfo。| |GET_ABILITY_INFO_WITH_METADATA|0x00000004|获取包含metadata的AbilityInfo。| |GET_ABILITY_INFO_WITH_DISABLE|0x00000008|获取被禁用Ability对应的AbilityInfo。| |GET_ABILITY_INFO_ONLY_SYSTEM_APP|0x00000010|获取系统应用对应的AbilityInfo。| |GET_ABILITY_INFO_WITH_APP_LINKING|0x00000040|获取通过[域名校验](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-linking-startupapp#在modulejson5中配置关联的网址域名)筛选的AbilityInfo。| |GET_ABILITY_INFO_WITH_SKILL|0x00000080|获取包含skills的AbilityInfo。| ## bundleManager.getBundleInfoForSelf getBundleInfoForSelf(bundleFlags: number): Promise 根据给定的bundleFlags获取当前应用的BundleInfo。使用Promise异步回调。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------------------------------------------------------------------------------------------------------|:-----|:-|:---------------------| |[bundleFlags](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)|number|是|指定返回的BundleInfo所包含的信息。| **返回值：** |类型|说明| |:------------------------------------------------------------------------------------------------------------------------|:---------------------------| |Promise<[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)>|Promise对象，返回当前应用的BundleInfo。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。 |错误码ID|错误信息| |:----|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| **示例：** ```ts // 获取bundleInfo，包含带有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): void 根据给定的bundleFlags获取当前应用的BundleInfo。使用callback异步回调。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------|:-|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------| |[bundleFlags](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)|number|是|指定返回的BundleInfo所包含的信息。| |callback|AsyncCallback<[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)>|是|[AsyncCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#asynccallback)，当获取成功时，err为undefined，data为获取到的当前应用的BundleInfo；否则为错误对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。 |错误码ID|错误信息| |:----|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| **示例：** ```ts // 获取bundleInfo，包含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>): void 根据给定的moduleName、abilityName和metadataName（module.json5中[abilities标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#abilities标签)下的metadata标签的name）获取自身相应配置文件的json格式字符串。使用callback异步回调。 说明： 如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过[资源管理](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-resource-manager)的相关接口，来获取引用的资源。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:-----------|:---------------------------|:-|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |moduleName|string|是|表示Module名称。| |abilityName|string|是|表示UIAbility组件的名称。| |metadataName|string|是|表示UIAbility组件的[元信息名称](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#metadata标签)，即module.json5配置文件中[abilities标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#abilities标签)下的metadata标签的name。| |callback|AsyncCallback>|是|[AsyncCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#asynccallback)，当获取成功时，err为undefined，data为获取到的Array；否则为错误对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700002|The specified moduleName is not existed.| |17700003|The specified abilityName is not existed.| |17700024|Failed to get the profile because there is no profile in the HAP.| |17700029|The specified ability is disabled.| **示例：** ```ts 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> 根据给定的moduleName、abilityName和metadataName（module.json5中[abilities标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#abilities标签)下的metadata标签的name）获取自身相应配置文件的json格式字符串。使用Promise异步回调。 说明： 如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过[资源管理](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-resource-manager)的相关接口，来获取引用的资源。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:-----------|:-----|:-|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |moduleName|string|是|表示Module名称。| |abilityName|string|是|表示UIAbility组件的名称。| |metadataName|string|否|表示UIAbility组件的元信息名称，即module.json5配置文件中[abilities标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#abilities标签)下的metadata标签的name，默认值为空。| **返回值：** |类型|说明| |:---------------------|:-------------------------| |Promise>|Promise对象，返回Array。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700002|The specified moduleName is not existed.| |17700003|The specified abilityName is not existed.| |17700024|Failed to get the profile because there is no profile in the HAP.| |17700029|The specified ability is disabled.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let moduleName = 'entry'; let abilityName = 'EntryAbility'; try { // 通过模块名称和ability名称获取相应配置文件的json格式字符串信息 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); } ``` ```ts 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 { // 通过模块名称，ability名称和UIAbility组件的元信息名称获取自身相应配置文件的json格式字符串信息 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.getProfileByAbilitySync^10+^ getProfileByAbilitySync(moduleName: string, abilityName: string, metadataName?: string): Array 以同步方法根据给定的moduleName、abilityName和metadataName（module.json5中[metadata标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#metadata标签)下的name）获取自身相应配置文件的json格式字符串，返回对象为string数组。 如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过[资源管理](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-resource-manager)的相关接口，来获取引用的资源。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:-----------|:-----|:-|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |moduleName|string|是|表示Module名称。| |abilityName|string|是|表示UIAbility组件的名称。| |metadataName|string|否|表示UIAbility组件的元信息名称，即module.json5配置文件中[abilities标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#abilities标签)下的metadata标签的name，默认值为空。| **返回值：** |类型|说明| |:------------|:--------------------| |Array|数组对象，返回Array。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700002|The specified moduleName is not existed.| |17700003|The specified abilityName is not existed.| |17700024|Failed to get the profile because there is no profile in the HAP.| |17700029|The specified ability is disabled.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let moduleName = 'entry'; let abilityName = 'EntryAbility'; try { // 通过模块名称和ability名称获取相应配置文件的json格式字符串信息 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); } ``` ```ts 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 { // 通过模块名称，ability名称和UIAbility组件的元信息名称获取相应配置文件的json格式字符串信息 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>): void 根据给定的moduleName、extensionAbilityName和metadataName（module.json5中[metadata标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#metadata标签)下的name）获取自身相应配置文件的json格式字符串。使用callback异步回调。 如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过[资源管理](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-resource-manager)的相关接口，来获取引用的资源。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:-------------------|:---------------------------|:-|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |moduleName|string|是|表示Module名称。| |extensionAbilityName|string|是|表示ExtensionAbility组件的名称。| |metadataName|string|是|表示ExtensionAbility组件的元信息名称，即module.json5配置文件中[extensionAbilities标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#extensionabilities标签)下的metadata标签的name。| |callback|AsyncCallback>|是|[AsyncCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#asynccallback)，当获取成功时，err为undefined，data为获取到的Array；否则为错误对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700002|The specified moduleName is not existed.| |17700003|The specified extensionAbilityName not existed.| |17700024|Failed to get the profile because there is no profile in the HAP.| **示例：** ```ts 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> 根据给定的moduleName、extensionAbilityName和metadataName（module.json5中[metadata标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#metadata标签)下的name）获取自身相应配置文件的json格式字符串。使用Promise异步回调。 如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过[资源管理](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-resource-manager)的相关接口，来获取引用的资源。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:-------------------|:-----|:-|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |moduleName|string|是|表示Module名称。| |extensionAbilityName|string|是|表示ExtensionAbility组件的名称。| |metadataName|string|否|表示ExtensionAbility组件的元信息名称，即module.json5配置文件中[extensionAbilities标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#extensionabilities标签)下的metadata标签的name，默认值为空。| **返回值：** |类型|说明| |:---------------------|:---------------------------| |Promise>|Promise对象，返回Array对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700002|The specified moduleName is not existed.| |17700003|The specified extensionAbilityName not existed.| |17700024|Failed to get the profile because there is no profile in the HAP.| **示例：** ```ts 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.getProfileByExtensionAbilitySync^10+^ getProfileByExtensionAbilitySync(moduleName: string, extensionAbilityName: string, metadataName?: string): Array 以同步方法根据给定的moduleName、extensionAbilityName和metadataName（module.json5中[metadata标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#metadata标签)下的name）获取自身相应配置文件的json格式字符串，返回对象为string数组。 如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过[资源管理](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-resource-manager)的相关接口，来获取引用的资源。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:-------------------|:-----|:-|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |moduleName|string|是|表示Module名称。| |extensionAbilityName|string|是|表示ExtensionAbility组件的名称。| |metadataName|string|否|表示ExtensionAbility组件的元信息名称，即module.json5配置文件中[extensionAbilities标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#extensionabilities标签)下的metadata标签的name，默认值为空。| **返回值：** |类型|说明| |:------------|:-----------------| |Array|返回Array对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700002|The specified moduleName is not existed.| |17700003|The specified extensionAbilityName not existed.| |17700024|Failed to get the profile because there is no profile in the HAP.| **示例：** ```ts 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.getBundleInfoForSelfSync^10+^ getBundleInfoForSelfSync(bundleFlags: number): BundleInfo 以同步方法根据给定的bundleFlags获取当前应用的BundleInfo。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------------------------------------------------------------------------------------------------------|:-----|:-|:---------------------| |[bundleFlags](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)|number|是|指定返回的BundleInfo所包含的信息。| **返回值：** |类型|说明| |:---------------------------------------------------------------------------------------------------------------|:--------------| |[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)|返回BundleInfo对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。 |错误码ID|错误信息| |:----|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| **示例：** ```ts 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.canOpenLink^12+^ canOpenLink(link: string): boolean 根据给定的链接判断目标应用是否可访问，链接中的scheme需要在[module.json5文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)的querySchemes字段下配置。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:---|:-----|:-|:---------| |link|string|是|表示需要查询的链接。| **返回值：** |类型|说明| |:------|:------------------------------------| |boolean|返回true表示给定的链接可以打开，返回false表示给定的链接不能打开。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700055|The specified link is invalid.| |17700056|The scheme of the specified link is not in the querySchemes.| **示例：** ```ts 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); } ``` ## bundleManager.getLaunchWant^13+^ getLaunchWant(): Want 获取本应用[入口UIAbility](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-package-glossary#entry-uiability入口uiability)的Want参数。 **元服务API：** 从API version 13开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **返回值：** |类型|说明| |:-------------------------------------------------------------------------------------------------|:----------------------------------| |[Want](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-want)|返回仅包含bundleName和abilityName的Want对象。| **错误码：** 以下错误码的详细介绍请参见[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:----------------------------| |17700072|The launch want is not found.| **示例：** ```ts import { BusinessError } from '@kit.BasicServicesKit'; import { bundleManager } from '@kit.AbilityKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; try { let want = bundleManager.getLaunchWant(); hilog.info(0x0000, 'testTag', 'getLaunchWant ability name: %{public}s', want.abilityName); hilog.info(0x0000, 'testTag', 'getLaunchWant bundle name: %{public}s', want.bundleName); } catch (error) { let message = (error as BusinessError).message; hilog.error(0x0000, 'testTag', 'getLaunchWant failed: %{public}s', message); } ``` ## bundleManager.getBundleInfo^14+^ getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback): void 根据给定的bundleName、bundleFlags和userId获取[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)。使用callback异步回调。 获取调用方自身信息时不需要权限。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------|:-|:--------------------------------------------------------------------------------------------------------------------------------------------------------------| |bundleName|string|是|表示要查询的应用Bundle名称。| |[bundleFlags](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)|number|是|指定返回的BundleInfo所包含的信息。| |userId|number|是|表示用户ID，可以通过[getOsAccountLocalId](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-osaccount#getosaccountlocalid9)获取。| |callback|AsyncCallback<[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)>|是|[AsyncCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#asynccallback)，当获取成功时，err为undefined，data为获取到的BundleInfo；否则为错误对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700001|The specified bundleName is not found.| |17700004|The specified user ID is not found.| |17700026|The specified bundle is disabled.| **示例：** ```ts // 额外获取包含AbilityInfo信息的bundleInfo import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let bundleName = 'com.example.myapplication'; let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_ABILITY; let userId = 100; try { bundleManager.getBundleInfo(bundleName, bundleFlags, userId, (err, data) => { if (err) { hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); } else { hilog.info(0x0000, 'testTag', 'getBundleInfo successfully: %{public}s', JSON.stringify(data)); } }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); } ``` ```ts // 额外获取包含ApplicationInfo中的metadata的bundleInfo import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let bundleName = 'com.example.myapplication'; let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA; let userId = 100; try { bundleManager.getBundleInfo(bundleName, bundleFlags, userId, (err, data) => { if (err) { hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); } else { hilog.info(0x0000, 'testTag', 'getBundleInfo successfully: %{public}s', JSON.stringify(data)); } }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); } ``` ## bundleManager.getBundleInfo^14+^ getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback): void 根据给定的bundleName和bundleFlags获取BundleInfo。使用callback异步回调。 获取调用方自身的信息时不需要权限。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------------------------------------------------------------------------------------------------------|:------------------------------------------------------------------------------------------------------------------------------|:-|:--------------------------------------------------------------------------------------------------------------------------------------------------------------| |bundleName|string|是|表示要查询的应用Bundle名称。| |[bundleFlags](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)|number|是|指定返回的BundleInfo所包含的信息。| |callback|AsyncCallback<[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)>|是|[AsyncCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#asynccallback)，当获取成功时，err为undefined，data为获取到的BundleInfo；否则为错误对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700001|The specified bundleName is not found.| |17700026|The specified bundle is disabled.| **示例：** ```ts // 额外获取extensionAbility import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let bundleName = 'com.example.myapplication'; let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY; try { bundleManager.getBundleInfo(bundleName, bundleFlags, (err, data) => { if (err) { hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message); } else { hilog.info(0x0000, 'testTag', 'getBundleInfo successfully: %{public}s', JSON.stringify(data)); } }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message); } ``` ## bundleManager.getBundleInfo^14+^ getBundleInfo(bundleName: string, bundleFlags: number, userId?: number): Promise 根据给定的bundleName、bundleFlags和userId获取BundleInfo。使用Promise异步回调。 获取调用方自身的信息时不需要权限。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------------------------------------------------------------------------------------------------------|:-----|:-|:-------------------------------------------------------------------------------------------------------------------------------------------------------------------| |bundleName|string|是|表示要查询的应用Bundle名称。| |[bundleFlags](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)|number|是|指定返回的BundleInfo所包含的信息。| |userId|number|否|表示用户ID，可以通过[getOsAccountLocalId](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-osaccount#getosaccountlocalid9)获取，默认值：调用方所在用户，取值范围：大于等于0。| **返回值：** |类型|说明| |:------------------------------------------------------------------------------------------------------------------------|:----------------------| |Promise<[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)>|Promise对象，返回BundleInfo。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700001|The specified bundleName is not found.| |17700004|The specified user ID is not found.| |17700026|The specified bundle is disabled.| **示例：** ```ts // 额外获取ApplicationInfo和SignatureInfo import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let bundleName = 'com.example.myapplication'; let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO; let userId = 100; try { bundleManager.getBundleInfo(bundleName, bundleFlags, userId).then((data) => { hilog.info(0x0000, 'testTag', 'getBundleInfo successfully. Data: %{public}s', JSON.stringify(data)); }).catch((err: BusinessError) => { hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', err.message); }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', message); } ``` ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let bundleName = 'com.example.myapplication'; let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT; try { bundleManager.getBundleInfo(bundleName, bundleFlags).then((data) => { hilog.info(0x0000, 'testTag', 'getBundleInfo successfully. Data: %{public}s', JSON.stringify(data)); }).catch((err: BusinessError) => { hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', err.message); }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', message); } ``` ## bundleManager.getBundleInfoSync^14+^ getBundleInfoSync(bundleName: string, bundleFlags: number, userId: number): BundleInfo 以同步方法根据给定的bundleName、bundleFlags和userId获取BundleInfo。 获取调用方自身的信息时不需要权限。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------------------------------------------------------------------------------------------------------|:-----|:-|:--------------------------------------------------------------------------------------------------------------------------------------------| |bundleName|string|是|表示要查询的应用Bundle名称。| |[bundleFlags](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)|number|是|指定返回的BundleInfo所包含的信息。| |userId|number|是|表示用户ID，可以通过[getOsAccountLocalId](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-osaccount#getosaccountlocalid9)获取。| **返回值：** |类型|说明| |:---------------------------------------------------------------------------------------------------------------|:--------------| |[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)|返回BundleInfo对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700001|The specified bundleName is not found.| |17700004|The specified user ID is not found.| |17700026|The specified bundle is disabled.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let bundleName = 'com.example.myapplication'; let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION; let userId = 100; try { let data = bundleManager.getBundleInfoSync(bundleName, bundleFlags, userId); hilog.info(0x0000, 'testTag', 'getBundleInfoSync successfully: %{public}s', JSON.stringify(data)); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleInfoSync failed: %{public}s', message); } ``` ## bundleManager.getBundleInfoSync^14+^ getBundleInfoSync(bundleName: string, bundleFlags: number): BundleInfo 以同步方法根据给定的bundleName、bundleFlags获取调用方所在用户下的BundleInfo。 获取调用方自身的信息时不需要权限。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------------------------------------------------------------------------------------------------------|:-----|:-|:---------------------| |bundleName|string|是|表示要查询的应用Bundle名称。| |[bundleFlags](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)|number|是|指定返回的BundleInfo所包含的信息。| **返回值：** |类型|说明| |:---------------------------------------------------------------------------------------------------------------|:--------------| |[BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo)|返回BundleInfo对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700001|The specified bundleName is not found.| |17700026|The specified bundle is disabled.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let bundleName = 'com.example.myapplication'; let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION; try { let data = bundleManager.getBundleInfoSync(bundleName, bundleFlags); hilog.info(0x0000, 'testTag', 'getBundleInfoSync successfully: %{public}s', JSON.stringify(data)); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleInfoSync failed: %{public}s', message); } ``` ## bundleManager.getBundleNameByUid^14+^ getBundleNameByUid(uid: number, callback: AsyncCallback): void 根据给定的uid获取对应应用的bundleName。使用callback异步回调。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:-------|:--------------------|:-|:--------------------------------------------------------------------------------------------------------------------------------------------------------------| |uid|number|是|表示应用程序的UID。| |callback|AsyncCallback|是|[AsyncCallback](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-base#asynccallback)，当获取成功时，err为undefined，data为获取到的BundleName；否则为错误对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700021|The uid is not found.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let uid = 20010005; try { bundleManager.getBundleNameByUid(uid, (err, data) => { if (err) { hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', err.message); } else { hilog.info(0x0000, 'testTag', 'getBundleNameByUid successfully: %{public}s', JSON.stringify(data)); } }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message); } ``` ## bundleManager.getBundleNameByUid^14+^ getBundleNameByUid(uid: number): Promise 根据给定的uid获取对应应用的bundleName。使用Promise异步回调。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:--|:-----|:-|:----------| |uid|number|是|表示应用程序的UID。| **返回值：** |类型|说明| |:--------------|:----------------------| |Promise|Promise对象，返回bundleName。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700021|The uid is not found.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let uid = 20010005; try { bundleManager.getBundleNameByUid(uid).then((data) => { hilog.info(0x0000, 'testTag', 'getBundleNameByUid successfully. Data: %{public}s', JSON.stringify(data)); }).catch((err: BusinessError) => { hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed. Cause: %{public}s', err.message); }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed. Cause: %{public}s', message); } ``` ## bundleManager.getBundleNameByUidSync^14+^ getBundleNameByUidSync(uid: number): string 以同步方法根据给定的uid获取对应应用的bundleName。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:--|:-----|:-|:----------| |uid|number|是|表示应用程序的UID。| **返回值：** |类型|说明| |:-----|:----------------| |string|返回获取到的bundleName。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700021|The uid is not found.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let uid = 20010005; try { let data = bundleManager.getBundleNameByUidSync(uid); hilog.info(0x0000, 'testTag', 'getBundleNameByUidSync successfully. Data: %{public}s', JSON.stringify(data)); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getBundleNameByUidSync failed. Cause: %{public}s', message); } ``` ## bundleManager.getAppCloneIdentity^14+^ getAppCloneIdentity(uid: number): Promise; 根据uid查询分身应用的包名和分身索引。使用Promise异步回调。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO * 当调用方为三方应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED权限。 * 当调用方为系统应用时，需要申请ohos.permission.GET_BUNDLE_INFO_PRIVILEGED或者ohos.permission.GET_BUNDLE_INFO权限。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:--|:-----|:-|:----------| |uid|number|是|表示应用程序的UID。| **返回值：** |类型|说明| |:-------------------------------------------------------------------------------------------------------------------------------------------------|:------------------------------| |Promise<[AppCloneIdentity](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#appcloneidentity14)>|Promise对象，返回AppCloneIdentity信息。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700021|The uid is not found.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let uid = 20010005; try { bundleManager.getAppCloneIdentity(uid).then((res) => { hilog.info(0x0000, 'testTag', 'getAppCloneIdentity res = %{public}s', JSON.stringify(res)); }).catch((err: BusinessError) => { hilog.error(0x0000, 'testTag', 'getAppCloneIdentity failed. Cause: %{public}s', err.message); }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getAppCloneIdentity failed. Cause: %{public}s', message); } ``` ## bundleManager.getSignatureInfo^18+^ getSignatureInfo(uid: number): SignatureInfo 根据给定的uid获取对应应用的[签名信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#signatureinfo)。 **需要权限：** ohos.permission.GET_SIGNATURE_INFO **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:--|:-----|:-|:----------| |uid|number|是|表示应用程序的UID。| **返回值：** |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------|:-----------------| |[SignatureInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#signatureinfo)|返回SignatureInfo对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:--------------------| |201|Permission denied.| |17700021|The uid is not found.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let uid = 20010005; // uid需要替换为对应应用程序的UID。 try { let data = bundleManager.getSignatureInfo(uid); hilog.info(0x0000, 'testTag', 'getSignatureInfo successfully. Data: %{public}s', JSON.stringify(data)); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getSignatureInfo failed. Cause: %{public}s', message); } ``` ## bundleManager.getAbilityInfo^20+^ getAbilityInfo(uri: string, abilityFlags: number): Promise> 获取指定资源标识符和组件信息标志对应的Ability信息。使用Promise异步回调。 **元服务API：** 从API version 20开始，该接口支持在元服务中使用。 **需要权限：** ohos.permission.GET_ABILITY_INFO **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **设备行为差异：** 该接口仅在PC/2in1设备中可正常调用，在其他设备中返回201错误码。 **参数：** |参数名|类型|必填|说明| |:-----------|:-----|:-|:------------------------------------------------------------------------------------------------------------------------------------------------------| |uri|string|是|表示统一资源标识符URI，取值与[module.json5配置文件中skills下的uris字段](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#skills标签)相对应。| |abilityFlags|number|是|表示[Ability组件信息标志](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#abilityflag20)，指示需要获取的Ability组件信息的内容。| **返回值：** |类型|说明| |:---------------------------------------------------------------------------------------------------------------------------------|:---------------------------| |Promise>|Promise对象，返回获取到的Ability信息数组。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------| |201|Permission denied.| |17700003|The ability is not found.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_WITH_APPLICATION; let uri = "https://www.example.com"; try { bundleManager.getAbilityInfo(uri, abilityFlags).then((data) => { hilog.info(0x0000, 'testTag', 'getAbilityInfo successfully. Data: %{public}s', JSON.stringify(data)); }).catch((err: BusinessError) => { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getAbilityInfo failed. Cause: %{public}s', message); }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getAbilityInfo failed. Cause: %{public}s', message); } ``` ## bundleManager.cleanBundleCacheFilesForSelf^21+^ cleanBundleCacheFilesForSelf(): Promise 清理应用自身的缓存。使用Promise异步回调。 **元服务API：** 从API version 21开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **返回值：** |类型|说明| |:------------|:---------------| |Promise|Promise对象，无返回结果。| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; bundleManager.cleanBundleCacheFilesForSelf().then(() => { hilog.info(0x0000, 'testTag', 'cleanBundleCacheFilesForSelf complete.'); }); ``` ## bundleManager.getPluginBundlePathForSelf^22+^ getPluginBundlePathForSelf(pluginBundleName: string): string 获取指定插件在当前[应用沙箱](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-sandbox-directory)内的安装路径。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:---------------|:-----|:-|:-------| |pluginBundleName|string|是|目标插件的包名。| **返回值：** |类型|说明| |:-----|:-----------------| |string|目标插件在当前应用沙箱内的安装路径。| **错误码：** 错误码请参见[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:-------------------------------------| |17700001|The specified bundleName is not found.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; // 请开发者替换为实际插件对应的包名 let pluginBundleName = 'com.ohos.pluginDemo'; try { let path = bundleManager.getPluginBundlePathForSelf(pluginBundleName); hilog.info(0x0000, 'testTag', 'getPluginBundlePathForSelf successfully. path: %{public}s', path); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getPluginBundlePathForSelf failed. Cause: %{public}s', message); } ``` ## bundleManager.getLaunchWantForBundleSync^24+^ getLaunchWantForBundleSync(bundleName: string, userId?: number): Want 根据给定的包名和用户ID，获取用于启动应用程序的Want参数。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 (ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 和 ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS) * 获取用于启动当前用户下的应用程序所需的Want参数时，需要申请权限ohos.permission.GET_BUNDLE_INFO_PRIVILEGED。 * 获取用于启动其他用户下的应用程序所需的Want参数时，如果调用方是系统应用，需要申请权限ohos.permission.GET_BUNDLE_INFO_PRIVILEGED，如果调用方是三方应用需要申请权限ohos.permission.GET_BUNDLE_INFO_PRIVILEGED和ohos.permission.INTERACT_ACROSS_LOCAL_ACCOUNTS。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:---------|:-----|:-|:---------------------------------------------------------------------------------------------------------------------------------------------------------------------| |bundleName|string|是|表示应用的包名。| |userId|number|否|表示用户ID，可以通过[getOsAccountLocalId](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-osaccount#getosaccountlocalid9)获取。 默认值：调用方所在用户。 取值范围：大于等于0。| **返回值：** |类型|说明| |:------------------------------------------------------------------------------------------------------|:------| |[Want](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-want#want)|Want对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------------------------| |201|Permission denied.| |401|Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| |17700001|The specified bundle is not found.| |17700004|The specified user id is not found.| |17700026|The specified bundle is disabled.| **示例：** ```ts // 示例接口含有userId参数，获取用于启动指定用户下的应用程序所需的Want参数 import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; import { Want } from '@kit.AbilityKit'; let bundleName = 'com.example.myapplication'; let userId = 100; try { let want: Want = bundleManager.getLaunchWantForBundleSync(bundleName, userId); hilog.info(0x0000, 'testTag', 'getLaunchWantForBundleSync successfully. Data: %{public}s', JSON.stringify(want)); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getLaunchWantForBundleSync failed. Cause: %{public}s', message); } ``` ```ts // 示例接口不含userId参数，获取用于启动当前用户下的应用程序所需的Want参数 import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; import { Want } from '@kit.AbilityKit'; let bundleName = 'com.example.myapplication'; try { let want: Want = bundleManager.getLaunchWantForBundleSync(bundleName); hilog.info(0x0000, 'testTag', 'getLaunchWantForBundleSync successfully. Data: %{public}s', JSON.stringify(want)); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getLaunchWantForBundleSync failed. Cause: %{public}s', message); } ``` ## bundleManager.getApplicationLabel getApplicationLabel(bundleName: string, appIndex: number): Promise 获取指定包名和分身索引的应用名称。使用Promise异步回调。 **起始版本：** 26.0.0 **模型约束：** 此接口仅可在Stage模型下使用。 **需要权限：** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED **系统能力：** SystemCapability.BundleManager.BundleFramework.Resource **参数：** |参数名|类型|必填|说明| |:---------|:-----|:-|:---------------------------------------| |bundleName|string|是|应用的包名。| |appIndex|number|是|表示应用索引。取值范围0~5，取值为0表示主应用，取值1~5表示分身应用的索引。| **返回值：** |类型|说明| |:--------------|:-------------------------------| |Promise|Promise对象，调用成功返回应用名称；调用失败返回错误对象。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)和[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:----------------------------------| |201|Permission denied.| |17700001|The specified bundle is not found.| |17700061|The specified app index is invalid.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; try { bundleManager.getApplicationLabel('com.hap.myapplication', 1).then((data: string) => { hilog.info(0x0000, 'testTag', 'getApplicationLabel succeed: Data: %{public}s', data); }).catch((err: BusinessError) => { hilog.error(0x0000, 'testTag', 'getApplicationLabel failed: %{public}d %{public}s', err.code, err.message); }); } catch (err) { hilog.error(0x0000, 'testTag', 'getApplicationLabel failed: error %{public}d %{public}s', err.code, err.message); } ``` ## bundleManager.getInstalledBundleList getInstalledBundleList(bundleFlags: number): Promise> 根据给定的bundleFlags获取系统中所有的BundleInfo。使用Promise异步回调。 **起始版本：** 26.0.0 **模型约束：** 此接口仅可在Stage模型下使用。 **需要权限：** ohos.permission.ENTERPRISE_GET_INSTALLED_BUNDLE_LIST **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **设备行为差异：** 该接口仅在PC/2in1设备中可正常调用，在其他设备中返回201错误码。 **参数：** |参数名|类型|必填|说明| |:----------|:-----|:-|:-------------------------------------------------------------------------------------------------------------------------------------------| |bundleFlags|number|是|指定返回的BundleInfo所包含的信息，详情请参考[BundleFlag](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager#bundleflag)。| **返回值：** |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------------------|:------------------------| |Promise>|Promise对象，返回当前已安装应用的信息列表。| **错误码：** 以下错误码的详细介绍请参见[通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-universal)。 |错误码ID|错误信息| |:----|:-----------------| |201|Permission denied.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT; try { bundleManager.getInstalledBundleList(bundleFlags).then((data) => { hilog.info(0x0000, 'testTag', 'getInstalledBundleList successfully. Data: %{public}s', JSON.stringify(data)); }).catch((err: BusinessError) => { hilog.error(0x0000, 'testTag', 'getInstalledBundleList failed. Cause: %{public}s', err.message); }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getInstalledBundleList failed. Cause: %{public}s', message); } ``` ## bundleManager.setAlternateIcon setAlternateIcon(alternateIconName: string): Promise; 根据给定的备用图标名称设置调用方自身的备用图标。使用Promise异步回调。 **起始版本：** 26.0.0 **模型约束：** 此接口仅可在Stage模型下使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **参数：** |参数名|类型|必填|说明| |:----------------|:-----|:-|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| |alternateIconName|string|是|要设置的备用图标名称。备用图标名称须在app.json5中[alternateIcons标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#alternateicons标签)的name字段内。 alternateIconName为空时表示取消备用图标。| **返回值：** |类型|说明| |:------------|:---------------| |Promise|Promise对象。无返回结果。| **错误码：** 以下错误码的详细介绍请参见[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:------------------------------------------------------------------------------------------| |17700308|The alternateIconName must match the name field under alternateIcons in the app.json5 file.| |17700309|No alternate icon is enabled.| |17700310|Failed to set the alternate icon.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; // alternateIconName需要替换为要设置的备用图标名称 let alternateIconName: string = 'com.ohos.demo'; try { bundleManager.setAlternateIcon(alternateIconName).then((data) => { hilog.info(0x0000, 'testTag', 'setAlternateIcon successfully'); }).catch((err: BusinessError) => { hilog.error(0x0000, 'testTag', 'setAlternateIcon failed. Cause: %{public}s', err.message); }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'setAlternateIcon failed. Cause: %{public}s', message); } ``` ## bundleManager.getAlternateIcons getAlternateIcons(): Promise> 查询当前应用在app.json5中[alternateIcons标签](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-configuration-file#alternateicons标签)配置的备用图标信息。使用Promise异步回调。 **起始版本：** 26.0.0 **模型约束：** 此接口仅可在Stage模型下使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core **返回值：** |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------------------------------|:-------------------------| |Promise>|Promise对象，返回当前应用的备用图标信息列表。| **错误码：** 以下错误码的详细介绍请参见[包管理子系统通用错误码](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/errorcode-bundle)。 |错误码ID|错误信息| |:-------|:-----------------------------------| |17700311|Failed to obtain the alternate icon.| **示例：** ```ts import { bundleManager } from '@kit.AbilityKit'; import { BusinessError } from '@kit.BasicServicesKit'; import { hilog } from '@kit.PerformanceAnalysisKit'; try { bundleManager.getAlternateIcons().then((data) => { hilog.info(0x0000, 'testTag', 'getAlternateIcons successfully. Data: %{public}s', JSON.stringify(data)); }).catch((err: BusinessError) => { hilog.error(0x0000, 'testTag', 'getAlternateIcons failed. Cause: %{public}s', err.message); }); } catch (err) { let message = (err as BusinessError).message; hilog.error(0x0000, 'testTag', 'getAlternateIcons failed. Cause: %{public}s', message); } ``` ## ApplicationInfo type ApplicationInfo = _ApplicationInfo 应用程序信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------------------|:------| |[_ApplicationInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-applicationinfo#applicationinfo-1)|应用程序信息。| ## ModuleMetadata^10+^ type ModuleMetadata = _ModuleMetadata 模块的元数据信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:------------------------------------------------------------------------------------------------------------------------------------------|:--------| |[_ModuleMetadata](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-applicationinfo#modulemetadata10)|模块的元数据信息。| ## Metadata type Metadata = _Metadata 元数据信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:-----------------------------------------------------------------------------------------------------------------------|:-----| |[_Metadata](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-metadata#metadata-1)|元数据信息。| ## BundleInfo type BundleInfo = _BundleInfo.BundleInfo 应用包信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力**: SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:----------------------------------------------------------------------------------------------------------------------------------------|:-----| |[_BundleInfo.BundleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#bundleinfo-1)|应用包信息。| ## UsedScene type UsedScene = _BundleInfo.UsedScene 权限使用的场景和时机。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:------------------------------------------------------------------------------------------------------------------------------------|:----------| |[_BundleInfo.UsedScene](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#usedscene)|权限使用的场景和时机。| ## ReqPermissionDetail type ReqPermissionDetail = _BundleInfo.ReqPermissionDetail 应用运行时需向系统申请的权限集合的详细信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------------------------------|:---------------------| |[_BundleInfo.ReqPermissionDetail](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#reqpermissiondetail)|应用运行时需向系统申请的权限集合的详细信息。| ## SignatureInfo type SignatureInfo = _BundleInfo.SignatureInfo 应用包的签名信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------------------|:--------| |[_BundleInfo.SignatureInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#signatureinfo)|应用包的签名信息。| ## HapModuleInfo type HapModuleInfo = _HapModuleInfo.HapModuleInfo 模块信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:----------------------------------------------------------------------------------------------------------------------------------------------------|:----| |[_HapModuleInfo.HapModuleInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-hapmoduleinfo#hapmoduleinfo-1)|模块信息。| ## PreloadItem type PreloadItem = _HapModuleInfo.PreloadItem 元服务中模块的预加载模块信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:----------------------------------------------------------------------------------------------------------------------------------------------|:--------------| |[_HapModuleInfo.PreloadItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-hapmoduleinfo#preloaditem)|元服务中模块的预加载模块信息。| ## Dependency type Dependency = _HapModuleInfo.Dependency 模块所依赖的动态共享库信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------------------|:-------------| |[_HapModuleInfo.Dependency](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-hapmoduleinfo#dependency)|模块所依赖的动态共享库信息。| ## RouterItem^12+^ type RouterItem = _HapModuleInfo.RouterItem 模块配置的路由表信息。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:----------------------------------------------------------------------------------------------------------------------------------------------|:----------| |[_HapModuleInfo.RouterItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-hapmoduleinfo#routeritem12)|模块配置的路由表信息。| ## DataItem^12+^ type DataItem = _HapModuleInfo.DataItem 模块配置的路由表中的自定义数据。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:------------------------------------------------------------------------------------------------------------------------------------------|:---------------| |[_HapModuleInfo.DataItem](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-hapmoduleinfo#dataitem12)|模块配置的路由表中的自定义数据。| ## AbilityInfo type AbilityInfo = _AbilityInfo.AbilityInfo Ability信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------------------|:---------| |[_AbilityInfo.AbilityInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-abilityinfo#abilityinfo-1)|Ability信息。| ## WindowSize type WindowSize = _AbilityInfo.WindowSize 窗口尺寸。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:----------------------------------------------------------------------------------------------------------------------------------------|:----| |[_AbilityInfo.WindowSize](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-abilityinfo#windowsize)|窗口尺寸。| ## ExtensionAbilityInfo type ExtensionAbilityInfo = _ExtensionAbilityInfo.ExtensionAbilityInfo ExtensionAbility信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|:------------------| |[_ExtensionAbilityInfo.ExtensionAbilityInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-extensionabilityinfo#extensionabilityinfo-1)|ExtensionAbility信息。| ## ElementName type ElementName = _ElementName ElementName信息。 **元服务API：** 从API version 11开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:--------------------------------------------------------------------------------------------------------------------------------|:-------------| |[_ElementName](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-elementname#elementname-1)|ElementName信息。| ## Skill^12+^ type Skill = _Skill.Skill Skill信息。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:--------------------------------------------------------------------------------------------------------------------|:-------| |[_Skill.Skill](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-skill#skill-1)|Skill信息。| ## SkillUrl^12+^ type SkillUrl = _Skill.SkillUri SkillUri信息。 **元服务API：** 从API version 12开始，该接口支持在元服务中使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:------------------------------------------------------------------------------------------------------------------------|:----------| |[_Skill.SkillUri](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-skill#skilluri)|SkillUri信息。| ## AppCloneIdentity^15+^ type AppCloneIdentity = _BundleInfo.AppCloneIdentity 描述应用包的身份信息。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:----------------------------------------------------------------------------------------------------------------------------------------------------|:--------| |[_BundleInfo.AppCloneIdentity](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#appcloneidentity14)|应用包的身份信息。| ## AlternateIconInfo type AlternateIconInfo = _BundleInfo.AlternateIconInfo 应用备用图标信息。 **起始版本：** 26.0.0 **模型约束：** 此接口仅可在Stage模型下使用。 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core |类型|说明| |:----------------------------------------------------------------------------------------------------------------------------------------------------|:---------| |[_BundleInfo.AlternateIconInfo](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-bundlemanager-bundleinfo#alternateiconinfo)|应用的备用图标信息。|