1# @ohos.bundle.bundleManager (bundleManager模块) 2 3本模块提供应用信息查询能力，支持[BundleInfo](js-apis-bundleManager-bundleInfo.md)、[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)、[AbilityInfo](js-apis-bundleManager-abilityInfo.md)、[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)等信息的查询。 4 5> **说明：** 6> 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 7 8## 导入模块 9 10```ts 11import { bundleManager } from '@kit.AbilityKit'; 12``` 13 14## 枚举 15 16### BundleFlag 17 18包信息标志，指示需要获取的包信息的内容。 19 20 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 21 22| 名称 | 值 | 说明 | 23| --------------------------------------------- | ---------- | ------------------------------------------------------------ | 24| GET_BUNDLE_INFO_DEFAULT | 0x00000000 | 用于获取默认bundleInfo，获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 25| GET_BUNDLE_INFO_WITH_APPLICATION | 0x00000001 | 用于获取包含applicationInfo的bundleInfo，获取的bundleInfo不包含signatureInfo、hapModuleInfo、ability、extensionAbility和permission的信息。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 26| GET_BUNDLE_INFO_WITH_HAP_MODULE | 0x00000002 | 用于获取包含hapModuleInfo的bundleInfo，获取的bundleInfo不包含signatureInfo、applicationInfo、ability、extensionAbility和permission的信息。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 27| GET_BUNDLE_INFO_WITH_ABILITY | 0x00000004 | 用于获取包含ability的bundleInfo，获取的bundleInfo不包含signatureInfo、applicationInfo、extensionAbility和permission的信息。它不能单独使用，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 28| GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY | 0x00000008 | 用于获取包含extensionAbility的bundleInfo，获取的bundleInfo不包含signatureInfo、applicationInfo、ability 和permission的信息。它不能单独使用，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 29| GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION | 0x00000010 | 用于获取包含permission的bundleInfo。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、extensionAbility和ability的信息。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 30| GET_BUNDLE_INFO_WITH_METADATA | 0x00000020 | 用于获取applicationInfo、moduleInfo和abilityInfo中包含的metadata。它不能单独使用，它需要与GET_BUNDLE_INFO_WITH_APPLICATION、GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY一起使用。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 31| GET_BUNDLE_INFO_WITH_DISABLE | 0x00000040 | 用于获取application被禁用的BundleInfo和被禁用的Ability信息。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 32| GET_BUNDLE_INFO_WITH_SIGNATURE_INFO | 0x00000080 | 用于获取包含signatureInfo的bundleInfo。获取的bundleInfo不包含applicationInfo、hapModuleInfo、extensionAbility、ability和permission的信息。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 33| GET_BUNDLE_INFO_WITH_MENU<sup>11+</sup> | 0x00000100 | 用于获取包含fileContextMenuConfig的bundleInfo。它不能单独使用，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 34| GET_BUNDLE_INFO_WITH_ROUTER_MAP<sup>12+</sup> | 0x00000200 | 用于获取包含routerMap的bundleInfo。它不能单独使用，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 35| GET_BUNDLE_INFO_WITH_SKILL<sup>12+</sup> | 0x00000800 | 用于获取包含skills的bundleInfo。它不能单独使用，需要与GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY一起使用。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | 36 37### ExtensionAbilityType 38 39指示扩展组件的类型。 40 41 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 42 43| 名称 | 值 | 说明 | 44|:----------------:|:---:|-----| 45| FORM | 0 | [FormExtensionAbility](../apis-form-kit/js-apis-app-form-formExtensionAbility.md)：卡片扩展能力，提供卡片开发能力。<br>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 46| WORK_SCHEDULER | 1 | [WorkSchedulerExtensionAbility](../apis-backgroundtasks-kit/js-apis-WorkSchedulerExtensionAbility.md)：延时任务扩展能力，允许应用在系统闲时执行实时性不高的任务。 | 47| INPUT_METHOD | 2 | [InputMethodExtensionAbility](../apis-ime-kit/js-apis-inputmethod-extension-ability.md)：输入法扩展能力，用于开发输入法应用。 | 48| SERVICE | 3 | <!--Del-->[<!--DelEnd-->ServiceExtensionAbility<!--Del-->](js-apis-app-ability-serviceExtensionAbility-sys.md)<!--DelEnd-->：后台服务扩展能力，提供后台运行并对外提供相应能力。 | 49| ACCESSIBILITY | 4 | <!--RP1-->[AccessibilityExtensionAbility](../apis-accessibility-kit/js-apis-inner-application-accessibilityExtensionContext.md)<!--RP1End-->：无障碍服务扩展能力，支持访问与操作前台界面。 | 50| DATA_SHARE | 5 | <!--Del-->[<!--DelEnd-->DataShareExtensionAbility <!--Del-->](../apis-arkdata/js-apis-application-dataShareExtensionAbility-sys.md)<!--DelEnd-->：数据共享扩展能力，用于对外提供数据读写服务。 | 51| FILE_SHARE | 6 | FileShareExtensionAbility：文件共享扩展能力，用于应用间的文件分享。预留能力，仅系统应用支持。 | 52| STATIC_SUBSCRIBER| 7 | <!--Del-->[<!--DelEnd-->StaticSubscriberExtensionAbility <!--Del-->](../apis-basic-services-kit/js-apis-application-staticSubscriberExtensionAbility-sys.md)<!--DelEnd-->：静态广播扩展能力，用于处理静态事件，比如开机事件。 | 53| WALLPAPER | 8 | WallpaperExtensionAbility：壁纸扩展能力，用于实现桌面壁纸。预留能力，仅系统应用支持。 | 54| BACKUP | 9 | [BackupExtensionAbility](../apis-core-file-kit/js-apis-application-backupExtensionAbility.md)：数据备份扩展能力，提供应用数据的备份恢复能力。 | 55| WINDOW | 10 | <!--Del-->[<!--DelEnd-->WindowExtensionAbility<!--Del-->](../apis-arkui/js-apis-application-windowExtensionAbility-sys.md)<!--DelEnd-->：界面组合扩展能力，允许系统应用进行跨应用的界面拉起和嵌入。 | 56| ENTERPRISE_ADMIN | 11 | [EnterpriseAdminExtensionAbility](../apis-mdm-kit/js-apis-EnterpriseAdminExtensionAbility.md)：企业设备管理扩展能力，提供企业管理时处理管理事件的能力，比如设备上应用安装事件、锁屏密码输入错误次数过多事件等。 | 57| THUMBNAIL | 13 | ThumbnailExtensionAbility：文件缩略图扩展能力，用于为文件提供图标缩略图的能力。预留能力，仅系统应用支持。 | 58| PREVIEW | 14 | PreviewExtensionAbility：文件预览扩展能力，提供文件预览的能力，其他应用可以直接在应用中嵌入显示。预留能力，仅系统应用支持。 | 59| PRINT<sup>10+</sup> | 15 | PrintExtensionAbility：文件打印扩展能力，提供应用打印照片、文档等办公场景。仅系统应用支持。 | 60| SHARE<sup>10+</sup> | 16 | [ShareExtensionAbility](js-apis-app-ability-shareExtensionAbility.md)：提供分享业务能力，为开发者提供基于UIExtension的分享业务模板。 | 61| PUSH<sup>10+</sup> | 17 | PushExtensionAbility：推送扩展能力，提供推送场景化消息能力。预留能力，仅系统应用支持。 | 62| DRIVER<sup>10+</sup> | 18 | [DriverExtensionAbility](../apis-driverdevelopment-kit/js-apis-app-ability-driverExtensionAbility.md)：驱动扩展能力，提供外设驱动扩展能力，仅系统应用支持。 | 63| ACTION<sup>10+</sup> | 19 | [ActionExtensionAbility](js-apis-app-ability-actionExtensionAbility.md)：自定义服务扩展能力，为开发者提供基于UIExtension的自定义操作业务模板。 | 64| ADS_SERVICE<sup>11+</sup> | 20 | AdsServiceExtensionAbility：广告服务扩展能力，对外提供后台自定义广告业务服务，仅系统应用支持。 | 65| EMBEDDED_UI<sup>12+</sup> | 21 | [EmbeddedUIExtensionAbility](js-apis-app-ability-embeddedUIExtensionAbility.md)：嵌入式UI扩展能力，提供跨进程界面嵌入的能力。 | 66| INSIGHT_INTENT_UI<sup>12+</sup> | 22 | InsightIntentUIExtensionAbility：为开发者提供能被小艺意图调用，以窗口形态呈现内容的扩展能力。 | 67| UNSPECIFIED | 255 | 不指定类型，配合queryExtensionAbilityInfo接口可以查询所有类型的ExtensionAbility。 | 68 69 70### PermissionGrantState 71 72指示权限授予状态。 73 74 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 75 76 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 77 78| 名称 | 值 | 说明 | 79|:----------------:|:---:|:---:| 80| PERMISSION_DENIED| -1 | 拒绝授予权限。 | 81| PERMISSION_GRANTED | 0 | 授予权限。 | 82 83### SupportWindowMode 84 85标识该组件所支持的窗口模式。 86 87 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 88 89 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 90 91| 名称 | 值 | 说明 | 92|:----------------:|:---:|:---:| 93| FULL_SCREEN | 0 | 窗口支持全屏显示。 | 94| SPLIT | 1 | 窗口支持分屏显示。 | 95| FLOATING | 2 | 支持窗口化显示。 | 96 97### LaunchType 98 99指示组件的启动方式。 100 101 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 102 103 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 104 105| 名称 | 值 | 说明 | 106|:----------------:|:---:|:---:| 107| SINGLETON | 0 | ability的启动模式，表示单实例。 | 108| MULTITON | 1 | ability的启动模式，表示普通多实例。 | 109| SPECIFIED | 2 | ability的启动模式，表示该ability内部根据业务自己指定多实例。 | 110 111### AbilityType 112 113指示Ability组件的类型。 114 115 **模型约束：** 仅可在FA模型下使用 116 117 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 118 119| 名称 | 值 | 说明 | 120| :-----: | ---- | :--------------------------------------------------------: | 121| PAGE | 1 | UI界面类型的Ability。表示基于Page模板开发的FA，用于提供与用户交互的能力。 | 122| SERVICE | 2 | 后台服务类型的Ability，无UI界面。表示基于Service模板开发的PA，用于提供后台运行任务的能力。 | 123| DATA | 3 | 表示基于Data模板开发的PA，用于对外部提供统一的数据访问对象。 | 124 125### DisplayOrientation 126 127标识该Ability的显示模式。该标签仅适用于page类型的Ability。 128 129 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 130 131| 名称 |值 |说明 | 132|:----------------------------------|---|---| 133| UNSPECIFIED |0 |表示未定义方向模式，由系统判定。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 134| LANDSCAPE |1 |表示横屏显示模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 135| PORTRAIT |2 |表示竖屏显示模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 136| FOLLOW_RECENT |3 |表示跟随上一个显示模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 137| LANDSCAPE_INVERTED |4 |表示反向横屏显示模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 138| PORTRAIT_INVERTED |5 |表示反向竖屏显示模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 139| AUTO_ROTATION |6 |表示传感器自动旋转模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 140| AUTO_ROTATION_LANDSCAPE |7 |表示传感器自动横向旋转模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 141| AUTO_ROTATION_PORTRAIT |8 |表示传感器自动竖向旋转模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 142| AUTO_ROTATION_RESTRICTED |9 |表示受开关控制的自动旋转模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 | 143| AUTO_ROTATION_LANDSCAPE_RESTRICTED |10|表述受开关控制的自动横向旋转模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| 144| AUTO_ROTATION_PORTRAIT_RESTRICTED |11|表示受开关控制的自动竖向旋转模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| 145| LOCKED |12|表示锁定模式。<br/>**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。| 146| AUTO_ROTATION_UNSPECIFIED<sup>12+</sup> |13|受开关控制和由系统判定的自动旋转模式。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 147| FOLLOW_DESKTOP<sup>12+</sup> |14|跟随桌面的旋转模式。<br/>**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。| 148 149### CompatiblePolicy<sup>10+</sup> 150 151标识共享库的版本兼容类型。 152 153 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 154 155 **系统能力:** SystemCapability.BundleManager.BundleFramework.Core 156 157| 名称 | 值 | 说明 | 158| ---------------------- | ---- | -------------------------------- | 159| BACKWARD_COMPATIBILITY | 1 | 该字段表明共享库是向后兼容类型。 | 160 161### ModuleType 162 163标识模块类型。 164 165 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 166 167 **系统能力:** SystemCapability.BundleManager.BundleFramework.Core 168 169| 名称 | 值 | 说明 | 170| ------- | ---- | -------------------- | 171| ENTRY | 1 | 应用的主模块。 | 172| FEATURE | 2 | 应用的动态特性模块。 | 173| SHARED | 3 | 应用的动态共享库模块。 | 174 175### BundleType 176 177标识应用的类型。 178 179 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 180 181 **系统能力:** SystemCapability.BundleManager.BundleFramework.Core 182 183| 名称 | 值 | 说明 | 184| -------------- | ---- | --------------- | 185| APP | 0 | 该Bundle是应用。 | 186| ATOMIC_SERVICE | 1 | 该Bundle是原子化服务。 | 187 188### MultiAppModeType<sup>12+</sup> 189标识应用多开的模式类型。 190 191 **系统能力：** SystemCapability.BundleManager.BundleFramework.Core。 192 193| 名称 | 值 | 说明 | 194|:----------------:|:---:|:---:| 195| UNSPECIFIED| 0 | 未指定类型。 | 196| MULTI_INSTANCE | 1 | 多实例模式。常驻进程不支持该字段。 | 197| APP_CLONE | 2 | 分身模式。 | 198 199## 接口 200 201### bundleManager.getBundleInfoForSelf 202 203getBundleInfoForSelf(bundleFlags: number): Promise\<BundleInfo> 204 205以异步方法根据给定的bundleFlags获取当前应用的BundleInfo，使用Promise形式返回结果。 206 207**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 208 209**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 210 211**参数：** 212 213| 参数名 | 类型 | 必填 | 说明 | 214| ----------- | ------ | ---- | --------------------- | 215| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | 216 217**返回值：** 218 219| 类型 | 说明 | 220| ----------------------------------------------------------- | ------------------------------------- | 221| Promise\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | Promise对象，返回当前应用的BundleInfo。| 222 223**错误码：** 224 225以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。 226 227| 错误码ID | 错误信息 | 228| -------- | ------------------------------------------------------------ | 229| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 230 231**示例：** 232 233```ts 234// 额外获取带有metadataArray信息的appInfo 235import { bundleManager } from '@kit.AbilityKit'; 236import { BusinessError } from '@kit.BasicServicesKit'; 237import { hilog } from '@kit.PerformanceAnalysisKit'; 238 239let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA; 240 241try { 242 bundleManager.getBundleInfoForSelf(bundleFlags).then((data) => { 243 hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf successfully. Data: %{public}s', JSON.stringify(data)); 244 }).catch((err: BusinessError) => { 245 hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed. Cause: %{public}s', err.message); 246 }); 247} catch (err) { 248 let message = (err as BusinessError).message; 249 hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message); 250} 251``` 252 253### bundleManager.getBundleInfoForSelf 254 255getBundleInfoForSelf(bundleFlags: number, callback: AsyncCallback\<BundleInfo>): void 256 257以异步方法根据给定的bundleFlags获取当前应用的BundleInfo，使用callback形式返回结果。 258 259**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 260 261**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 262 263**参数：** 264 265| 参数名 | 类型 | 必填 | 说明 | 266| ----------- | ------ | ---- | --------------------- | 267| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | 268| callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数，当获取成功时，err为null，data为获取到的当前应用的BundleInfo；否则为错误对象。 | 269 270**错误码：** 271 272以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。 273 274| 错误码ID | 错误信息 | 275| -------- | ------------------------------------------------------------ | 276| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 277 278**示例：** 279 280```ts 281// 额外获取带有permissions信息的abilitiesInfo 282import { bundleManager } from '@kit.AbilityKit'; 283import { BusinessError } from '@kit.BasicServicesKit'; 284import { hilog } from '@kit.PerformanceAnalysisKit'; 285 286let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_ABILITY | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION; 287 288try { 289 bundleManager.getBundleInfoForSelf(bundleFlags, (err, data) => { 290 if (err) { 291 hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', err.message); 292 } else { 293 hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf successfully: %{public}s', JSON.stringify(data)); 294 } 295 }); 296} catch (err) { 297 let message = (err as BusinessError).message; 298 hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message); 299} 300``` 301 302### bundleManager.getProfileByAbility 303 304getProfileByAbility(moduleName: string, abilityName: string, metadataName: string, callback: AsyncCallback\<Array\<string\>\>): void 305 306以异步方法根据给定的moduleName、abilityName和metadataName（module.json中[metadata标签](../../quick-start/module-configuration-file.md#metadata标签)下的name）获取相应配置文件的json格式字符串，使用callback形式返回结果。 307 308>如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过资源管理模块的相关接口，来获取引用的资源。 309 310**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 311 312**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 313 314**参数：** 315 316| 参数名 | 类型 | 必填 | 说明 | 317| ------------ | ----------------------------- | ---- | ------------------------------------------------------------ | 318| moduleName | string | 是 | 表示Module名称。 | 319| abilityName | string | 是 | 表示UIAbility组件的名称。 | 320| metadataName | string | 是 | 表示UIAbility组件的元信息名称，即module.json5配置文件中abilities标签下的metadata标签的name。 | 321| callback | AsyncCallback<Array\<string>> | 是 | 回调函数，当获取成功时，err为null，data为获取到的Array\<string>；否则为错误对象。 | 322 323**错误码：** 324 325以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[ohos.bundle错误码](errorcode-bundle.md)。 326 327| 错误码ID | 错误信息 | 328| -------- | ------------------------------------------------------------ | 329| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 330| 17700002 | The specified moduleName is not existed. | 331| 17700003 | The specified abilityName is not existed. | 332| 17700024 | Failed to get the profile because there is no profile in the HAP. | 333| 17700026 | The specified bundle is disabled. | 334| 17700029 | The specified ability is disabled. | 335 336**示例：** 337 338```ts 339import { bundleManager } from '@kit.AbilityKit'; 340import { BusinessError } from '@kit.BasicServicesKit'; 341import { hilog } from '@kit.PerformanceAnalysisKit'; 342 343let moduleName = 'entry'; 344let abilityName = 'EntryAbility'; 345let metadataName = 'ability_metadata'; 346 347try { 348 bundleManager.getProfileByAbility(moduleName, abilityName, metadataName, (err, data) => { 349 if (err) { 350 hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message); 351 } else { 352 hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully: %{public}s', JSON.stringify(data)); 353 } 354 }); 355} catch (err) { 356 let message = (err as BusinessError).message; 357 hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message); 358} 359``` 360 361### bundleManager.getProfileByAbility 362 363getProfileByAbility(moduleName: string, abilityName: string, metadataName?: string): Promise\<Array\<string\>\> 364 365以异步方法根据给定的moduleName、abilityName和metadataName（module.json中[metadata标签](../../quick-start/module-configuration-file.md#metadata标签)下的name）获取相应配置文件的json格式字符串，使用Promise形式返回结果。 366 367>如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过资源管理模块的相关接口，来获取引用的资源。 368 369**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 370 371**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 372 373**参数：** 374 375| 参数名 | 类型 | 必填 | 说明 | 376| ------------ | ------ | ---- | -------------------------- | 377| moduleName | string | 是 | 表示Module名称。 | 378| abilityName | string | 是 | 表示UIAbility组件的名称。 | 379| metadataName | string | 否 | 表示UIAbility组件的元信息名称，即module.json5配置文件中abilities标签下的metadata标签的name，默认值为空。 | 380 381**返回值：** 382 383| 类型 | 说明 | 384| ----------------------- | ------------------------------- | 385| Promise<Array\<string>> | Promise对象，返回Array\<string>。 | 386 387**错误码：** 388 389以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[ohos.bundle错误码](errorcode-bundle.md)。 390 391| 错误码ID | 错误信息 | 392| -------- | ------------------------------------------------------------ | 393| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 394| 17700002 | The specified moduleName is not existed. | 395| 17700003 | The specified abilityName is not existed. | 396| 17700024 | Failed to get the profile because there is no profile in the HAP. | 397| 17700026 | The specified bundle is disabled. | 398| 17700029 | The specified ability is disabled. | 399 400**示例：** 401 402```ts 403import { bundleManager } from '@kit.AbilityKit'; 404import { BusinessError } from '@kit.BasicServicesKit'; 405import { hilog } from '@kit.PerformanceAnalysisKit'; 406 407let moduleName = 'entry'; 408let abilityName = 'EntryAbility'; 409 410try { 411 bundleManager.getProfileByAbility(moduleName, abilityName).then((data) => { 412 hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully. Data: %{public}s', JSON.stringify(data)); 413 }).catch((err: BusinessError) => { 414 hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message); 415 }); 416} catch (err) { 417 let message = (err as BusinessError).message; 418 hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message); 419} 420``` 421 422```ts 423import { bundleManager } from '@kit.AbilityKit'; 424import { BusinessError } from '@kit.BasicServicesKit'; 425import { hilog } from '@kit.PerformanceAnalysisKit'; 426 427let moduleName = 'entry'; 428let abilityName = 'EntryAbility'; 429let metadataName = 'ability_metadata'; 430 431try { 432 bundleManager.getProfileByAbility(moduleName, abilityName, metadataName).then((data) => { 433 hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully. Data: %{public}s', JSON.stringify(data)); 434 }).catch((err: BusinessError) => { 435 hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message); 436 }); 437} catch (err) { 438 let message = (err as BusinessError).message; 439 hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message); 440} 441``` 442 443### bundleManager.getProfileByAbilitySync<sup>10+</sup> 444 445getProfileByAbilitySync(moduleName: string, abilityName: string, metadataName?: string): Array\<string\> 446 447以同步方法根据给定的moduleName、abilityName和metadataName（module.json中[metadata标签](../../quick-start/module-configuration-file.md#metadata标签)下的name）获取相应配置文件的json格式字符串，返回对象为string数组。 448 449>如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过资源管理模块的相关接口，来获取引用的资源。 450 451**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 452 453**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 454 455**参数：** 456 457| 参数名 | 类型 | 必填 | 说明 | 458| ------------ | ------ | ---- | -------------------------- | 459| moduleName | string | 是 | 表示Module名称。 | 460| abilityName | string | 是 | 表示UIAbility组件的名称。 | 461| metadataName | string | 否 | 表示UIAbility组件的元信息名称，即module.json5配置文件中abilities标签下的metadata标签的name，默认值为空。 | 462 463**返回值：** 464 465| 类型 | 说明 | 466| ----------------------- | ------------------------------- | 467| Array\<string> | 数组对象，返回Array\<string>。 | 468 469**错误码：** 470 471以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[ohos.bundle错误码](errorcode-bundle.md)。 472 473| 错误码ID | 错误信息 | 474| -------- | ------------------------------------------------------------ | 475| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 476| 17700002 | The specified moduleName is not existed. | 477| 17700003 | The specified abilityName is not existed. | 478| 17700024 | Failed to get the profile because there is no profile in the HAP. | 479| 17700026 | The specified bundle is disabled. | 480| 17700029 | The specified ability is disabled. | 481 482**示例：** 483 484```ts 485import { bundleManager } from '@kit.AbilityKit'; 486import { BusinessError } from '@kit.BasicServicesKit'; 487import { hilog } from '@kit.PerformanceAnalysisKit'; 488 489let moduleName = 'entry'; 490let abilityName = 'EntryAbility'; 491 492try { 493 let data = bundleManager.getProfileByAbilitySync(moduleName, abilityName); 494 hilog.info(0x0000, 'testTag', 'getProfileByAbilitySync successfully. Data: %{public}s', JSON.stringify(data)); 495} catch (err) { 496 let message = (err as BusinessError).message; 497 hilog.error(0x0000, 'testTag', 'getProfileByAbilitySync failed. Cause: %{public}s', message); 498} 499``` 500 501```ts 502import { bundleManager } from '@kit.AbilityKit'; 503import { BusinessError } from '@kit.BasicServicesKit'; 504import { hilog } from '@kit.PerformanceAnalysisKit'; 505 506let moduleName: string = 'entry'; 507let abilityName: string = 'EntryAbility'; 508let metadataName: string = 'ability_metadata'; 509 510try { 511 let data = bundleManager.getProfileByAbilitySync(moduleName, abilityName, metadataName); 512 hilog.info(0x0000, 'testTag', 'getProfileByAbilitySync successfully. Data: %{public}s', JSON.stringify(data)); 513} catch (err) { 514 let message = (err as BusinessError).message; 515 hilog.error(0x0000, 'testTag', 'getProfileByAbilitySync failed. Cause: %{public}s', message); 516} 517``` 518 519### bundleManager.getProfileByExtensionAbility 520 521getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, metadataName: string, callback: AsyncCallback\<Array\<string\>\>): void 522 523以异步方法根据给定的moduleName、extensionAbilityName和metadataName（module.json中[metadata标签](../../quick-start/module-configuration-file.md#metadata标签)下的name）获取相应配置文件的json格式字符串，使用callback形式返回结果。 524 525>如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过资源管理模块的相关接口，来获取引用的资源。 526 527**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 528 529**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 530 531**参数：** 532 533| 参数名 | 类型 | 必填 | 说明 | 534| -------------------- | ----------------------------- | ---- | ------------------------------------------------------------ | 535| moduleName | string | 是 | 表示Module名称。 | 536| extensionAbilityName | string | 是 | 表示ExtensionAbility组件的名称。 | 537| metadataName | string | 是 | 表示ExtensionAbility组件的名称。组件的元信息名称，即module.json5配置文件中extensionAbilities标签下的metadata标签的name。 | 538| callback | AsyncCallback<Array\<string>> | 是 | 回调函数，当获取成功时，err为null，data为获取到的Array\<string>；否则为错误对象。 | 539 540**错误码：** 541 542以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[ohos.bundle错误码](errorcode-bundle.md)。 543 544| 错误码ID | 错误信息 | 545| -------- | ------------------------------------------------------------ | 546| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 547| 17700002 | The specified moduleName is not existed. | 548| 17700003 | The specified extensionAbilityName not existed. | 549| 17700024 | Failed to get the profile because there is no profile in the HAP. | 550| 17700026 | The specified bundle is disabled. | 551 552**示例：** 553 554```ts 555import { bundleManager } from '@kit.AbilityKit'; 556import { BusinessError } from '@kit.BasicServicesKit'; 557import { hilog } from '@kit.PerformanceAnalysisKit'; 558 559let moduleName = 'entry'; 560let extensionAbilityName = 'com.example.myapplication.extension'; 561let metadataName = 'ability_metadata'; 562 563try { 564 bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName, metadataName, (err, data) => { 565 if (err) { 566 hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed: %{public}s', err.message); 567 } else { 568 hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully: %{public}s', JSON.stringify(data)); 569 } 570 }); 571} catch (err) { 572 let message = (err as BusinessError).message; 573 hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed: %{public}s', message); 574} 575``` 576 577### bundleManager.getProfileByExtensionAbility 578 579getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, metadataName?: string): Promise\<Array\<string\>\> 580 581以异步方法根据给定的moduleName、extensionAbilityName和metadataName（module.json中[metadata标签](../../quick-start/module-configuration-file.md#metadata标签)下的name）获取相应配置文件的json格式字符串，使用Promise形式返回结果。 582 583>如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过资源管理模块的相关接口，来获取引用的资源。 584 585**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 586 587**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 588 589**参数：** 590 591| 参数名 | 类型 | 必填 | 说明 | 592| -------------------- | ------ | ---- | ---------------------------------- | 593| moduleName | string | 是 | 表示Module名称。 | 594| extensionAbilityName | string | 是 | 表示ExtensionAbility组件的名称。 | 595| metadataName | string | 否 | 表示ExtensionAbility组件的名称。组件的元信息名称，即module.json5配置文件中extensionAbilities标签下的metadata标签的name，默认值为空。 | 596 597**返回值：** 598 599| 类型 | 说明 | 600| ----------------------- | ----------------------------------- | 601| Promise<Array\<string>> | Promise对象，返回Array\<string>对象。 | 602 603**错误码：** 604 605以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[ohos.bundle错误码](errorcode-bundle.md)。 606 607| 错误码ID | 错误信息 | 608| -------- | ------------------------------------------------------------ | 609| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 610| 17700002 | The specified moduleName is not existed. | 611| 17700003 | The specified extensionAbilityName not existed. | 612| 17700024 | Failed to get the profile because there is no profile in the HAP. | 613| 17700026 | The specified bundle is disabled. | 614 615**示例：** 616 617```ts 618import { bundleManager } from '@kit.AbilityKit'; 619import { BusinessError } from '@kit.BasicServicesKit'; 620import { hilog } from '@kit.PerformanceAnalysisKit'; 621 622let moduleName = 'entry'; 623let extensionAbilityName = 'com.example.myapplication.extension'; 624let metadataName = 'ability_metadata'; 625 626try { 627 bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName).then((data) => { 628 hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully. Data: %{public}s', JSON.stringify(data)); 629 }).catch((err: BusinessError) => { 630 hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message); 631 }); 632} catch (err) { 633 let message = (err as BusinessError).message; 634 hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', message); 635} 636 637try { 638 bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName, metadataName).then((data) => { 639 hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully. Data: %{public}s', JSON.stringify(data)); 640 }).catch((err: BusinessError) => { 641 hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message); 642 }); 643} catch (err) { 644 let message = (err as BusinessError).message; 645 hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', message); 646} 647``` 648 649### bundleManager.getProfileByExtensionAbilitySync<sup>10+</sup> 650 651getProfileByExtensionAbilitySync(moduleName: string, extensionAbilityName: string, metadataName?: string): Array\<string\> 652 653以同步方法根据给定的moduleName、extensionAbilityName和metadataName（module.json中[metadata标签](../../quick-start/module-configuration-file.md#metadata标签)下的name）获取相应配置文件的json格式字符串，返回对象为string数组。 654 655>如果配置文件信息采用了资源引用格式，则返回值将保持资源引用格式（例如 $string:res_id），开发者可以通过资源管理模块的相关接口，来获取引用的资源。 656 657**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 658 659**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 660 661**参数：** 662 663| 参数名 | 类型 | 必填 | 说明 | 664| -------------------- | ------ | ---- | ---------------------------------- | 665| moduleName | string | 是 | 表示Module名称。 | 666| extensionAbilityName | string | 是 | 表示ExtensionAbility组件的名称。 | 667| metadataName | string | 否 | 表示ExtensionAbility组件的名称。组件的元信息名称，即module.json5配置文件中extensionAbilities标签下的metadata标签的name，默认值为空。 | 668 669**返回值：** 670 671| 类型 | 说明 | 672| ----------------------- | ----------------------------------- | 673| Array\<string> | 返回Array\<string>对象。 | 674 675**错误码：** 676 677以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[ohos.bundle错误码](errorcode-bundle.md)。 678 679| 错误码ID | 错误信息 | 680| -------- | ------------------------------------------------------------ | 681| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 682| 17700002 | The specified moduleName is not existed. | 683| 17700003 | The specified extensionAbilityName not existed. | 684| 17700024 | Failed to get the profile because there is no profile in the HAP. | 685| 17700026 | The specified bundle is disabled. | 686 687**示例：** 688 689```ts 690import { bundleManager } from '@kit.AbilityKit'; 691import { BusinessError } from '@kit.BasicServicesKit'; 692import { hilog } from '@kit.PerformanceAnalysisKit'; 693 694let moduleName = 'entry'; 695let extensionAbilityName = 'com.example.myapplication.extension'; 696let metadataName = 'ability_metadata'; 697 698try { 699 let data = bundleManager.getProfileByExtensionAbilitySync(moduleName, extensionAbilityName); 700 hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbilitySync successfully. Data: %{public}s', JSON.stringify(data)); 701} catch (err) { 702 let message = (err as BusinessError).message; 703 hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbilitySync failed. Cause: %{public}s', message); 704} 705 706try { 707 let data = bundleManager.getProfileByExtensionAbilitySync(moduleName, extensionAbilityName, metadataName); 708 hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbilitySync successfully. Data: %{public}s', JSON.stringify(data)); 709} catch (err) { 710 let message = (err as BusinessError).message; 711 hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbilitySync failed. Cause: %{public}s', message); 712} 713``` 714 715### bundleManager.getBundleInfoForSelfSync<sup>10+</sup> 716 717getBundleInfoForSelfSync(bundleFlags: number): BundleInfo 718 719以同步方法根据给定的bundleFlags获取当前应用的BundleInfo。 720 721**原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 722 723**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 724 725**参数：** 726 727| 参数名 | 类型 | 必填 | 说明 | 728| ----------- | ------ | ---- | --------------------- | 729| [bundleFlags](js-apis-bundleManager.md#bundleflag) | number | 是 | 指定返回的BundleInfo所包含的信息。 | 730 731**返回值：** 732 733| 类型 | 说明 | 734| ------------------------------------------------- | -------------------- | 735| [BundleInfo](js-apis-bundleManager-bundleInfo.md) | 返回BundleInfo对象。 | 736 737**错误码：** 738 739以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)。 740 741| 错误码ID | 错误信息 | 742| -------- | ------------------------------------------------------------ | 743| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 744 745**示例：** 746 747```ts 748import { bundleManager } from '@kit.AbilityKit'; 749import { BusinessError } from '@kit.BasicServicesKit'; 750import { hilog } from '@kit.PerformanceAnalysisKit'; 751 752let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION; 753 754try { 755 let data = bundleManager.getBundleInfoForSelfSync(bundleFlags); 756 hilog.info(0x0000, 'testTag', 'getBundleInfoForSelfSync successfully: %{public}s', JSON.stringify(data)); 757} catch (err) { 758 let message = (err as BusinessError).message; 759 hilog.error(0x0000, 'testTag', 'getBundleInfoForSelfSync failed: %{public}s', message); 760} 761``` 762 763### bundleManager.canOpenLink<sup>12+</sup> 764 765canOpenLink(link: string): boolean 766 767查询给定的链接是否可以打开。指定链接的scheme需要在module.json文件的querySchemes字段下配置。 768 769**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 770 771**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 772 773**参数：** 774 775| 参数名 | 类型 | 必填 | 说明 | 776| ----------- | ------ | ---- | --------------------- | 777| link | string | 是 | 表示需要查询的链接。 | 778 779**返回值：** 780 781| 类型 | 说明 | 782| ------------------------------------------------- | -------------------- | 783| boolean | 返回true表示给定的链接可以打开，返回false表示给定的链接不能打开。 | 784 785**错误码：** 786 787以下错误码的详细介绍请参见[通用错误码](../errorcode-universal.md)和[ohos.bundle错误码](errorcode-bundle.md)。 788 789| 错误码ID | 错误信息 | 790| -------- | ------------------------------------------------------------ | 791| 401 | Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.| 792| 17700055 | The specified link is invalid. | 793| 17700056 | The scheme of the specified link is not in the querySchemes. | 794 795**示例：** 796 797```ts 798import { bundleManager } from '@kit.AbilityKit'; 799import { BusinessError } from '@kit.BasicServicesKit'; 800import { hilog } from '@kit.PerformanceAnalysisKit'; 801 802try { 803 let link = 'welink://'; 804 let data = bundleManager.canOpenLink(link); 805 hilog.info(0x0000, 'testTag', 'canOpenLink successfully: %{public}s', JSON.stringify(data)); 806} catch (err) { 807 let message = (err as BusinessError).message; 808 hilog.error(0x0000, 'testTag', 'canOpenLink failed: %{public}s', message); 809} 810``` 811 812### bundleManager.getLaunchWant<sup>13+</sup> 813 814getLaunchWant(): Want 815 816获取自身用于启动应用程序的Want参数。 817 818**原子化服务API：** 从API version 13开始，该接口支持在原子化服务中使用。 819 820**系统能力：** SystemCapability.BundleManager.BundleFramework.Core 821 822**返回值：** 823 824| 类型 | 说明 | 825| ----------------------------------- | ------------------------------------------- | 826| [Want](js-apis-app-ability-want.md) | 返回包含Bundle名称和Ability名称的Want对象。 | 827 828**错误码：** 829 830以下错误码的详细介绍请参见[ohos.bundle错误码](errorcode-bundle.md)。 831 832| 错误码ID | 错误信息 | 833| -------- | ----------------------------- | 834| 17700072 | The launch want is not found. | 835 836**示例：** 837 838```ts 839import { BusinessError } from '@kit.BasicServicesKit'; 840import { bundleManager } from '@kit.AbilityKit'; 841import { hilog } from '@kit.PerformanceAnalysisKit'; 842 843try { 844 let want = bundleManager.getLaunchWant(); 845 hilog.info(0x0000, 'testTag', 'getLaunchWant ability name: %{public}s', want.abilityName); 846 hilog.info(0x0000, 'testTag', 'getLaunchWant bundle name: %{public}s', want.bundleName); 847} catch (error) { 848 let message = (error as BusinessError).message; 849 hilog.error(0x0000, 'testTag', 'getLaunchWant failed: %{public}s', message); 850} 851```