js-apis-bundleManager.md 148.9 KB
Newer Older
Z
zengyawen 已提交
1
# @ohos.bundle.bundleManager (bundleManager模块)
W
wanghang 已提交
2 3 4

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

zyjhandsome's avatar
zyjhandsome 已提交
5
> **说明:**
W
wanghang 已提交
6 7 8 9 10
> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

## 导入模块

```ts
L
Lotol 已提交
11
import bundleManager from '@ohos.bundle.bundleManager';
W
wanghang 已提交
12
```
W
wtt1995 已提交
13

W
wanghang 已提交
14 15
## 权限列表

J
junyi233 已提交
16
| 权限                                       | 权限等级     | 描述            |
W
wanghang 已提交
17
| ------------------------------------------ | ------------ | ------------------|
W
wangtiantian 已提交
18 19
| ohos.permission.GET_BUNDLE_INFO            | normal       | 允许查询应用的基本信息。   |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 允许查询应用的基本信息和其他敏感信息。 |
Z
zhaogan 已提交
20 21
| ohos.permission.REMOVE_CACHE_FILES         | system_basic | 清理应用缓存。       |
|ohos.permission.CHANGE_ABILITY_ENABLED_STATE| system_basic | 设置禁用使能所需的权限。  |
W
wangtiantian 已提交
22
| ohos.permission.GET_INSTALLED_BUNDLE_LIST | system_basic | 读取已安装应用列表。 |
W
wanghang 已提交
23

Z
zengyawen 已提交
24
权限等级参考[权限等级说明](../../security/accesstoken-overview.md#权限等级说明)
W
wanghang 已提交
25 26 27 28 29

## 枚举

### BundleFlag

Z
zhaogan 已提交
30 31
包信息标志,指示需要获取的包信息的内容。

W
wtt1995 已提交
32
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
33 34 35

| 名称                                      | 值         | 说明                                                         |
| ----------------------------------------- | ---------- | ------------------------------------------------------------ |
Z
zhaogan 已提交
36 37 38 39
| GET_BUNDLE_INFO_DEFAULT                   | 0x00000000 | 用于获取默认bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息。 |
| GET_BUNDLE_INFO_WITH_APPLICATION          | 0x00000001 | 用于获取包含applicationInfo的bundleInfo,获取的bundleInfo不包含signatureInfo、hapModuleInfo、ability、extensionAbility和permission的信息。 |
| GET_BUNDLE_INFO_WITH_HAP_MODULE           | 0x00000002 | 用于获取包含hapModuleInfo的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、ability、extensionAbility和permission的信息。 |
| GET_BUNDLE_INFO_WITH_ABILITY              | 0x00000004 | 用于获取包含ability的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、extensionAbility和permission的信息。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。 |
W
wanghang 已提交
40
| GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY    | 0x00000008 | 用于获取包含extensionAbility的bundleInfo,获取的bundleInfo不包含signatureInfo、applicationInfo、ability 和permission的信息。它不能单独使用,需要与GET_BUNDLE_INFO_WITH_HAP_MODULE一起使用。 |
Z
zhaogan 已提交
41 42 43 44
| GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION | 0x00000010 | 用于获取包含permission的bundleInfo。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、extensionAbility和ability的信息。 |
| 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一起使用。 |
| GET_BUNDLE_INFO_WITH_DISABLE              | 0x00000040 | 用于获取application被禁用的BundleInfo和被禁用的Ability信息。获取的bundleInfo不包含signatureInfo、applicationInfo、hapModuleInfo、ability、extensionAbility和permission的信息。 |
| GET_BUNDLE_INFO_WITH_SIGNATURE_INFO       | 0x00000080 | 用于获取包含signatureInfo的bundleInfo。获取的bundleInfo不包含applicationInfo、hapModuleInfo、extensionAbility、ability和permission的信息。 |
W
wanghang 已提交
45 46 47

### ApplicationFlag

Z
zhaogan 已提交
48 49
应用信息标志,指示需要获取的应用信息的内容。

W
wtt1995 已提交
50
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
51

52
 **系统接口:** 此接口为系统接口。
W
wanghang 已提交
53 54 55

| 名称                                 | 值         | 说明                                                         |
| ------------------------------------ | ---------- | ------------------------------------------------------------ |
Z
zhaogan 已提交
56 57 58 59
| GET_APPLICATION_INFO_DEFAULT         | 0x00000000 | 用于获取默认的applicationInfo,获取的applicationInfo不包含permission和metadata信息。 |
| GET_APPLICATION_INFO_WITH_PERMISSION | 0x00000001 | 用于获取包含permission的applicationInfo。                    |
| GET_APPLICATION_INFO_WITH_METADATA   | 0x00000002 | 用于获取包含metadata的applicationInfo。                      |
| GET_APPLICATION_INFO_WITH_DISABLE    | 0x00000004 | 用于获取包含禁用应用程序的applicationInfo。                  |
W
wanghang 已提交
60 61 62

### AbilityFlag

W
wtt1995 已提交
63
Ability组件信息标志,指示需要获取的Ability组件信息的内容。
Z
zhaogan 已提交
64

W
wtt1995 已提交
65
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
66

67
 **系统接口:** 此接口为系统接口。
W
wanghang 已提交
68 69 70

| 名称                              | 值         | 说明                                                         |
| --------------------------------- | ---------- | ------------------------------------------------------------ |
Z
zhaogan 已提交
71 72 73 74 75 76
| GET_ABILITY_INFO_DEFAULT          | 0x00000000 | 用于获取默认abilityInfo,获取的abilityInfo不包含permission、metadata和禁用的abilityInfo。 |
| GET_ABILITY_INFO_WITH_PERMISSION  | 0x00000001 | 用于获取包含permission的abilityInfo。                          |
| GET_ABILITY_INFO_WITH_APPLICATION | 0x00000002 | 用于获取包含applicationInfo的abilityInfo。                     |
| GET_ABILITY_INFO_WITH_METADATA    | 0x00000004 | 用于获取包含metadata的abilityInfo。                            |
| GET_ABILITY_INFO_WITH_DISABLE     | 0x00000008 | 用于获取包含禁用的abilityInfo的abilityInfo。                   |
| GET_ABILITY_INFO_ONLY_SYSTEM_APP  | 0x00000010 | 用于仅为系统应用程序获取abilityInfo。                         |
W
wanghang 已提交
77 78 79

### ExtensionAbilityFlag

Z
zhaogan 已提交
80 81
扩展组件信息标志,指示需要获取的扩展组件信息的内容。

W
wtt1995 已提交
82
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
83

84
 **系统接口:** 此接口为系统接口。
W
wanghang 已提交
85 86 87

| 名称                                        | 值         | 说明                                                         |
| ------------------------------------------- | ---------- | ------------------------------------------------------------ |
Z
zhaogan 已提交
88 89 90 91
| GET_EXTENSION_ABILITY_INFO_DEFAULT          | 0x00000000 | 用于获取默认extensionAbilityInfo。获取的extensionAbilityInfo不包含permission、metadata 和禁用的abilityInfo。 |
| GET_EXTENSION_ABILITY_INFO_WITH_PERMISSION  | 0x00000001 | 用于获取包含permission的extensionAbilityInfo。               |
| GET_EXTENSION_ABILITY_INFO_WITH_APPLICATION | 0x00000002 | 用于获取包含applicationInfo的extensionAbilityInfo。         |
| GET_EXTENSION_ABILITY_INFO_WITH_METADATA    | 0x00000004 | 用于获取包含metadata的extensionAbilityInfo。                 |
W
wanghang 已提交
92 93 94

### ExtensionAbilityType

Z
zhaogan 已提交
95 96
指示扩展组件的类型。

W
wtt1995 已提交
97
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
98

J
junyi233 已提交
99
| 名称 | 值 | 说明 |
Z
zhongjianfei 已提交
100
|:----------------:|:---:|-----|
101
| FORM             | 0   | [FormExtensionAbility](../../application-models/service-widget-overview.md):卡片扩展能力,提供卡片开发能力。 |
102
| WORK_SCHEDULER   | 1   | [WorkSchedulerExtensionAbility](../../task-management/work-scheduler.md):延时任务扩展能力,允许应用在系统闲时执行实时性不高的任务。 |
Z
zhongjianfei 已提交
103
| INPUT_METHOD     | 2   | [InputMethodExtensionAbility](js-apis-inputmethod-extension-ability.md):输入法扩展能力,用于开发输入法应用。 |
Z
zhongjianfei 已提交
104
| SERVICE          | 3   | [ServiceExtensionAbility](../../application-models/serviceextensionability.md):后台服务扩展能力,提供后台运行并对外提供相应能力。 |
Z
zhongjianfei 已提交
105
| ACCESSIBILITY    | 4   | [AccessibilityExtensionAbility](js-apis-application-accessibilityExtensionAbility.md):无障碍服务扩展能力,支持访问与操作前台界面。 |
106
| DATA_SHARE       | 5   | [DataShareExtensionAbility](../../database/share-data-by-datashareextensionability.md):数据共享扩展能力,用于对外提供数据读写服务。 |
Z
zhongjianfei 已提交
107 108 109 110
| FILE_SHARE       | 6   | FileShareExtensionAbility:文件共享扩展能力,用于应用间的文件分享。预留能力,当前暂未支持。 |
| STATIC_SUBSCRIBER| 7   | [StaticSubscriberExtensionAbility](js-apis-application-staticSubscriberExtensionAbility.md):静态广播扩展能力,用于处理静态事件,比如开机事件。 |
| WALLPAPER        | 8   | WallpaperExtensionAbility:壁纸扩展能力,用于实现桌面壁纸。预留能力,当前暂未支持。 |
| BACKUP           |  9  | BackupExtensionAbility:数据备份扩展能力,提供应用数据和公共数据备份回复能力。预留能力,当前暂未支持。 |
Z
zhongjianfei 已提交
111
| WINDOW           |  10 | [WindowExtensionAbility](js-apis-application-windowExtensionAbility.md):界面组合扩展能力,允许系统应用进行跨应用的界面拉起和嵌入。 |
Z
zhongjianfei 已提交
112 113 114
| ENTERPRISE_ADMIN |  11 | [EnterpriseAdminExtensionAbility](js-apis-EnterpriseAdminExtensionAbility.md):企业设备管理扩展能力,提供企业管理时处理管理事件的能力,比如设备上应用安装事件、锁屏密码输入错误次数过多事件等。 |
| THUMBNAIL        | 13  | ThumbnailExtensionAbility:文件缩略图扩展能力,用于为文件提供图标缩略图的能力。预留能力,当前暂未支持。 |
| PREVIEW          | 14  | PreviewExtensionAbility:文件预览扩展能力,提供文件预览的能力,其他应用可以直接在应用中嵌入显示。预留能力,当前暂未支持。 |
115
| PRINT<sup>10+</sup> | 15 | PrintExtensionAbility:文件打印扩展能力,提供应用打印照片、文档等办公场景。当前支持图片打印,文档类型暂未支持。 |
116
| SHARE<sup>10+</sup> | 16 | [ShareExtensionAbility](js-apis-app-ability-shareExtensionAbility.md):提供分享业务能力,为开发者提供基于UIExtension的分享业务模板。 |
117
| PUSH<sup>10+</sup> | 17 | PushExtensionAbility:推送扩展能力,提供推送场景化消息能力。预留能力,当前暂未支持。 |
S
SoftSquirrel 已提交
118
| DRIVER<sup>10+</sup> | 18 | DriverExtensionAbility:驱动扩展能力,提供外设驱动扩展能力,当前暂未支持。 |
119
| ACTION<sup>10+</sup> | 19 | [ActionExtensionAbility](js-apis-app-ability-actionExtensionAbility.md):自定义服务扩展能力,为开发者提供基于UIExtension的自定义操作业务模板。 |
Z
zhongjianfei 已提交
120
| UNSPECIFIED      | 255 | 不指定类型,配合queryExtensionAbilityInfo接口可以查询所有类型的ExtensionAbility。 |
W
wanghang 已提交
121 122 123 124


### PermissionGrantState

W
wtt1995 已提交
125
指示权限授予状态。
Z
zhaogan 已提交
126

W
wtt1995 已提交
127
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
128

J
junyi233 已提交
129 130
| 名称 | 值 | 说明 |
|:----------------:|:---:|:---:|
Z
zhaogan 已提交
131 132
| PERMISSION_DENIED|  -1 | 拒绝授予权限。 |
| PERMISSION_GRANTED |  0  |  授予权限。  |
W
wanghang 已提交
133 134 135

### SupportWindowMode

Z
zhaogan 已提交
136 137
标识该组件所支持的窗口模式。

W
wtt1995 已提交
138
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
139

J
junyi233 已提交
140 141
| 名称 | 值 | 说明 |
|:----------------:|:---:|:---:|
Z
zhaogan 已提交
142 143 144
| FULL_SCREEN      | 0   | 窗口支持全屏显示。 |
| SPLIT            | 1   | 窗口支持分屏显示。 |
| FLOATING         | 2   | 支持窗口化显示。   |
W
wanghang 已提交
145 146 147

### LaunchType

Z
zhaogan 已提交
148 149
指示组件的启动方式。

W
wtt1995 已提交
150
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
151

J
junyi233 已提交
152 153
| 名称 | 值 | 说明 |
|:----------------:|:---:|:---:|
W
wtt1995 已提交
154
| SINGLETON        | 0   | ability的启动模式,表示单实例。 |
W
wangtiantian 已提交
155
| MULTITON         | 1   | ability的启动模式,表示普通多实例。 |
W
wtt1995 已提交
156
| SPECIFIED        | 2   | ability的启动模式,表示该ability内部根据业务自己置顶多实例。 |
W
wanghang 已提交
157 158 159

### AbilityType

Z
zhaogan 已提交
160 161
指示Ability组件的类型。

W
wtt1995 已提交
162
 **模型约束:** 仅可在FA模型下使用
W
wanghang 已提交
163

W
wtt1995 已提交
164
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
165

J
junyi233 已提交
166 167
|  名称   | 值   |                            说明                            |
| :-----: | ---- | :--------------------------------------------------------: |
Z
zhaogan 已提交
168 169 170
|  PAGE   | 1    |     表示基于Page模板开发的FA,用于提供与用户交互的能力。     |
| SERVICE | 2    |  表示基于Service模板开发的PA,用于提供后台运行任务的能力。   |
|  DATA   | 3    | 表示基于Data模板开发的PA,用于对外部提供统一的数据访问对象。 |
W
wanghang 已提交
171 172 173

### DisplayOrientation

Z
zhaogan 已提交
174 175
标识该Ability的显示模式。该标签仅适用于page类型的Ability。

W
wtt1995 已提交
176
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
177

J
junyi233 已提交
178 179
| 名称                               |值 |说明 |
|:----------------------------------|---|---|
Z
zhaogan 已提交
180 181 182 183 184 185 186 187 188 189 190 191 192
| UNSPECIFIED                        |0 |表示未定义方向模式,由系统判定。 |
| LANDSCAPE                          |1 |表示横屏显示模式。 |
| PORTRAIT                           |2 |表示竖屏显示模式。 |
| FOLLOW_RECENT                      |3 |表示跟随上一个显示模式。 |
| LANDSCAPE_INVERTED                 |4 |表示反向横屏显示模式。 |
| PORTRAIT_INVERTED                  |5 |表示反向竖屏显示模式。 |
| AUTO_ROTATION                      |6 |表示传感器自动旋转模式。 |
| AUTO_ROTATION_LANDSCAPE            |7 |表示传感器自动横向旋转模式。 |
| AUTO_ROTATION_PORTRAIT             |8 |表示传感器自动竖向旋转模式。 |
| AUTO_ROTATION_RESTRICTED           |9 |表示受开关控制的自动旋转模式。 |
| AUTO_ROTATION_LANDSCAPE_RESTRICTED |10|表述受开关控制的自动横向旋转模式。|
| AUTO_ROTATION_PORTRAIT_RESTRICTED  |11|表示受开关控制的自动竖向旋转模式。|
| LOCKED                             |12|表示锁定模式。|
W
wanghang 已提交
193

X
xsz233 已提交
194
### CompatiblePolicy<sup>10+</sup>
Z
zhaogan 已提交
195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226

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

 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core

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

### ModuleType

标识模块类型。

 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core

| 名称    | 值   | 说明                 |
| ------- | ---- | -------------------- |
| ENTRY   | 1    | 应用的主模块。   |
| FEATURE | 2    | 应用的动态特性模块。 |
| SHARED  | 3    | 应用的动态共享库模块。  |

### BundleType

标识应用的类型。

 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core

| 名称           | 值   | 说明            |
| -------------- | ---- | --------------- |
| APP            | 0    | 该Bundle是普通应用程序。    |
| ATOMIC_SERVICE | 1    | 该Bundle是原子化服务。 |

W
wtt1995 已提交
227
## 接口
W
wanghang 已提交
228 229 230 231 232 233 234 235 236 237 238

### bundleManager.getBundleInfoForSelf

getBundleInfoForSelf(bundleFlags: [number](#bundleflag)): Promise\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>;

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

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

**参数:**

J
junyi233 已提交
239
| 参数名     | 类型   | 必填 | 说明                |
W
wanghang 已提交
240
| ----------- | ------ | ---- | --------------------- |
Z
zhaogan 已提交
241
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。 |
W
wanghang 已提交
242 243 244 245 246

**返回值:**

| 类型                                                        | 说明                                  |
| ----------------------------------------------------------- | ------------------------------------- |
Z
zhaogan 已提交
247
| Promise\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | Promise对象,返回当前应用的BundleInfo。|
W
wanghang 已提交
248

Z
zhaogan 已提交
249 250
**示例:**

W
wanghang 已提交
251
```ts
L
Lotol 已提交
252
import bundleManager from '@ohos.bundle.bundleManager';
253
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
254
import hilog from '@ohos.hilog';
W
wanghang 已提交
255 256 257
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;
try {
    bundleManager.getBundleInfoForSelf(bundleFlags).then((data) => {
G
geng-wenguang 已提交
258
        hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf successfully. Data: %{public}s', JSON.stringify(data));
259
    }).catch((err: BusinessError) => {
260
        hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed. Cause: %{public}s', err.message);
W
wanghang 已提交
261
    });
262
} catch (err) {
263 264
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message);
W
wanghang 已提交
265 266 267 268 269 270 271 272 273 274 275 276 277
}
```

### bundleManager.getBundleInfoForSelf

getBundleInfoForSelf(bundleFlags: [number](#bundleflag), callback: AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>): void;

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

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

**参数:**

J
junyi233 已提交
278
| 参数名     | 类型   | 必填 | 说明                |
W
wanghang 已提交
279
| ----------- | ------ | ---- | --------------------- |
Z
zhaogan 已提交
280 281
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。 |
| callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的当前应用的BundleInfo;否则为错误对象。 |
W
wanghang 已提交
282 283 284 285

**示例:**

```ts
L
Lotol 已提交
286
import bundleManager from '@ohos.bundle.bundleManager';
287
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
288
import hilog from '@ohos.hilog';
W
wanghang 已提交
289 290 291 292 293
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getBundleInfoForSelf(bundleFlags, (err, data) => {
        if (err) {
294
            hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', err.message);
W
wanghang 已提交
295
        } else {
G
geng-wenguang 已提交
296
            hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
297 298 299
        }
    });
} catch (err) {
300 301
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', message);
W
wanghang 已提交
302 303 304 305 306 307 308 309 310
}
```

### bundleManager.getBundleInfo

getBundleInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback\<BundleInfo>): void;

以异步方法根据给定的bundleName、bundleFlags和userId获取BundleInfo,使用callback形式返回结果。

G
geng-wenguang 已提交
311 312
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
313 314 315 316 317 318 319 320
**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
321
| 参数名  | 类型   | 必填 | 说明                       |
W
wanghang 已提交
322
| ----------- | ------ | ---- | ---------------------------- |
323
| bundleName  | string | 是   | 表示要查询的应用Bundle名称。 |
Z
zhaogan 已提交
324 325 326
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。|
| userId      | number | 是   | 表示用户ID。  |
| callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的bundleInfo;否则为错误对象。 |
W
wanghang 已提交
327 328 329

**错误码:**

Z
zengyawen 已提交
330
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
331

J
junyi233 已提交
332
| 错误码ID | 错误信息                              |
W
wanghang 已提交
333
| -------- | ------------------------------------- |
Z
zhaogan 已提交
334
| 17700001 | The specified bundleName is not found. |
335
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
336
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
337 338 339 340

**示例:**

```ts
J
junyi233 已提交
341
// 额外获取AbilityInfo
L
Lotol 已提交
342
import bundleManager from '@ohos.bundle.bundleManager';
343
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
344
import hilog from '@ohos.hilog';
W
wanghang 已提交
345
let bundleName = 'com.example.myapplication';
J
junyi233 已提交
346 347 348 349 350 351
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) {
L
longwei 已提交
352
            hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message);
J
junyi233 已提交
353
        } else {
L
longwei 已提交
354
            hilog.info(0x0000, 'testTag', 'getBundleInfo successfully: %{public}s', JSON.stringify(data));
J
junyi233 已提交
355 356 357
        }
    });
} catch (err) {
358 359
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message);
J
junyi233 已提交
360 361 362
}
```

Z
zhaogan 已提交
363
```ts
J
junyi233 已提交
364
// 额外获取ApplicationInfo中的metadata
L
Lotol 已提交
365
import bundleManager from '@ohos.bundle.bundleManager';
366
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
367
import hilog from '@ohos.hilog';
J
junyi233 已提交
368 369
let bundleName = 'com.example.myapplication';
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA;
W
wanghang 已提交
370 371 372 373 374
let userId = 100;

try {
    bundleManager.getBundleInfo(bundleName, bundleFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
375
            hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
376
        } else {
L
longwei 已提交
377
            hilog.info(0x0000, 'testTag', 'getBundleInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
378 379 380
        }
    });
} catch (err) {
381 382
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message);
W
wanghang 已提交
383 384 385 386 387 388 389 390 391
}
```

### bundleManager.getBundleInfo

getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<BundleInfo>): void;

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

G
geng-wenguang 已提交
392 393
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
394 395 396 397 398 399 400 401
**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
402
| 参数名     | 类型   | 必填 | 说明                       |
W
wanghang 已提交
403
| ----------- | ------ | ---- | ---------------------------- |
404
| bundleName  | string | 是   | 表示要查询的应用Bundle名称。 |
Z
zhaogan 已提交
405 406
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。|
| callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象。 |
W
wanghang 已提交
407 408 409

**错误码:**

Z
zengyawen 已提交
410
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
411

J
junyi233 已提交
412
| 错误码ID | 错误信息                              |
W
wanghang 已提交
413
| -------- | ------------------------------------- |
Z
zhaogan 已提交
414 415
| 17700001 | The specified bundleName is not found. |
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
416 417 418 419

**示例:**

```ts
J
junyi233 已提交
420
// 额外获取extensionAbility
L
Lotol 已提交
421
import bundleManager from '@ohos.bundle.bundleManager';
422
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
423
import hilog from '@ohos.hilog';
W
wanghang 已提交
424
let bundleName = 'com.example.myapplication';
J
junyi233 已提交
425
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY;
W
wanghang 已提交
426 427 428 429

try {
    bundleManager.getBundleInfo(bundleName, bundleFlags, (err, data) => {
        if (err) {
L
longwei 已提交
430
            hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
431
        } else {
L
longwei 已提交
432
            hilog.info(0x0000, 'testTag', 'getBundleInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
433 434 435
        }
    });
} catch (err) {
436 437
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', message);
W
wanghang 已提交
438 439 440 441 442 443 444 445 446
}
```

### bundleManager.getBundleInfo

getBundleInfo(bundleName: string, bundleFlags: [number](#bundleflag), userId?: number): Promise\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>;

以异步方法根据给定的bundleName、bundleFlags和userId获取BundleInfo,使用Promise形式返回结果。

G
geng-wenguang 已提交
447 448
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
449 450 451 452 453 454 455 456
**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
457
| 参数名     | 类型   | 必填 | 说明                       |
W
wanghang 已提交
458
| ----------- | ------ | ---- | ---------------------------- |
459
| bundleName  | string | 是   | 表示要查询的应用Bundle名称。 |
Z
zhaogan 已提交
460
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。       |
L
Lotol 已提交
461
| userId      | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。  |
W
wanghang 已提交
462 463 464 465 466

**返回值:**

| 类型                                                        | 说明                        |
| ----------------------------------------------------------- | --------------------------- |
Z
zhaogan 已提交
467
| Promise\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | Promise对象,返回BundleInfo。 |
W
wanghang 已提交
468 469 470

**错误码:**

Z
zengyawen 已提交
471
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
J
junyi233 已提交
472

J
junyi233 已提交
473
| 错误码ID | 错误信息                            |
W
wanghang 已提交
474
| -------- | --------------------------------------|
Z
zhaogan 已提交
475
| 17700001 | The specified bundleName is not found. |
476
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
477
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
478 479 480 481

**示例:**

```ts
J
junyi233 已提交
482
// 额外获取ApplicationInfo和SignatureInfo
L
Lotol 已提交
483
import bundleManager from '@ohos.bundle.bundleManager';
484
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
485
import hilog from '@ohos.hilog';
W
wanghang 已提交
486
let bundleName = 'com.example.myapplication';
J
junyi233 已提交
487
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO;
W
wanghang 已提交
488 489 490 491
let userId = 100;

try {
    bundleManager.getBundleInfo(bundleName, bundleFlags, userId).then((data) => {
L
longwei 已提交
492
        hilog.info(0x0000, 'testTag', 'getBundleInfo successfully. Data: %{public}s', JSON.stringify(data));
493
    }).catch((err: BusinessError) => {
L
longwei 已提交
494
        hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
495
    });
496
} catch (err) {
497 498
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
499 500 501 502
}
```

```ts
L
Lotol 已提交
503
import bundleManager from '@ohos.bundle.bundleManager';
504
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
505
import hilog from '@ohos.hilog';
W
wanghang 已提交
506 507 508 509 510
let bundleName = 'com.example.myapplication';
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getBundleInfo(bundleName, bundleFlags).then((data) => {
L
longwei 已提交
511
        hilog.info(0x0000, 'testTag', 'getBundleInfo successfully. Data: %{public}s', JSON.stringify(data));
512
    }).catch((err: BusinessError) => {
L
longwei 已提交
513
        hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
514
    });
515
} catch (err) {
516 517
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
518 519 520 521 522 523 524 525 526 527
}

```

### bundleManager.getApplicationInfo

getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), userId: number, callback: AsyncCallback\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>): void;

以异步方法根据给定的bundleName、appFlags和userId获取ApplicationInfo,使用callback形式返回结果。

G
geng-wenguang 已提交
528 529
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
530 531 532 533 534 535 536 537
**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
538
| 参数名    | 类型   | 必填 | 说明                       |
W
wanghang 已提交
539
| ---------- | ------ | ---- | ---------------------------- |
540
| bundleName | string | 是   | 表示要查询的应用Bundle名称。 |
Z
zhaogan 已提交
541 542 543
| appFlags   | [number](#applicationflag) | 是   | 指定返回的ApplicationInfo所包含的信息。    |
| userId     | number | 是   | 表示用户ID。  |
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象。 |
W
wanghang 已提交
544 545 546

**错误码:**

Z
zengyawen 已提交
547
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
548

J
junyi233 已提交
549
| 错误码ID | 错误信息                             |
W
wanghang 已提交
550
| -------- | --------------------------------------|
Z
zhaogan 已提交
551
| 17700001 | The specified bundleName is not found. |
552
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
553
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
554

Z
zhaogan 已提交
555
**示例:**
W
wanghang 已提交
556 557

```ts
L
Lotol 已提交
558
import bundleManager from '@ohos.bundle.bundleManager';
559
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
560
import hilog from '@ohos.hilog';
W
wanghang 已提交
561 562 563 564 565 566 567
let bundleName = 'com.example.myapplication';
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;
let userId = 100;

try {
    bundleManager.getApplicationInfo(bundleName, appFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
568
            hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
569
        } else {
L
longwei 已提交
570
            hilog.info(0x0000, 'testTag', 'getApplicationInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
571 572 573
        }
    });
} catch (err) {
574 575
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', message);
W
wanghang 已提交
576 577 578 579 580 581 582 583 584
}
```

### bundleManager.getApplicationInfo

getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), callback: AsyncCallback\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>): void;

以异步方法根据给定的bundleName和appFlags获取ApplicationInfo,使用callback形式返回结果。

G
geng-wenguang 已提交
585 586
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
587 588 589 590 591 592 593 594
**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
595
| 参数名    | 类型   | 必填 | 说明                       |
W
wanghang 已提交
596
| ---------- | ------ | ---- | ---------------------------- |
597
| bundleName | string | 是   | 表示要查询的应用Bundle名称。 |
Z
zhaogan 已提交
598 599
| appFlags   | [number](#applicationflag) | 是   | 指定返回的ApplicationInfo所包含的信息。    |
| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的ApplicationInfo;否则为错误对象。 |
W
wanghang 已提交
600 601 602

**错误码:**

Z
zengyawen 已提交
603
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
604

J
junyi233 已提交
605
| 错误码ID | 错误信息                             |
W
wanghang 已提交
606
| -------- | --------------------------------------|
Z
zhaogan 已提交
607 608
| 17700001 | The specified bundleName is not found. |
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
609 610 611 612

**示例:**

```ts
L
Lotol 已提交
613
import bundleManager from '@ohos.bundle.bundleManager';
614
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
615
import hilog from '@ohos.hilog';
W
wanghang 已提交
616
let bundleName = 'com.example.myapplication';
Z
zhaogan 已提交
617
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
W
wanghang 已提交
618 619 620 621

try {
    bundleManager.getApplicationInfo(bundleName, appFlags, (err, data) => {
        if (err) {
L
longwei 已提交
622
            hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
623
        } else {
L
longwei 已提交
624
            hilog.info(0x0000, 'testTag', 'getApplicationInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
625 626 627
        }
    });
} catch (err) {
628 629
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', message);
W
wanghang 已提交
630 631 632 633 634 635 636 637 638
}
```

### bundleManager.getApplicationInfo

getApplicationInfo(bundleName: string, appFlags: [number](#applicationflag), userId?: number): Promise\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>;

以异步方法根据给定的bundleName、appFlags和userId获取ApplicationInfo,使用Promise形式返回结果。

G
geng-wenguang 已提交
639 640
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
641 642 643 644 645 646 647 648
**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
649
| 参数名    | 类型   | 必填 | 说明                       |
W
wanghang 已提交
650
| ---------- | ------ | ---- | ---------------------------- |
651
| bundleName | string | 是   | 表示要查询的应用Bundle名称。 |
Z
zhaogan 已提交
652
| appFlags   | [number](#applicationflag) | 是   | 指定返回的ApplicationInfo所包含的信息。    |
L
Lotol 已提交
653
| userId     | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 |
W
wanghang 已提交
654 655 656 657 658

**返回值:**

| 类型                                                         | 说明                             |
| ------------------------------------------------------------ | -------------------------------- |
Z
zhaogan 已提交
659
| Promise\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)> | Promise对象,返回ApplicationInfo。 |
W
wanghang 已提交
660 661 662

**错误码:**

Z
zengyawen 已提交
663
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
664

J
junyi233 已提交
665
| 错误码ID | 错误信息                             |
W
wanghang 已提交
666
| -------- | ------------------------------------- |
Z
zhaogan 已提交
667
| 17700001 | The specified bundleName is not found. |
668
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
669
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
670 671 672 673

**示例:**

```ts
L
Lotol 已提交
674
import bundleManager from '@ohos.bundle.bundleManager';
675
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
676
import hilog from '@ohos.hilog';
W
wanghang 已提交
677 678 679 680 681 682
let bundleName = 'com.example.myapplication';
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
let userId = 100;

try {
    bundleManager.getApplicationInfo(bundleName, appFlags, userId).then((data) => {
L
longwei 已提交
683
        hilog.info(0x0000, 'testTag', 'getApplicationInfo successfully. Data: %{public}s', JSON.stringify(data));
684
    }).catch((err: BusinessError) => {
L
longwei 已提交
685
        hilog.error(0x0000, 'testTag', 'getApplicationInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
686
    });
687
} catch (err) {
688 689
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getApplicationInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
690 691 692 693 694 695 696
}
```

### bundleManager.getAllBundleInfo

getAllBundleInfo(bundleFlags: [number](#bundleflag), userId: number, callback: AsyncCallback<Array\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>>): void;

W
wtt1995 已提交
697
以异步方法根据给定的bundleFlags和userId获取系统中所有的BundleInfo,使用callback形式返回结果。
W
wanghang 已提交
698 699 700

**系统接口:** 此接口为系统接口。

W
wangtiantian 已提交
701
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
702 703 704 705 706

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

**参数:**

J
junyi233 已提交
707
| 参数名     | 类型   | 必填 | 说明                                             |
W
wanghang 已提交
708
| ----------- | ------ | ---- | -------------------------------------------------- |
Z
zhaogan 已提交
709 710 711
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。                    |
| userId      | number | 是   | 表示用户ID。                      |
| callback | AsyncCallback<Array\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<BundleInfo>;否则为错误对象。 |
W
wanghang 已提交
712 713 714

**错误码:**

Z
zengyawen 已提交
715
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
716

J
junyi233 已提交
717
| 错误码ID | 错误信息                         |
W
wanghang 已提交
718
| -------- | --------------------------------- |
719
| 17700004 | The specified user ID is not found. |
W
wanghang 已提交
720 721 722 723

**示例:**

```ts
L
Lotol 已提交
724
import bundleManager from '@ohos.bundle.bundleManager';
725
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
726
import hilog from '@ohos.hilog';
W
wanghang 已提交
727 728 729 730 731 732
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION;
let userId = 100;

try {
    bundleManager.getAllBundleInfo(bundleFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
733
            hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
734
        } else {
L
longwei 已提交
735
            hilog.info(0x0000, 'testTag', 'getAllBundleInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
736 737 738
        }
    });
} catch (err) {
739 740
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message);
W
wanghang 已提交
741 742 743 744 745 746 747
}
```

### bundleManager.getAllBundleInfo

getAllBundleInfo(bundleFlags: [number](#bundleflag), callback: AsyncCallback<Array\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>>): void;

W
wtt1995 已提交
748
以异步方法根据给定的bundleFlags获取系统中所有的BundleInfo,使用callback形式返回结果。
W
wanghang 已提交
749 750 751

**系统接口:** 此接口为系统接口。

W
wangtiantian 已提交
752
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
753 754 755 756 757

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

**参数:**

J
junyi233 已提交
758
| 参数名     | 类型   | 必填 | 说明                                             |
W
wanghang 已提交
759
| ----------- | ------ | ---- | -------------------------------------------------- |
Z
zhaogan 已提交
760 761
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。   |
| callback | AsyncCallback<Array\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<BundleInfo>;否则为错误对象。 |
W
wanghang 已提交
762 763 764 765

**示例:**

```ts
L
Lotol 已提交
766
import bundleManager from '@ohos.bundle.bundleManager';
767
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
768
import hilog from '@ohos.hilog';
W
wanghang 已提交
769 770 771 772 773
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getAllBundleInfo(bundleFlags, (err, data) => {
        if (err) {
L
longwei 已提交
774
            hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
775
        } else {
L
longwei 已提交
776
            hilog.info(0x0000, 'testTag', 'getAllBundleInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
777 778 779
        }
    });
} catch (err) {
780 781
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', message);
W
wanghang 已提交
782 783 784 785 786 787 788
}
```

### bundleManager.getAllBundleInfo

getAllBundleInfo(bundleFlags: [number](#bundleflag), userId?: number): Promise<Array\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>>;

W
wtt1995 已提交
789
以异步方法根据给定的bundleFlags和userId获取系统中所有的BundleInfo,使用Promise形式返回结果。
W
wanghang 已提交
790 791 792

**系统接口:** 此接口为系统接口。

W
wangtiantian 已提交
793
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
794 795 796 797 798

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

**参数:**

J
junyi233 已提交
799
| 参数名     | 类型   | 必填 | 说明                                             |
W
wanghang 已提交
800
| ----------- | ------ | ---- | -------------------------------------------------- |
Z
zhaogan 已提交
801
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。                   |
L
Lotol 已提交
802
| userId      | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。                      |
W
wanghang 已提交
803 804 805 806 807

**返回值:**

| 类型                                                         | 说明                                |
| ------------------------------------------------------------ | ----------------------------------- |
Z
zhaogan 已提交
808
| Promise<Array\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>> | Promise对象,返回Array\<BundleInfo>。 |
W
wanghang 已提交
809 810 811

**错误码:**

Z
zengyawen 已提交
812
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
813

J
junyi233 已提交
814
| 错误码ID | 错误信息                         |
W
wanghang 已提交
815
| -------- | ---------------------------------- |
816
| 17700004 | The specified user ID is not found. |
W
wanghang 已提交
817 818 819 820

**示例:**

```ts
L
Lotol 已提交
821
import bundleManager from '@ohos.bundle.bundleManager';
822
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
823
import hilog from '@ohos.hilog';
W
wanghang 已提交
824 825 826 827
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getAllBundleInfo(bundleFlags).then((data) => {
L
longwei 已提交
828
        hilog.info(0x0000, 'testTag', 'getAllBundleInfo successfully. Data: %{public}s', JSON.stringify(data));
829
    }).catch((err: BusinessError) => {
L
longwei 已提交
830
        hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
831
    });
832
} catch (err) {
833 834
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
835 836 837 838 839 840 841
}
```

### bundleManager.getAllApplicationInfo

getAllApplicationInfo(appFlags: [number](#applicationflag), userId: number, callback: AsyncCallback<Array\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>>): void;

W
wtt1995 已提交
842
以异步方法根据给定的appFlags和userId获取系统中所有的ApplicationInfo,使用callback形式返回结果。
W
wanghang 已提交
843 844 845

**系统接口:** 此接口为系统接口。

W
wangtiantian 已提交
846
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
847 848 849 850 851

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

**参数:**

J
junyi233 已提交
852
| 参数名  | 类型   | 必填 | 说明                                                      |
W
wanghang 已提交
853
| -------- | ------ | ---- | ----------------------------------------------------------- |
Z
zhaogan 已提交
854 855 856
| appFlags | [number](#applicationflag) | 是   | 指定返回的ApplicationInfo所包含的信息。                       |
| userId   | number | 是   | 表示用户ID。         |
| callback | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<ApplicationInfo>;否则为错误对象。 |
W
wanghang 已提交
857 858 859

**错误码:**

Z
zengyawen 已提交
860
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
861

J
junyi233 已提交
862
| 错误码ID | 错误信息                         |
W
wanghang 已提交
863
| -------- | ---------------------------------- |
864
| 17700004 | The specified user ID is not found. |
W
wanghang 已提交
865 866 867 868

**示例:**

```ts
L
Lotol 已提交
869
import bundleManager from '@ohos.bundle.bundleManager';
870
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
871
import hilog from '@ohos.hilog';
W
wanghang 已提交
872 873 874 875 876 877
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;
let userId = 100;

try {
    bundleManager.getAllApplicationInfo(appFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
878
            hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
879
        } else {
L
longwei 已提交
880
            hilog.info(0x0000, 'testTag', 'getAllApplicationInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
881 882 883
        }
    });
} catch (err) {
884 885
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', message);
W
wanghang 已提交
886 887 888 889 890 891 892
}
```

### bundleManager.getAllApplicationInfo

getAllApplicationInfo(appFlags: [number](#applicationflag), callback: AsyncCallback<Array\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>>): void;

W
wtt1995 已提交
893
以异步方法根据给定的appFlags获取系统中所有的ApplicationInfo,使用callback形式返回结果。
W
wanghang 已提交
894 895 896

**系统接口:** 此接口为系统接口。

W
wangtiantian 已提交
897
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
898 899 900 901 902

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

**参数:**

J
junyi233 已提交
903
| 参数名  | 类型   | 必填 | 说明                                                      |
W
wanghang 已提交
904
| -------- | ------ | ---- | ----------------------------------------------------------- |
Z
zhaogan 已提交
905 906
| appFlags | [number](#applicationflag) | 是   | 指定返回的ApplicationInfo所包含的信息。                       |
| callback | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<ApplicationInfo>;否则为错误对象。 |
W
wanghang 已提交
907 908 909 910

**示例:**

```ts
L
Lotol 已提交
911
import bundleManager from '@ohos.bundle.bundleManager';
912
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
913
import hilog from '@ohos.hilog';
W
wanghang 已提交
914 915 916 917 918
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;

try {
    bundleManager.getAllApplicationInfo(appFlags, (err, data) => {
        if (err) {
L
longwei 已提交
919
            hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
920
        } else {
L
longwei 已提交
921
            hilog.info(0x0000, 'testTag', 'getAllApplicationInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
922 923 924
        }
    });
} catch (err) {
925 926
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', message);
W
wanghang 已提交
927 928 929 930 931 932 933
}
```

### bundleManager.getAllApplicationInfo

getAllApplicationInfo(appFlags: [number](#applicationflag), userId?: number): Promise<Array\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>>;

W
wtt1995 已提交
934
以异步方法根据给定的appFlags和userId获取系统中所有的ApplicationInfo,使用Promise形式返回结果。
W
wanghang 已提交
935 936 937

**系统接口:** 此接口为系统接口。

W
wangtiantian 已提交
938
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
939 940 941 942 943

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

**参数:**

J
junyi233 已提交
944
| 参数名  | 类型   | 必填 | 说明                                                      |
W
wanghang 已提交
945
| -------- | ------ | ---- | ---------------------------------------------------------- |
Z
zhaogan 已提交
946
| appFlags | [number](#applicationflag) | 是   | 指定返回的ApplicationInfo所包含的信息。                       |
L
Lotol 已提交
947
| userId   | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。                        |
W
wanghang 已提交
948 949 950 951 952

**返回值:**

| 类型                                                         | 说明                                     |
| ------------------------------------------------------------ | ---------------------------------------- |
Z
zhaogan 已提交
953
| Promise<Array\<[ApplicationInfo](js-apis-bundleManager-applicationInfo.md)>> | Promise对象,返回Array\<ApplicationInfo>。 |
W
wanghang 已提交
954 955 956

**错误码:**

Z
zengyawen 已提交
957
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
958

J
junyi233 已提交
959
| 错误码ID | 错误信息                         |
W
wanghang 已提交
960
| -------- | ---------------------------------- |
961
| 17700004 | The specified user ID is not found. |
W
wanghang 已提交
962 963 964 965

**示例:**

```ts
L
Lotol 已提交
966
import bundleManager from '@ohos.bundle.bundleManager';
967
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
968
import hilog from '@ohos.hilog';
W
wanghang 已提交
969 970 971 972
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;

try {
    bundleManager.getAllApplicationInfo(appFlags).then((data) => {
L
longwei 已提交
973
        hilog.info(0x0000, 'testTag', 'getAllApplicationInfo successfully. Data: %{public}s', JSON.stringify(data));
974
    }).catch((err: BusinessError) => {
L
longwei 已提交
975
        hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
976
    });
977
} catch (err) {
978 979
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997
}

```

### bundleManager.queryAbilityInfo

queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), userId: number, callback: AsyncCallback<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>>): void;

以异步方法根据给定的want、abilityFlags和userId获取多个AbilityInfo,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
998
| 参数名      | 类型   | 必填 | 说明                                                  |
W
wanghang 已提交
999
| ------------ | ------ | ---- | ------------------------------------------------------- |
1000
| want         | Want   | 是   | 表示包含要查询的应用Bundle名称的Want。                 |
Z
zhaogan 已提交
1001 1002 1003
| abilityFlags | [number](#abilityflag) | 是   | 指定返回的AbilityInfo所包含的信息。                       |
| userId       | number | 是   | 表示用户ID。                               |
| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<AbilityInfo>;否则为错误对象。 |
W
wanghang 已提交
1004 1005 1006

**错误码:**

Z
zengyawen 已提交
1007
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1008

J
junyi233 已提交
1009
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1010
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1011 1012 1013 1014 1015
| 17700001 | The specified bundleName is not found. |
| 17700003 | The specified ability is not found.    |
| 17700004 | The specified userId is invalid.       |
| 17700026 | The specified bundle is disabled.      |
| 17700029 | The specified ability is disabled.     |
W
wanghang 已提交
1016 1017 1018 1019

**示例:**

```ts
L
Lotol 已提交
1020
import bundleManager from '@ohos.bundle.bundleManager';
1021
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1022
import hilog from '@ohos.hilog';
W
wanghang 已提交
1023 1024 1025 1026
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1027
    abilityName : "EntryAbility"
W
wanghang 已提交
1028 1029 1030 1031 1032
};

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
1033
            hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1034
        } else {
L
longwei 已提交
1035
            hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1036 1037 1038
        }
    });
} catch (err) {
1039 1040
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message);
W
wanghang 已提交
1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057
}
```

### bundleManager.queryAbilityInfo

queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), callback: AsyncCallback<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>>): void;

以异步方法根据给定的want和abilityFlags获取一个或多个AbilityInfo,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
1058
| 参数名      | 类型   | 必填 | 说明                                                  |
W
wanghang 已提交
1059
| ------------ | ------ | ---- | -------------------------------------------------------|
1060
| want         | Want   | 是   | 表示包含要查询的应用Bundle名称的Want。                 |
Z
zhaogan 已提交
1061 1062
| abilityFlags | [number](#abilityflag) | 是   | 指定返回的AbilityInfo所包含的信息。       |
| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<AbilityInfo>;否则为错误对象。 |
W
wanghang 已提交
1063 1064 1065

**错误码:**

Z
zengyawen 已提交
1066
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1067

J
junyi233 已提交
1068
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1069
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1070 1071 1072 1073
| 17700001 | The specified bundleName is not found. |
| 17700003 | The specified ability is not found.    |
| 17700026 | The specified bundle is disabled.      |
| 17700029 | The specified ability is disabled.     |
W
wanghang 已提交
1074 1075 1076 1077

**示例:**

```ts
L
Lotol 已提交
1078
import bundleManager from '@ohos.bundle.bundleManager';
1079
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1080
import hilog from '@ohos.hilog';
W
wanghang 已提交
1081 1082 1083
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let want = {
    bundleName : "com.example.myapplication",
1084
    abilityName : "EntryAbility"
W
wanghang 已提交
1085 1086 1087 1088 1089
};

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, (err, data) => {
        if (err) {
L
longwei 已提交
1090
            hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1091
        } else {
L
longwei 已提交
1092
            hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1093 1094 1095
        }
    });
} catch (err) {
1096 1097
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', message);
W
wanghang 已提交
1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114
}
```

### bundleManager.queryAbilityInfo

queryAbilityInfo(want: Want, abilityFlags: [number](#abilityflag), userId?: number): Promise<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>>;

以异步方法根据给定的want、abilityFlags和userId获取一个或多个AbilityInfo,使用Promise形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
1115
| 参数名      | 类型   | 必填 | 说明                                                  |
W
wanghang 已提交
1116
| ------------ | ------ | ---- | ------------------------------------------------------- |
1117
| want         | Want   | 是   | 表示包含要查询的应用Bundle名称的Want。                 |
Z
zhaogan 已提交
1118
| abilityFlags | [number](#abilityflag) | 是   | 表示指定返回的AbilityInfo所包含的信息。 |
L
Lotol 已提交
1119
| userId       | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。                       |
W
wanghang 已提交
1120 1121 1122 1123 1124

**返回值:**

| 类型                                                         | 说明                                 |
| ------------------------------------------------------------ | ------------------------------------ |
Z
zhaogan 已提交
1125
| Promise<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>> | Promise对象,返回Array\<AbilityInfo>。 |
W
wanghang 已提交
1126 1127 1128

**错误码:**

Z
zengyawen 已提交
1129
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1130

J
junyi233 已提交
1131
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1132
| -------- | ------------------------------------- |
Z
zhaogan 已提交
1133
| 17700001 | The specified bundleName is not found. |
X
xsz233 已提交
1134
| 17700003 | The specified ability is not found.    |
Z
zhaogan 已提交
1135 1136 1137
| 17700004 | The specified userId is invalid.       |
| 17700026 | The specified bundle is disabled.      |
| 17700029 | The specified ability is disabled.     |
W
wanghang 已提交
1138 1139 1140 1141

**示例:**

```ts
L
Lotol 已提交
1142
import bundleManager from '@ohos.bundle.bundleManager';
1143
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1144
import hilog from '@ohos.hilog';
W
wanghang 已提交
1145 1146 1147 1148
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1149
    abilityName : "EntryAbility"
W
wanghang 已提交
1150 1151 1152 1153
};

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((data) => {
L
longwei 已提交
1154
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(data));
1155
    }).catch((err: BusinessError) => {
L
longwei 已提交
1156
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1157
    });
1158
} catch (err) {
1159 1160
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
1161 1162 1163 1164
}
```

```ts
L
Lotol 已提交
1165
import bundleManager from '@ohos.bundle.bundleManager';
1166
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1167
import hilog from '@ohos.hilog';
W
wanghang 已提交
1168 1169 1170
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let want = {
    bundleName : "com.example.myapplication",
1171
    abilityName : "EntryAbility"
W
wanghang 已提交
1172 1173 1174 1175
};

try {
    bundleManager.queryAbilityInfo(want, abilityFlags).then((data) => {
L
longwei 已提交
1176
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(data));
1177
    }).catch((err: BusinessError) => {
L
longwei 已提交
1178
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1179
    })
1180
} catch (err) {
1181 1182
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199
}
```

### bundleManager.queryExtensionAbilityInfo

queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityType](#extensionabilitytype), extensionAbilityFlags: [number](#extensionabilityflag), userId: number, callback: AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>>): void;

以异步方法根据给定的want、extensionAbilityType、extensionAbilityFlags和userId获取一个或多个ExtensionAbilityInfo,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
1200
| 参数名                | 类型                                                         | 必填 | 说明                                                         |
W
wanghang 已提交
1201
| --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
1202 1203 1204 1205
| want                  | Want                                                         | 是   | 表示包含要查询的应用Bundle名称的Want。                       |
| extensionAbilityType  | [ExtensionAbilityType](#extensionabilitytype)                | 是   | 标识extensionAbility的类型。                                 |
| extensionAbilityFlags | [number](#extensionabilityflag)                              | 是   | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。    |
| userId                | number                                                       | 是   | 表示用户ID。                                                 |
Z
zhaogan 已提交
1206
| callback              | AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>> | 是   | 回调函数,当获取成功时,err为null,data为获取到Array\<ExtensionAbilityInfo>;否则为错误对象。 |
W
wanghang 已提交
1207 1208 1209

**错误码:**

Z
zengyawen 已提交
1210
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1211

J
junyi233 已提交
1212 1213
| 错误码ID | 错误信息                                    |
| -------- | ------------------------------------------- |
Z
zhaogan 已提交
1214 1215 1216 1217
| 17700001 | The specified bundleName is not found.       |
| 17700003 | The specified extensionAbility is not found. |
| 17700004 | The specified userId is invalid.             |
| 17700026 | The specified bundle is disabled.            |
W
wanghang 已提交
1218 1219 1220 1221

**示例:**

```ts
L
Lotol 已提交
1222
import bundleManager from '@ohos.bundle.bundleManager';
1223
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1224
import hilog from '@ohos.hilog';
W
wanghang 已提交
1225 1226 1227 1228 1229
let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM;
let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1230
    abilityName : "EntryAbility"
W
wanghang 已提交
1231 1232 1233 1234 1235
};

try {
    bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
1236
            hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1237
        } else {
L
longwei 已提交
1238
            hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1239 1240 1241
        }
    });
} catch (err) {
1242 1243
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message);
W
wanghang 已提交
1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260
}
```

### bundleManager.queryExtensionAbilityInfo

queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityType](#extensionabilitytype), extensionAbilityFlags: [number](#extensionabilityflag), callback: AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>>): void;

以异步方法根据给定的want、extensionAbilityType和extensionAbilityFlags获取一个或多个ExtensionAbilityInfo,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
1261
| 参数名                | 类型                                                         | 必填 | 说明                                                         |
W
wanghang 已提交
1262
| --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
1263 1264 1265
| want                  | Want                                                         | 是   | 表示包含要查询的应用Bundle名称的Want。                       |
| extensionAbilityType  | [ExtensionAbilityType](#extensionabilitytype)                | 是   | 标识extensionAbility的类型。                                 |
| extensionAbilityFlags | [number](#extensionabilityflag)                              | 是   | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。    |
Z
zhaogan 已提交
1266
| callback              | AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>> | 是   | 回调函数,当获取成功时,err为null,data为获取到Array\<ExtensionAbilityInfo>;否则为错误对象。 |
W
wanghang 已提交
1267 1268 1269

**错误码:**

Z
zengyawen 已提交
1270
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1271

J
junyi233 已提交
1272 1273
| 错误码ID | 错误信息                                     |
| -------- | -------------------------------------------- |
Z
zhaogan 已提交
1274 1275 1276
| 17700001 | The specified bundleName is not found.       |
| 17700003 | The specified extensionAbility is not found. |
| 17700026 | The specified bundle is disabled.            |
W
wanghang 已提交
1277 1278 1279 1280

**示例:**

```ts
L
Lotol 已提交
1281
import bundleManager from '@ohos.bundle.bundleManager';
1282
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1283
import hilog from '@ohos.hilog';
W
wanghang 已提交
1284 1285 1286 1287
let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM;
let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT;
let want = {
    bundleName : "com.example.myapplication",
1288
    abilityName : "EntryAbility"
W
wanghang 已提交
1289 1290 1291 1292 1293
};

try {
    bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, (err, data) => {
        if (err) {
L
longwei 已提交
1294
            hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1295
        } else {
L
longwei 已提交
1296
            hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1297 1298 1299
        }
    });
} catch (err) {
1300 1301
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', message);
W
wanghang 已提交
1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318
}
```

### bundleManager.queryExtensionAbilityInfo

queryExtensionAbilityInfo(want: Want, extensionAbilityType: [ExtensionAbilityType](#extensionabilitytype), extensionAbilityFlags: [number](#extensionabilityflag), userId?: number): Promise<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>>;

以异步方法根据给定的want、extensionAbilityType、extensionAbilityFlags和userId获取ExtensionAbilityInfo,使用Promise形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

1319 1320 1321
| 参数名                | 类型                                          | 必填 | 说明                                                      |
| --------------------- | --------------------------------------------- | ---- | --------------------------------------------------------- |
| want                  | Want                                          | 是   | 表示包含要查询的应用Bundle名称的Want。                    |
Z
zhaogan 已提交
1322 1323
| extensionAbilityType  | [ExtensionAbilityType](#extensionabilitytype) | 是   | 标识extensionAbility的类型。                              |
| extensionAbilityFlags | [number](#extensionabilityflag)               | 是   | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 |
L
Lotol 已提交
1324
| userId                | number                                        | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。                                              |
W
wanghang 已提交
1325 1326 1327 1328 1329

**返回值:**

| 类型                                                         | 说明                                          |
| ------------------------------------------------------------ | --------------------------------------------- |
Z
zhaogan 已提交
1330
| Promise<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>> | Promise对象,返回Array\<ExtensionAbilityInfo>。 |
W
wanghang 已提交
1331 1332 1333

**错误码:**

Z
zengyawen 已提交
1334
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1335

J
junyi233 已提交
1336
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1337
| -------- | --------------------------------------|
Z
zhaogan 已提交
1338 1339 1340 1341
| 17700001 | The specified bundleName is not found. |
| 17700003 | The specified extensionAbility is not found.    |
| 17700004 | The specified userId is invalid.       |
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
1342 1343 1344 1345

**示例:**

```ts
L
Lotol 已提交
1346
import bundleManager from '@ohos.bundle.bundleManager';
1347
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1348
import hilog from '@ohos.hilog';
W
wanghang 已提交
1349 1350 1351 1352 1353 1354

let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM;
let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1355
    abilityName : "EntryAbility"
W
wanghang 已提交
1356 1357 1358 1359
};

try {
    bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, userId).then((data) => {
L
longwei 已提交
1360
        hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo successfully. Data: %{public}s', JSON.stringify(data));
1361
    }).catch(err => {
L
longwei 已提交
1362
        hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1363
    });
1364
} catch (err) {
1365 1366
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
1367 1368 1369 1370
}
```

```ts
L
Lotol 已提交
1371
import bundleManager from '@ohos.bundle.bundleManager';
1372
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1373
import hilog from '@ohos.hilog';
W
wanghang 已提交
1374 1375 1376 1377
let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM;
let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT;
let want = {
    bundleName : "com.example.myapplication",
1378
    abilityName : "EntryAbility"
W
wanghang 已提交
1379 1380 1381 1382
};

try {
    bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags).then((data) => {
L
longwei 已提交
1383
        hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo successfully. Data: %{public}s', JSON.stringify(data));
1384
    }).catch((err: BusinessError) => {
L
longwei 已提交
1385
        hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1386
    })
1387
} catch (err) {
1388 1389
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
1390 1391 1392 1393 1394 1395 1396
}
```

### bundleManager.getBundleNameByUid

getBundleNameByUid(uid: number, callback: AsyncCallback\<string>): void;

W
wtt1995 已提交
1397
以异步方法根据给定的uid获取对应的bundleName,使用callback形式返回结果。
W
wanghang 已提交
1398 1399 1400 1401 1402 1403 1404 1405 1406

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
1407
| 参数名   | 类型                   | 必填 | 说明                                                         |
W
wanghang 已提交
1408
| -------- | ---------------------- | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
1409 1410
| uid      | number                 | 是   | 表示应用程序的UID。                                            |
| callback | AsyncCallback\<string> | 是   | 回调函数,当获取成功时,err为null,data为获取到的BundleName;否则为错误对象。 |
W
wanghang 已提交
1411 1412 1413

**错误码:**

Z
zengyawen 已提交
1414
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1415

J
junyi233 已提交
1416
| 错误码ID | 错误信息            |
W
wanghang 已提交
1417
| -------- | --------------------- |
Z
zhaogan 已提交
1418
| 17700021 | The uid is not found. |
W
wanghang 已提交
1419 1420 1421 1422

**示例:**

```ts
L
Lotol 已提交
1423
import bundleManager from '@ohos.bundle.bundleManager';
1424
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1425
import hilog from '@ohos.hilog';
W
wanghang 已提交
1426 1427 1428 1429
let uid = 20010005;
try {
    bundleManager.getBundleNameByUid(uid, (err, data) => {
        if (err) {
L
longwei 已提交
1430
            hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', err.message);
W
wanghang 已提交
1431
        } else {
L
longwei 已提交
1432
            hilog.info(0x0000, 'testTag', 'getBundleNameByUid successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1433 1434 1435
        }
    });
} catch (err) {
1436 1437
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', message);
W
wanghang 已提交
1438 1439 1440 1441 1442 1443 1444
}
```

### bundleManager.getBundleNameByUid

getBundleNameByUid(uid: number): Promise\<string>;

W
wtt1995 已提交
1445
以异步方法根据给定的uid获取对应的bundleName,使用Promise形式返回结果。
W
wanghang 已提交
1446 1447 1448 1449 1450 1451 1452 1453 1454

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
1455
| 参数名 | 类型   | 必填 | 说明                |
W
wanghang 已提交
1456
| ---- | ------ | ---- | ------------------ |
Z
zhaogan 已提交
1457
| uid  | number | 是   | 表示应用程序的UID。 |
W
wanghang 已提交
1458 1459 1460 1461 1462

**返回值:**

| 类型             | 说明                        |
| ---------------- | --------------------------- |
Z
zhaogan 已提交
1463
| Promise\<string> | Promise对象,返回bundleName。 |
W
wanghang 已提交
1464 1465 1466

**错误码:**

Z
zengyawen 已提交
1467
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1468

J
junyi233 已提交
1469
| 错误码ID | 错误信息            |
W
wanghang 已提交
1470
| -------- | ---------------------|
Z
zhaogan 已提交
1471
| 17700021 | The uid is not found. |
W
wanghang 已提交
1472 1473 1474 1475

**示例:**

```ts
L
Lotol 已提交
1476
import bundleManager from '@ohos.bundle.bundleManager';
1477
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1478
import hilog from '@ohos.hilog';
W
wanghang 已提交
1479 1480 1481
let uid = 20010005;
try {
    bundleManager.getBundleNameByUid(uid).then((data) => {
L
longwei 已提交
1482
        hilog.info(0x0000, 'testTag', 'getBundleNameByUid successfully. Data: %{public}s', JSON.stringify(data));
1483
    }).catch(err => {
L
longwei 已提交
1484
        hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1485
    });
1486
} catch (err) {
1487 1488
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed. Cause: %{public}s', message);
W
wanghang 已提交
1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505
}
```

### bundleManager.getBundleArchiveInfo

getBundleArchiveInfo(hapFilePath: string, bundleFlags: [number](#bundleflag), callback: AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>): void;

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

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

J
junyi233 已提交
1506
| 参数名       | 类型   | 必填 | 说明                                                         |
W
wanghang 已提交
1507
| ----------- | ------ | ---- | ----------------------------------------------------------- |
Z
zhaogan 已提交
1508 1509 1510
| hapFilePath | string | 是   | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径。 |
| bundleFlags | [number](#bundleflag) | 是   | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。       |
| callback | AsyncCallback\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | 是 | 回调函数,当获取成功时,err为null,data为获取到的BundleInfo;否则为错误对象。 |
W
wanghang 已提交
1511 1512 1513

**错误码:**

Z
zengyawen 已提交
1514
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1515

J
junyi233 已提交
1516
| 错误码ID | 错误信息                  |
W
wanghang 已提交
1517
| -------- | --------------------------- |
Z
zhaogan 已提交
1518
| 17700022 | The hapFilePath is invalid. |
W
wanghang 已提交
1519 1520 1521 1522

**示例:**

```ts
L
Lotol 已提交
1523
import bundleManager from '@ohos.bundle.bundleManager';
1524
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1525
import hilog from '@ohos.hilog';
W
wanghang 已提交
1526 1527 1528 1529 1530 1531
let hapFilePath = "/data/xxx/test.hap";
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
        if (err) {
L
longwei 已提交
1532
            hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1533
        } else {
L
longwei 已提交
1534
            hilog.info(0x0000, 'testTag', 'getBundleArchiveInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1535 1536 1537
        }
    });
} catch (err) {
1538 1539
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556
}
```

### bundleManager.getBundleArchiveInfo

getBundleArchiveInfo(hapFilePath: string,  bundleFlags: [number](#bundleflag)): Promise\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)>;

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

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

J
junyi233 已提交
1557
| 参数名       | 类型   | 必填 | 说明                                                         |
W
wanghang 已提交
1558
| ----------- | ------ | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
1559 1560
| hapFilePath | string | 是   | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径。 |
| bundleFlags | [number](#bundleflag) | 是   | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。       |
W
wanghang 已提交
1561 1562 1563 1564 1565

**返回值:**

| 类型                                                        | 说明                        |
| ----------------------------------------------------------- | --------------------------- |
Z
zhaogan 已提交
1566
| Promise\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | Promise对象,返回BundleInfo。 |
W
wanghang 已提交
1567 1568 1569

**错误码:**

Z
zengyawen 已提交
1570
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1571

J
junyi233 已提交
1572
| 错误码ID | 错误信息                   |
W
wanghang 已提交
1573
| -------- | -------------------------- |
Z
zhaogan 已提交
1574
| 17700022 | The hapFilePath is invalid. |
W
wanghang 已提交
1575 1576 1577 1578

**示例:**

```ts
L
Lotol 已提交
1579
import bundleManager from '@ohos.bundle.bundleManager';
1580
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1581
import hilog from '@ohos.hilog';
W
wanghang 已提交
1582 1583 1584 1585 1586
let hapFilePath = "/data/xxx/test.hap";
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getBundleArchiveInfo(hapFilePath, bundleFlags).then((data) => {
L
longwei 已提交
1587
        hilog.info(0x0000, 'testTag', 'getBundleArchiveInfo successfully. Data: %{public}s', JSON.stringify(data));
1588
    }).catch((err: BusinessError) => {
L
longwei 已提交
1589
        hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1590
    });
1591
} catch (err) {
1592 1593
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
1594 1595 1596 1597 1598 1599 1600
}
```

### bundleManager.cleanBundleCacheFiles

cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback\<void>): void;

W
wtt1995 已提交
1601
以异步方法根据给定的bundleName清理BundleCache,使用callback形式返回结果。
W
wanghang 已提交
1602 1603 1604 1605 1606 1607 1608 1609 1610

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.REMOVE_CACHE_FILES

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

**参数:**

J
junyi233 已提交
1611
| 参数名     | 类型                 | 必填 | 说明                                                         |
W
wanghang 已提交
1612
| ---------- | -------------------- | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
1613 1614
| bundleName | string               | 是   | 表示要清理其缓存数据的应用程序的bundleName。                   |
| callback   | AsyncCallback\<void> | 是   | 回调函数,当清理应用缓存目录数据成功,err为null,否则为错误对象。 |
W
wanghang 已提交
1615 1616 1617

**错误码:**

Z
zengyawen 已提交
1618
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1619

J
junyi233 已提交
1620
| 错误码ID | 错误信息                                                     |
W
wanghang 已提交
1621
| -------- | ------------------------------------------------------------ |
Z
zhaogan 已提交
1622
| 17700001 | The specified bundleName is not found.                        |
1623
| 17700030 | The specified bundle does not support clearing of cache files. |
W
wanghang 已提交
1624 1625 1626 1627

**示例:**

```ts
L
Lotol 已提交
1628
import bundleManager from '@ohos.bundle.bundleManager';
1629
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1630
import hilog from '@ohos.hilog';
W
wanghang 已提交
1631 1632 1633 1634 1635
let bundleName = "com.ohos.myapplication";

try {
    bundleManager.cleanBundleCacheFiles(bundleName, err => {
        if (err) {
L
longwei 已提交
1636
            hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', err.message);
W
wanghang 已提交
1637
        } else {
G
geng-wenguang 已提交
1638
            hilog.info(0x0000, 'testTag', 'cleanBundleCacheFiles successfully.');
W
wanghang 已提交
1639 1640 1641
        }
    });
} catch (err) {
1642 1643
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', message);
W
wanghang 已提交
1644 1645 1646 1647 1648 1649 1650
}
```

### bundleManager.cleanBundleCacheFiles

cleanBundleCacheFiles(bundleName: string): Promise\<void>;

W
wtt1995 已提交
1651
以异步方法根据给定的bundleName清理BundleCache,使用Promise形式返回结果。
W
wanghang 已提交
1652 1653 1654 1655 1656 1657 1658 1659 1660

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.REMOVE_CACHE_FILES

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

**参数:**

J
junyi233 已提交
1661 1662
| 参数名     | 类型   | 必填 | 说明                                       |
| ---------- | ------ | ---- | ------------------------------------------ |
Z
zhaogan 已提交
1663
| bundleName | string | 是   | 表示要清理其缓存数据的应用程序的bundleName。 |
W
wanghang 已提交
1664 1665 1666 1667 1668

**返回值:**

| 类型           | 说明                                                         |
| -------------- | ------------------------------------------------------------ |
W
wtt1995 已提交
1669
| Promise\<void> | 无返回结果的Promise对象。当清理应用缓存目录数据失败会抛出错误对象。 |
W
wanghang 已提交
1670 1671 1672

**错误码:**

Z
zengyawen 已提交
1673
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1674

J
junyi233 已提交
1675 1676
| 错误码ID | 错误信息                                                   |
| -------- | ---------------------------------------------------------- |
Z
zhaogan 已提交
1677
| 17700001 | The specified bundleName is not found.                      |
J
junyi233 已提交
1678
| 17700030 | The specified bundle does not support clearing of cache files. |
W
wanghang 已提交
1679 1680 1681 1682

**示例:**

```ts
L
Lotol 已提交
1683
import bundleManager from '@ohos.bundle.bundleManager';
1684
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1685
import hilog from '@ohos.hilog';
W
wanghang 已提交
1686 1687 1688
let bundleName = "com.ohos.myapplication";

try {
W
wtt1995 已提交
1689
    bundleManager.cleanBundleCacheFiles(bundleName).then(() => {
G
geng-wenguang 已提交
1690
        hilog.info(0x0000, 'testTag', 'cleanBundleCacheFiles successfully.');
1691
    }).catch((err: BusinessError) => {
L
longwei 已提交
1692
        hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', err.message);
W
wanghang 已提交
1693 1694
    });
} catch (err) {
1695 1696
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', message);
W
wanghang 已提交
1697 1698 1699 1700 1701 1702 1703
}
```

### bundleManager.setApplicationEnabled

setApplicationEnabled(bundleName: string, isEnabled: boolean, callback: AsyncCallback\<void>): void;

W
wtt1995 已提交
1704
设置指定应用的禁用或使能状态,使用callback形式返回结果。
W
wanghang 已提交
1705 1706 1707 1708 1709 1710 1711 1712 1713

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.CHANGE_ABILITY_ENABLED_STATE

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

**参数:**

J
junyi233 已提交
1714
| 参数名      | 类型    | 必填 | 说明                                  |
W
wanghang 已提交
1715
| ---------- | ------- | ---- | ------------------------------------- |
Z
zhaogan 已提交
1716 1717
| bundleName | string  | 是   | 指定应用的bundleName。                |
| isEnabled  | boolean | 是   | 值为true表示使能,值为false表示禁用。 |
W
wtt1995 已提交
1718
| callback | AsyncCallback\<void> | 是 | 回调函数,当设置应用禁用或使能状态成功时,err为null,否则为错误对象。 |
W
wanghang 已提交
1719 1720 1721

**错误码:**

Z
zengyawen 已提交
1722
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1723

J
junyi233 已提交
1724
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1725
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1726
| 17700001 | The specified bundleName is not found. |
W
wanghang 已提交
1727 1728 1729 1730

**示例:**

```ts
L
Lotol 已提交
1731
import bundleManager from '@ohos.bundle.bundleManager';
1732
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1733
import hilog from '@ohos.hilog';
W
wanghang 已提交
1734 1735 1736 1737 1738
let bundleName = "com.ohos.myapplication";

try {
    bundleManager.setApplicationEnabled(bundleName, false, err => {
        if (err) {
L
longwei 已提交
1739
            hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1740
        } else {
G
geng-wenguang 已提交
1741
            hilog.info(0x0000, 'testTag', 'setApplicationEnabled successfully.');
W
wanghang 已提交
1742 1743 1744
        }
    });
} catch (err) {
1745 1746
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', message);
W
wanghang 已提交
1747 1748 1749 1750 1751 1752 1753
}
```

### bundleManager.setApplicationEnabled

setApplicationEnabled(bundleName: string, isEnabled: boolean): Promise\<void>;

W
wtt1995 已提交
1754
设置指定应用的禁用或使能状态,使用Promise形式返回结果。
W
wanghang 已提交
1755 1756 1757 1758 1759 1760 1761 1762 1763

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.CHANGE_ABILITY_ENABLED_STATE

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

**参数:**

J
junyi233 已提交
1764
| 参数名      | 类型    | 必填 | 说明                                  |
W
wanghang 已提交
1765
| ---------- | ------- | ---- | ------------------------------------- |
Z
zhaogan 已提交
1766 1767
| bundleName | string  | 是   | 表示应用程序的bundleName。            |
| isEnabled  | boolean | 是   | 值为true表示使能,值为false表示禁用。 |
W
wanghang 已提交
1768 1769 1770 1771 1772

**返回值:**

| 类型           | 说明                                 |
| -------------- | ------------------------------------ |
Z
zhaogan 已提交
1773
| Promise\<void> | Promise对象。无返回结果的Promise对象。 |
W
wanghang 已提交
1774 1775 1776

**错误码:**

Z
zengyawen 已提交
1777
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1778

J
junyi233 已提交
1779
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1780
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1781
| 17700001 | The specified bundleName is not found. |
W
wanghang 已提交
1782 1783 1784 1785

**示例:**

```ts
L
Lotol 已提交
1786
import bundleManager from '@ohos.bundle.bundleManager';
1787
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1788
import hilog from '@ohos.hilog';
W
wanghang 已提交
1789 1790 1791
let bundleName = "com.ohos.myapplication";

try {
W
wtt1995 已提交
1792
    bundleManager.setApplicationEnabled(bundleName, false).then(() => {
G
geng-wenguang 已提交
1793
        hilog.info(0x0000, "testTag", "setApplicationEnabled successfully.");
W
wtt1995 已提交
1794
    }).catch(err => {
L
longwei 已提交
1795
        hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1796 1797
    });
} catch (err) {
1798 1799
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', message);
W
wanghang 已提交
1800 1801 1802 1803 1804 1805 1806
}
```

### bundleManager.setAbilityEnabled

setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isEnabled: boolean, callback: AsyncCallback\<void>): void;

W
wtt1995 已提交
1807
设置指定组件的禁用或使能状态,使用callback形式返回结果。
W
wanghang 已提交
1808 1809 1810 1811 1812 1813 1814 1815 1816

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.CHANGE_ABILITY_ENABLED_STATE

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

**参数:**

J
junyi233 已提交
1817
| 参数名    | 类型        | 必填 | 说明                                  |
W
wanghang 已提交
1818
| -------- | ----------- | ---- | ------------------------------------- |
Z
zhaogan 已提交
1819 1820
| info     | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是   | 需要被设置的组件。              |
| isEnabled| boolean     | 是   | 值为true表示使能,值为false表示禁用。 |
W
wtt1995 已提交
1821
| callback | AsyncCallback\<void> | 是 | 回调函数,当设置组件禁用或使能状态成功时,err为null,否则为错误对象。 |
W
wanghang 已提交
1822 1823 1824

**错误码:**

Z
zengyawen 已提交
1825
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1826

J
junyi233 已提交
1827
| 错误码ID | 错误信息                              |
W
wanghang 已提交
1828
| -------- | ---------------------------------------|
Z
zhaogan 已提交
1829 1830
| 17700001 | The specified bundleName is not found.  |
| 17700003 | The specified abilityInfo is not found. |
W
wanghang 已提交
1831 1832 1833 1834

**示例:**

```ts
L
Lotol 已提交
1835
import bundleManager from '@ohos.bundle.bundleManager';
1836
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1837
import hilog from '@ohos.hilog';
W
wanghang 已提交
1838 1839 1840 1841
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1842
    abilityName : "EntryAbility"
W
wanghang 已提交
1843
};
1844
let info;
W
wanghang 已提交
1845 1846 1847

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((abilitiesInfo) => {
L
longwei 已提交
1848
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(abilitiesInfo));
W
wanghang 已提交
1849 1850 1851 1852
        info = abilitiesInfo[0];

        bundleManager.setAbilityEnabled(info, false, err => {
            if (err) {
L
longwei 已提交
1853
                hilog.error(0x0000, 'testTag', 'setAbilityEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1854
            } else {
1855
                hilog.info(0x0001, "testTag", "setAbilityEnabled successfully.");
W
wanghang 已提交
1856 1857
            }
        });
1858
    }).catch(err => {
L
longwei 已提交
1859
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1860
    });
1861
} catch (err) {
1862 1863
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
1864 1865 1866 1867 1868 1869 1870
}
```

### bundleManager.setAbilityEnabled

setAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isEnabled: boolean): Promise\<void>;

W
wtt1995 已提交
1871
设置指定组件的禁用或使能状态,使用Promise形式返回结果。
W
wanghang 已提交
1872 1873 1874 1875 1876 1877 1878 1879 1880

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.CHANGE_ABILITY_ENABLED_STATE

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

**参数:**

J
junyi233 已提交
1881
| 参数名    | 类型        | 必填 | 说明                                  |
W
wanghang 已提交
1882
| -------- | ----------- | ---- | ------------------------------------- |
Z
zhaogan 已提交
1883 1884
| info     | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是   | 需要被设置的组件。                   |
| isEnabled| boolean     | 是   | 值为true表示使能,值为false表示禁用。 |
W
wanghang 已提交
1885 1886 1887 1888 1889

**返回值:**

| 类型           | 说明                              |
| -------------- | --------------------------------- |
Z
zhaogan 已提交
1890
| Promise\<void> | Promise对象。无返回结果的Promise对象。 |
W
wanghang 已提交
1891 1892 1893

**错误码:**

Z
zengyawen 已提交
1894
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1895

J
junyi233 已提交
1896
| 错误码ID | 错误信息                              |
W
wanghang 已提交
1897
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1898 1899
| 17700001 | The specified bundleName is not found.  |
| 17700003 | The specified abilityInfo is not found. |
W
wanghang 已提交
1900 1901 1902 1903

**示例:**

```ts
L
Lotol 已提交
1904
import bundleManager from '@ohos.bundle.bundleManager';
1905
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1906
import hilog from '@ohos.hilog';
W
wanghang 已提交
1907 1908 1909 1910
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1911
    abilityName : "EntryAbility"
W
wanghang 已提交
1912
};
1913
let info;
W
wanghang 已提交
1914 1915 1916

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((abilitiesInfo) => {
L
longwei 已提交
1917
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(abilitiesInfo));
W
wanghang 已提交
1918 1919
        info = abilitiesInfo[0];

W
wtt1995 已提交
1920
        bundleManager.setAbilityEnabled(info, false).then(() => {
G
geng-wenguang 已提交
1921
            hilog.info(0x0000, "testTag", "setAbilityEnabled successfully.");
W
wtt1995 已提交
1922
        }).catch(err => {
L
longwei 已提交
1923
            hilog.error(0x0000, 'testTag', 'setAbilityEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1924
        });
1925
    }).catch(err => {
L
longwei 已提交
1926
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1927
    });
1928
} catch (err) {
1929 1930
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
1931 1932 1933 1934 1935 1936 1937
}
```

### bundleManager.isApplicationEnabled

isApplicationEnabled(bundleName: string, callback: AsyncCallback\<boolean>): void;

W
wtt1995 已提交
1938
以异步的方法获取指定应用的禁用或使能状态,使用callback形式返回结果。
W
wanghang 已提交
1939 1940 1941 1942 1943 1944 1945

**系统接口:** 此接口为系统接口。

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

**参数:**

J
junyi233 已提交
1946
| 参数名      | 类型   | 必填 | 说明                       |
W
wanghang 已提交
1947
| ---------- | ------ | ---- | -------------------------- |
Z
zhaogan 已提交
1948 1949
| bundleName | string | 是   | 表示应用程序的bundleName。 |
| callback | AsyncCallback\<boolean> | 是 | 回调函数,返回true表示当前应用为使能状态,返回false表示应用为禁用状态。 |
W
wanghang 已提交
1950 1951 1952

**错误码:**

Z
zengyawen 已提交
1953
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
1954

J
junyi233 已提交
1955
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1956
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1957
| 17700001 | The specified bundleName is not found. |
W
wanghang 已提交
1958 1959 1960 1961

**示例:**

```ts
L
Lotol 已提交
1962
import bundleManager from '@ohos.bundle.bundleManager';
1963
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
1964
import hilog from '@ohos.hilog';
W
wanghang 已提交
1965 1966 1967 1968 1969
let bundleName = 'com.example.myapplication';

try {
    bundleManager.isApplicationEnabled(bundleName, (err, data) => {
        if (err) {
L
longwei 已提交
1970
            hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1971
        } else {
L
longwei 已提交
1972
            hilog.info(0x0000, 'testTag', 'isApplicationEnabled successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1973 1974 1975
        }
    });
} catch (err) {
1976 1977
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed: %{public}s', message);
W
wanghang 已提交
1978 1979 1980 1981 1982 1983 1984
}
```

### bundleManager.isApplicationEnabled

isApplicationEnabled(bundleName: string): Promise\<boolean>;

W
wtt1995 已提交
1985
以异步的方法获取指定应用的禁用或使能状态,使用Promise形式返回结果。
W
wanghang 已提交
1986 1987 1988 1989 1990 1991 1992

**系统接口:** 此接口为系统接口。

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

**参数:**

J
junyi233 已提交
1993
| 参数名      | 类型   | 必填 | 说明                       |
W
wanghang 已提交
1994
| ---------- | ------ | ---- | -------------------------- |
Z
zhaogan 已提交
1995
| bundleName | string | 是   | 表示应用程序的bundleName。  |
W
wanghang 已提交
1996 1997 1998 1999 2000 2001 2002 2003 2004

**返回值:**

| 类型              | 说明                                                         |
| ----------------- | ------------------------------------------------------------ |
| Promise\<boolean> | Promise对象,返回true表示当前应用为使能状态,返回false表示当前应用为禁用状态。 |

**错误码:**

Z
zengyawen 已提交
2005
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2006

J
junyi233 已提交
2007
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2008
| -------- | -------------------------------------- |
Z
zhaogan 已提交
2009
| 17700001 | The specified bundleName is not found. |
W
wanghang 已提交
2010 2011 2012 2013

**示例:**

```ts
L
Lotol 已提交
2014
import bundleManager from '@ohos.bundle.bundleManager';
2015
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2016
import hilog from '@ohos.hilog';
W
wanghang 已提交
2017 2018 2019 2020
let bundleName = 'com.example.myapplication';

try {
    bundleManager.isApplicationEnabled(bundleName).then((data) => {
L
longwei 已提交
2021
        hilog.info(0x0000, 'testTag', 'isApplicationEnabled successfully. Data: %{public}s', JSON.stringify(data));
2022
    }).catch((err: BusinessError) => {
L
longwei 已提交
2023
        hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2024
    });
2025
} catch (err) {
2026 2027
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed. Cause: %{public}s', message);
W
wanghang 已提交
2028 2029 2030 2031 2032 2033 2034
}
```

### bundleManager.isAbilityEnabled

isAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), callback: AsyncCallback\<boolean>): void;

W
wtt1995 已提交
2035
以异步的方法获取指定组件的禁用或使能状态,使用callback形式返回结果。
W
wanghang 已提交
2036 2037 2038 2039 2040 2041 2042

**系统接口:** 此接口为系统接口。

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

**参数:**

J
junyi233 已提交
2043
| 参数名 | 类型        | 必填 | 说明                        |
W
wanghang 已提交
2044
| ---- | ----------- | ---- | --------------------------- |
Z
zhaogan 已提交
2045 2046
| info | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是   | 表示关于检查ability的信息。 |
| callback | AsyncCallback\<boolean> | 是 | 回调函数,返回true表示当前应用组件为使能状态,返回false表示应用组件为禁用状态。 |
W
wanghang 已提交
2047 2048 2049

**错误码:**

Z
zengyawen 已提交
2050
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2051

J
junyi233 已提交
2052
| 错误码ID | 错误信息                              |
W
wanghang 已提交
2053
| -------- | --------------------------------------- |
Z
zhaogan 已提交
2054 2055
| 17700001 | The specified bundleName is not found.  |
| 17700003 | The specified abilityName is not found. |
W
wanghang 已提交
2056 2057 2058 2059

**示例:**

```ts
L
Lotol 已提交
2060
import bundleManager from '@ohos.bundle.bundleManager';
2061
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2062
import hilog from '@ohos.hilog';
W
wanghang 已提交
2063 2064 2065 2066
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
2067
    abilityName : "EntryAbility"
W
wanghang 已提交
2068
};
2069
let info;
W
wanghang 已提交
2070 2071 2072

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((abilitiesInfo) => {
L
longwei 已提交
2073
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(abilitiesInfo));
W
wanghang 已提交
2074 2075 2076 2077
        info = abilitiesInfo[0];

        bundleManager.isAbilityEnabled(info, (err, data) => {
            if (err) {
L
longwei 已提交
2078
                hilog.error(0x0000, 'testTag', 'isAbilityEnabled failed: %{public}s', err.message);
W
wanghang 已提交
2079
            } else {
L
longwei 已提交
2080
                hilog.info(0x0000, 'testTag', 'isAbilityEnabled successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2081 2082
            }
        });
2083
    }).catch((err: BusinessError) => {
L
longwei 已提交
2084
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2085
    });
2086
} catch (err) {
2087 2088
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
2089 2090 2091 2092 2093 2094 2095
}
```

### bundleManager.isAbilityEnabled

isAbilityEnabled(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md)): Promise\<boolean>;

W
wtt1995 已提交
2096
以异步的方法获取指定组件的禁用或使能状态,使用Promise形式返回结果。
W
wanghang 已提交
2097 2098 2099 2100 2101 2102 2103

**系统接口:** 此接口为系统接口。

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

**参数:**

J
junyi233 已提交
2104
| 参数名 | 类型        | 必填 | 说明                        |
W
wanghang 已提交
2105
| ---- | ----------- | ---- | --------------------------- |
Z
zhaogan 已提交
2106
| info | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是   | 表示关于检查ability的信息。 |
W
wanghang 已提交
2107 2108 2109 2110 2111 2112 2113 2114 2115

**返回值:**

| 类型              | 说明                                                         |
| ----------------- | ------------------------------------------------------------ |
| Promise\<boolean> | Promise对象,返回true表示当前应用组件为使能状态,返回false表示当前应用组件为禁用状态。 |

**错误码:**

Z
zengyawen 已提交
2116
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2117

J
junyi233 已提交
2118
| 错误码ID | 错误信息                              |
W
wanghang 已提交
2119
| -------- | --------------------------------------- |
Z
zhaogan 已提交
2120 2121
| 17700001 | The specified bundleName is not found.  |
| 17700003 | The specified abilityName is not found. |
W
wanghang 已提交
2122 2123 2124 2125

**示例:**

```ts
L
Lotol 已提交
2126
import bundleManager from '@ohos.bundle.bundleManager';
2127
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2128
import hilog from '@ohos.hilog';
W
wanghang 已提交
2129 2130 2131 2132
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
2133
    abilityName : "EntryAbility"
W
wanghang 已提交
2134
};
2135
let info;
W
wanghang 已提交
2136 2137 2138

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((abilitiesInfo) => {
L
longwei 已提交
2139
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(abilitiesInfo));
W
wanghang 已提交
2140 2141 2142
        info = abilitiesInfo[0];

        bundleManager.isAbilityEnabled(info).then((data) => {
L
longwei 已提交
2143
            hilog.info(0x0000, 'testTag', 'isAbilityEnabled successfully. Data: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2144
        }).catch(err => {
L
longwei 已提交
2145
            hilog.error(0x0000, 'testTag', 'isAbilityEnabled failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2146
        });
2147
    }).catch(err => {
L
longwei 已提交
2148
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2149
    });
2150
} catch (err) {
2151 2152
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', message);
W
wanghang 已提交
2153 2154 2155 2156 2157 2158 2159
}
```

### bundleManager.getLaunchWantForBundle

getLaunchWantForBundle(bundleName: string, userId: number, callback: AsyncCallback\<Want>): void;

W
wtt1995 已提交
2160
以异步方法根据给定的bundleName和userId获取用于启动应用程序的Want参数,使用callback形式返回结果。
W
wanghang 已提交
2161 2162 2163 2164 2165 2166 2167 2168 2169

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

J
junyi233 已提交
2170
| 参数名     | 类型                 | 必填 | 说明                                                         |
W
wanghang 已提交
2171
| ---------- | -------------------- | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
2172 2173 2174
| bundleName | string               | 是   | 表示应用程序的bundleName。                                     |
| userId     | number               | 是   | 表示用户ID。                                                   |
| callback   | AsyncCallback\<Want> | 是   | 回调函数,当获取成功时,err为null,data为获取到的Want;否则为错误对象。 |
W
wanghang 已提交
2175 2176 2177

**错误码:**

Z
zengyawen 已提交
2178
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2179

J
junyi233 已提交
2180
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2181
| -------- | --------------------------------------|
Z
zhaogan 已提交
2182
| 17700001 | The specified bundleName is not found. |
J
junyi233 已提交
2183
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
2184
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
2185 2186 2187 2188

**示例:**

```ts
L
Lotol 已提交
2189
import bundleManager from '@ohos.bundle.bundleManager';
2190
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2191
import hilog from '@ohos.hilog';
W
wanghang 已提交
2192 2193 2194 2195 2196 2197
let bundleName = 'com.example.myapplication';
let userId = 100;

try {
    bundleManager.getLaunchWantForBundle(bundleName, userId, (err, data) => {
        if (err) {
L
longwei 已提交
2198
            hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', err.message);
W
wanghang 已提交
2199
        } else {
L
longwei 已提交
2200
            hilog.info(0x0000, 'testTag', 'getLaunchWantForBundle successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2201 2202 2203
        }
    });
} catch (err) {
2204 2205
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', message);
W
wanghang 已提交
2206 2207 2208 2209 2210 2211 2212
}
```

### bundleManager.getLaunchWantForBundle

getLaunchWantForBundle(bundleName: string, callback: AsyncCallback\<Want>): void;

W
wtt1995 已提交
2213
以异步方法根据给定的bundleName获取用于启动应用程序的Want参数,使用callback形式返回结果。
W
wanghang 已提交
2214 2215 2216 2217 2218 2219 2220 2221 2222

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

J
junyi233 已提交
2223
| 参数名     | 类型                 | 必填 | 说明                                                         |
W
wanghang 已提交
2224
| ---------- | -------------------- | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
2225 2226
| bundleName | string               | 是   | 表示应用程序的bundleName。                                     |
| callback   | AsyncCallback\<Want> | 是   | 回调函数,当获取成功时,err为null,data为获取到的Want;否则为错误对象。 |
W
wanghang 已提交
2227 2228 2229

**错误码:**

Z
zengyawen 已提交
2230
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2231

J
junyi233 已提交
2232
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2233
| -------- | --------------------------------------|
Z
zhaogan 已提交
2234 2235
| 17700001 | The specified bundleName is not found. |
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
2236 2237 2238 2239

**示例:**

```ts
L
Lotol 已提交
2240
import bundleManager from '@ohos.bundle.bundleManager';
2241
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2242
import hilog from '@ohos.hilog';
W
wanghang 已提交
2243 2244 2245 2246 2247
let bundleName = 'com.example.myapplication';

try {
    bundleManager.getLaunchWantForBundle(bundleName, (err, data) => {
        if (err) {
L
longwei 已提交
2248
            hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', err.message);
W
wanghang 已提交
2249
        } else {
L
longwei 已提交
2250
            hilog.info(0x0000, 'testTag', 'getLaunchWantForBundle successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2251 2252 2253
        }
    });
} catch (err) {
2254 2255
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', message);
W
wanghang 已提交
2256 2257 2258 2259 2260 2261 2262
}
```

### bundleManager.getLaunchWantForBundle

getLaunchWantForBundle(bundleName: string, userId?: number): Promise\<Want>;

W
wtt1995 已提交
2263
以异步方法根据给定的bundleName和userId获取用于启动应用程序的Want参数,使用Promise形式返回结果。
W
wanghang 已提交
2264 2265 2266 2267 2268 2269 2270 2271 2272

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

Z
zhaogan 已提交
2273 2274 2275
| 参数名     | 类型   | 必填 | 说明                       |
| ---------- | ------ | ---- | ------------------------- |
| bundleName | string | 是   | 表示应用程序的bundleName。 |
L
Lotol 已提交
2276
| userId     | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。  |
W
wanghang 已提交
2277 2278 2279 2280 2281

**返回值:**

| 类型           | 说明                      |
| -------------- | ------------------------- |
Z
zhaogan 已提交
2282
| Promise\<Want> | Promise对象,返回Want对象。 |
W
wanghang 已提交
2283 2284 2285

**错误码:**

Z
zengyawen 已提交
2286
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2287

J
junyi233 已提交
2288
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2289
| -------- | --------------------------------------|
Z
zhaogan 已提交
2290
| 17700001 | The specified bundleName is not found. |
2291
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
2292
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
2293 2294 2295 2296

**示例:**

```ts
L
Lotol 已提交
2297
import bundleManager from '@ohos.bundle.bundleManager';
2298
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2299
import hilog from '@ohos.hilog';
W
wanghang 已提交
2300 2301 2302 2303 2304
let bundleName = 'com.example.myapplication';
let userId = 100;

try {
    bundleManager.getLaunchWantForBundle(bundleName, userId).then((data) => {
L
longwei 已提交
2305
        hilog.info(0x0000, 'testTag', 'getLaunchWantForBundle successfully. Data: %{public}s', JSON.stringify(data));
2306
    }).catch((err: BusinessError) => {
L
longwei 已提交
2307
        hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2308
    });
2309
} catch (err) {
2310 2311
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed. Cause: %{public}s', message);
W
wanghang 已提交
2312 2313 2314 2315 2316
}
```

### bundleManager.getProfileByAbility

J
junyi233 已提交
2317
getProfileByAbility(moduleName: string, abilityName: string, metadataName: string, callback: AsyncCallback\<Array\<string\>\>): void;
W
wanghang 已提交
2318 2319 2320 2321 2322 2323 2324

以异步方法根据给定的moduleName、abilityName和metadataName获取相应配置文件的json格式字符串,使用callback形式返回结果。

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

**参数:**

J
junyi233 已提交
2325
| 参数名       | 类型                          | 必填 | 说明                                                         |
W
wanghang 已提交
2326
| ------------ | ----------------------------- | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
2327 2328 2329 2330
| moduleName   | string                        | 是   | 表示应用程序的moduleName。                                     |
| abilityName  | string                        | 是   | 表示应用程序的abilityName。                                    |
| metadataName | string                        | 是   | 表示应用程序的metadataName。                                  |
| callback     | AsyncCallback<Array\<string>> | 是   | 回调函数,当获取成功时,err为null,data为获取到的Array\<string>;否则为错误对象。 |
W
wanghang 已提交
2331 2332 2333

**错误码:**

Z
zengyawen 已提交
2334
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2335

J
junyi233 已提交
2336
| 错误码ID | 错误信息                                                     |
W
wanghang 已提交
2337
| -------- | ------------------------------------------------------------ |
L
Lotol 已提交
2338 2339
| 17700002 | The specified moduleName is not existed.                      |
| 17700003 | The specified abilityName is not existed.                     |
2340
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
Z
zhaogan 已提交
2341 2342
| 17700026 | The specified bundle is disabled.                             |
| 17700029 | The specified ability is disabled.                            |
W
wanghang 已提交
2343 2344 2345 2346

**示例:**

```ts
L
Lotol 已提交
2347
import bundleManager from '@ohos.bundle.bundleManager';
2348
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2349
import hilog from '@ohos.hilog';
W
wanghang 已提交
2350
let moduleName = 'entry';
2351
let abilityName = 'EntryAbility';
W
wanghang 已提交
2352 2353 2354 2355 2356
let metadataName = 'com.example.myapplication.metadata';

try {
    bundleManager.getProfileByAbility(moduleName, abilityName, metadataName, (err, data) => {
        if (err) {
L
longwei 已提交
2357
            hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2358
        } else {
L
longwei 已提交
2359
            hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2360 2361 2362
        }
    });
} catch (err) {
2363 2364
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message);
W
wanghang 已提交
2365 2366 2367 2368 2369
}
```

### bundleManager.getProfileByAbility

J
junyi233 已提交
2370
getProfileByAbility(moduleName: string, abilityName: string, metadataName?: string): Promise\<Array\<string\>\>;
W
wanghang 已提交
2371 2372 2373 2374 2375 2376 2377

以异步方法根据给定的moduleName、abilityName和metadataName获取相应配置文件的json格式字符串,使用Promise形式返回结果。

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

**参数:**

J
junyi233 已提交
2378
| 参数名       | 类型   | 必填 | 说明                       |
W
wanghang 已提交
2379
| ------------ | ------ | ---- | -------------------------- |
Z
zhaogan 已提交
2380 2381
| moduleName   | string | 是   | 表示应用程序的moduleName。   |
| abilityName  | string | 是   | 表示应用程序的abilityName。  |
L
Lotol 已提交
2382
| metadataName | string | 否   | 表示应用程序的metadataName,默认值为空。 |
W
wanghang 已提交
2383 2384 2385 2386 2387

**返回值:**

| 类型                    | 说明                            |
| ----------------------- | ------------------------------- |
Z
zhaogan 已提交
2388
| Promise<Array\<string>> | Promise对象,返回Array\<string>。 |
W
wanghang 已提交
2389 2390 2391

**错误码:**

Z
zengyawen 已提交
2392
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2393

J
junyi233 已提交
2394
| 错误码ID | 错误信息                                                     |
W
wanghang 已提交
2395
| -------- | ------------------------------------------------------------ |
L
Lotol 已提交
2396 2397
| 17700002 | The specified moduleName is not existed.                      |
| 17700003 | The specified abilityName is not existed.                     |
2398
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
Z
zhaogan 已提交
2399 2400
| 17700026 | The specified bundle is disabled.                             |
| 17700029 | The specified ability is disabled.                            |
W
wanghang 已提交
2401 2402 2403 2404

**示例:**

```ts
L
Lotol 已提交
2405
import bundleManager from '@ohos.bundle.bundleManager';
2406
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2407
import hilog from '@ohos.hilog';
W
wanghang 已提交
2408
let moduleName = 'entry';
2409
let abilityName = 'EntryAbility';
W
wanghang 已提交
2410 2411 2412

try {
    bundleManager.getProfileByAbility(moduleName, abilityName).then((data) => {
L
longwei 已提交
2413
        hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully. Data: %{public}s', JSON.stringify(data));
2414
    }).catch(err => {
L
longwei 已提交
2415
        hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2416
    });
2417
} catch (err) {
2418 2419
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message);
W
wanghang 已提交
2420
}
Z
zhaogan 已提交
2421
```
W
wanghang 已提交
2422

Z
zhaogan 已提交
2423
```ts
L
Lotol 已提交
2424
import bundleManager from '@ohos.bundle.bundleManager';
2425
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2426
import hilog from '@ohos.hilog';
Z
zhaogan 已提交
2427
let moduleName = 'entry';
2428
let abilityName = 'EntryAbility';
Z
zhaogan 已提交
2429
let metadataName = 'com.example.myapplication.metadata';
W
wanghang 已提交
2430
try {
Z
zhaogan 已提交
2431
    bundleManager.getProfileByAbility(moduleName, abilityName, metadataName).then((data) => {
L
longwei 已提交
2432
        hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully. Data: %{public}s', JSON.stringify(data));
2433
    }).catch((err: BusinessError) => {
L
longwei 已提交
2434
        hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2435
    });
2436
} catch (err) {
2437 2438
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', message);
W
wanghang 已提交
2439 2440 2441 2442 2443
}
```

### bundleManager.getProfileByExtensionAbility

J
junyi233 已提交
2444
getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, metadataName: string, callback: AsyncCallback\<Array\<string\>\>): void;
W
wanghang 已提交
2445 2446 2447 2448 2449 2450 2451

以异步方法根据给定的moduleName、extensionAbilityName和metadataName获取相应配置文件的json格式字符串,使用callback形式返回结果。

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

**参数:**

2452
| 参数名                 | 类型                          | 必填 | 说明                                                         |
W
wanghang 已提交
2453
| -------------------- | ----------------------------- | ---- | ------------------------------------------------------------ |
J
junyi233 已提交
2454 2455 2456
| moduleName           | string                        | 是   | 表示应用程序的moduleName。                                   |
| extensionAbilityName | string                        | 是   | 表示应用程序的extensionAbilityName。                         |
| metadataName         | string                        | 是   | 表示应用程序的metadataName。                                 |
Z
zhaogan 已提交
2457
| callback             | AsyncCallback<Array\<string>> | 是   | 回调函数,当获取成功时,err为null,data为获取到的Array\<string>;否则为错误对象。 |
W
wanghang 已提交
2458 2459 2460

**错误码:**

Z
zengyawen 已提交
2461
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2462

J
junyi233 已提交
2463
| 错误码ID | 错误信息                                                     |
W
wanghang 已提交
2464
| -------- | ------------------------------------------------------------ |
L
Lotol 已提交
2465
| 17700002 | The specified moduleName is not existed.                      |
J
junyi233 已提交
2466
| 17700003 | The specified extensionAbilityName not existed.            |
2467
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
Z
zhaogan 已提交
2468
| 17700026 | The specified bundle is disabled.                             |
W
wanghang 已提交
2469 2470 2471 2472

**示例:**

```ts
L
Lotol 已提交
2473
import bundleManager from '@ohos.bundle.bundleManager';
2474
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2475
import hilog from '@ohos.hilog';
W
wanghang 已提交
2476 2477 2478 2479 2480 2481 2482
let moduleName = 'entry';
let extensionAbilityName = 'com.example.myapplication.extension';
let metadataName = 'com.example.myapplication.metadata';

try {
    bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName, metadataName, (err, data) => {
        if (err) {
L
longwei 已提交
2483
            hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed: %{public}s', err.message);
W
wanghang 已提交
2484
        } else {
L
longwei 已提交
2485
            hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2486 2487 2488
        }
    });
} catch (err) {
2489 2490
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed: %{public}s', message);
W
wanghang 已提交
2491 2492 2493 2494 2495
}
```

### bundleManager.getProfileByExtensionAbility

J
junyi233 已提交
2496
getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, metadataName?: string): Promise\<Array\<string\>\>;
W
wanghang 已提交
2497 2498 2499 2500 2501 2502 2503

以异步方法根据给定的moduleName、extensionAbilityName和metadataName获取相应配置文件的json格式字符串,使用Promise形式返回结果。

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

**参数:**

2504
| 参数名                 | 类型   | 必填 | 说明                               |
J
junyi233 已提交
2505
| -------------------- | ------ | ---- | ---------------------------------- |
Z
zhaogan 已提交
2506 2507
| moduleName           | string | 是   | 表示应用程序的moduleName。           |
| extensionAbilityName | string | 是   | 表示应用程序的extensionAbilityName。 |
L
Lotol 已提交
2508
| metadataName         | string | 否   | 表示应用程序的metadataName,默认值为空。         |
W
wanghang 已提交
2509 2510 2511 2512 2513

**返回值:**

| 类型                    | 说明                                |
| ----------------------- | ----------------------------------- |
Z
zhaogan 已提交
2514
| Promise<Array\<string>> | Promise对象,返回Array\<string>对象。 |
W
wanghang 已提交
2515 2516 2517

**错误码:**

Z
zengyawen 已提交
2518
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2519

J
junyi233 已提交
2520
| 错误码ID | 错误信息                                                     |
W
wanghang 已提交
2521
| -------- | ------------------------------------------------------------ |
L
Lotol 已提交
2522
| 17700002 | The specified moduleName is not existed.                      |
J
junyi233 已提交
2523
| 17700003 | The specified extensionAbilityName not existed.            |
2524
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
Z
zhaogan 已提交
2525
| 17700026 | The specified bundle is disabled.                             |
W
wanghang 已提交
2526 2527 2528 2529

**示例:**

```ts
L
Lotol 已提交
2530
import bundleManager from '@ohos.bundle.bundleManager';
2531
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2532
import hilog from '@ohos.hilog';
W
wanghang 已提交
2533 2534 2535 2536 2537 2538
let moduleName = 'entry';
let extensionAbilityName = 'com.example.myapplication.extension';
let metadataName = 'com.example.myapplication.metadata';

try {
    bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName).then((data) => {
L
longwei 已提交
2539
        hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully. Data: %{public}s', JSON.stringify(data));
2540
    }).catch((err: BusinessError) => {
L
longwei 已提交
2541
        hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2542
    });
2543
} catch (err) {
2544 2545
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', message);
W
wanghang 已提交
2546 2547 2548 2549
}

try {
    bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName, metadataName).then((data) => {
L
longwei 已提交
2550
        hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully. Data: %{public}s', JSON.stringify(data));
2551
    }).catch((err: BusinessError) => {
L
longwei 已提交
2552
        hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2553
    });
2554
} catch (err) {
2555 2556
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', message);
W
wanghang 已提交
2557 2558 2559 2560 2561 2562 2563
}
```

### bundleManager.getPermissionDef

getPermissionDef(permissionName: string, callback: AsyncCallback\<[PermissionDef](js-apis-bundleManager-permissionDef.md)>): void;

W
wtt1995 已提交
2564
以异步方法根据给定的permissionName获取权限定义结构体PermissionDef信息,使用callback形式返回结果。
W
wanghang 已提交
2565 2566 2567 2568 2569 2570 2571 2572 2573

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

2574
| 参数名           | 类型                                                         | 必填 | 说明                                                         |
W
wanghang 已提交
2575
| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
J
junyi233 已提交
2576
| permissionName | string                                                       | 是   | 表示权限名称。                                               |
Z
zhaogan 已提交
2577
| callback       | AsyncCallback\<[PermissionDef](js-apis-bundleManager-permissionDef.md)> | 是   | 回调函数,当获取成功时,err为null,data为获取到的Array\<PermissionDef>;否则为错误对象。 |
W
wanghang 已提交
2578 2579 2580

**错误码:**

Z
zengyawen 已提交
2581
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2582

J
junyi233 已提交
2583 2584
| 错误码ID | 错误信息                              |
| -------- | ------------------------------------- |
Z
zhaogan 已提交
2585
| 17700006 | The specified permission is not found. |
W
wanghang 已提交
2586 2587 2588 2589

**示例:**

```ts
L
Lotol 已提交
2590
import bundleManager from '@ohos.bundle.bundleManager';
2591
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2592
import hilog from '@ohos.hilog';
W
wanghang 已提交
2593 2594 2595 2596
let permission = "ohos.permission.GET_BUNDLE_INFO";
try {
    bundleManager.getPermissionDef(permission, (err, data) => {
        if (err) {
L
longwei 已提交
2597
            hilog.error(0x0000, 'testTag', 'getPermissionDef failed: %{public}s', err.message);
W
wanghang 已提交
2598
        } else {
L
longwei 已提交
2599
            hilog.info(0x0000, 'testTag', 'getPermissionDef successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2600 2601 2602
        }
    });
} catch (err) {
2603 2604
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getPermissionDef failed: %{public}s', message);
W
wanghang 已提交
2605 2606 2607 2608 2609 2610 2611
}
```

### bundleManager.getPermissionDef

getPermissionDef(permissionName: string): Promise\<[PermissionDef](js-apis-bundleManager-permissionDef.md)>;

W
wtt1995 已提交
2612
以异步方法根据给定的permissionName获取权限定义结构体PermissionDef信息,使用Promise形式返回结果。
W
wanghang 已提交
2613 2614 2615 2616 2617 2618 2619 2620 2621

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

2622
| 参数名           | 类型   | 必填 | 说明           |
J
junyi233 已提交
2623
| -------------- | ------ | ---- | -------------- |
Z
zhaogan 已提交
2624
| permissionName | string | 是   | 表示权限参数名。 |
W
wanghang 已提交
2625 2626 2627 2628 2629

**返回值:**

| 类型                                                         | 说明                                       |
| ------------------------------------------------------------ | ------------------------------------------ |
Z
zhaogan 已提交
2630
| Promise\<[PermissionDef](js-apis-bundleManager-permissionDef.md)> | Promise对象,返回Array\<PermissionDef>对象。 |
W
wanghang 已提交
2631 2632 2633

**错误码:**

Z
zengyawen 已提交
2634
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2635

J
junyi233 已提交
2636 2637
| 错误码ID | 错误信息                              |
| -------- | ------------------------------------- |
Z
zhaogan 已提交
2638
| 17700006 | The specified permission is not found. |
W
wanghang 已提交
2639 2640 2641 2642

**示例:**

```ts
L
Lotol 已提交
2643
import bundleManager from '@ohos.bundle.bundleManager';
2644
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2645
import hilog from '@ohos.hilog';
W
wanghang 已提交
2646 2647 2648
let permissionName = "ohos.permission.GET_BUNDLE_INFO";
try {
    bundleManager.getPermissionDef(permissionName).then((data) => {
L
longwei 已提交
2649
        hilog.info(0x0000, 'testTag', 'getPermissionDef successfully. Data: %{public}s', JSON.stringify(data));
2650
    }).catch((err: BusinessError) => {
L
longwei 已提交
2651
        hilog.error(0x0000, 'testTag', 'getPermissionDef failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2652
    });
2653
} catch (err) {
2654 2655
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getPermissionDef failed. Cause: %{public}s', message);
W
wanghang 已提交
2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 2672
}
```

### bundleManager.getAbilityLabel

getAbilityLabel(bundleName: string, moduleName: string, abilityName: string, callback: AsyncCallback\<string>): void;

以异步的方法获取指定bundleName、moduleName和abilityName的label,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

**系统能力:** SystemCapability.BundleManager.BundleFramework.Resource

**参数:**

J
junyi233 已提交
2673
| 参数名      | 类型                   | 必填 | 说明                                                         |
W
wanghang 已提交
2674
| ----------- | ---------------------- | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
2675 2676 2677 2678
| bundleName  | string                 | 是   | 表示应用程序的bundleName。                                     |
| moduleName  | string                 | 是   | 表示应用程序的moduleName。                                     |
| abilityName | string                 | 是   | 表示应用程序的abilityName。                                    |
| callback    | AsyncCallback\<string> | 是   | 回调函数,当获取成功时,err为null,data为获指定组件的Label值;否则为错误对象。 |
W
wanghang 已提交
2679 2680 2681

**错误码:**

Z
zengyawen 已提交
2682
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2683

J
junyi233 已提交
2684 2685
| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
Z
zhaogan 已提交
2686 2687 2688 2689 2690
| 17700001 | The specified bundleName is not found.  |
| 17700002 | The specified moduleName is not found.  |
| 17700003 | The specified abilityName is not found. |
| 17700026 | The specified bundle is disabled.       |
| 17700029 | The specified ability is disabled.      |
W
wanghang 已提交
2691 2692 2693 2694

**示例:**

```ts
L
Lotol 已提交
2695
import bundleManager from '@ohos.bundle.bundleManager';
2696
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2697
import hilog from '@ohos.hilog';
W
wanghang 已提交
2698 2699
let bundleName = 'com.example.myapplication';
let moduleName = 'entry';
2700
let abilityName = 'EntryAbility';
W
wanghang 已提交
2701 2702 2703 2704

try {
    bundleManager.getAbilityLabel(bundleName, moduleName, abilityName, (err, data) => {
        if (err) {
L
longwei 已提交
2705
            hilog.error(0x0000, 'testTag', 'getAbilityLabel failed: %{public}s', err.message);
W
wanghang 已提交
2706
        } else {
L
longwei 已提交
2707
            hilog.info(0x0000, 'testTag', 'getAbilityLabel successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2708 2709 2710
        }
    });
} catch (err) {
2711 2712
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAbilityLabel failed: %{public}s', message);
W
wanghang 已提交
2713 2714 2715 2716 2717 2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729
}
```

### bundleManager.getAbilityLabel

getAbilityLabel(bundleName: string, moduleName: string, abilityName: string): Promise\<string>;

以异步的方法获取指定bundleName、moduleName和abilityName的label,使用Promise形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

**系统能力:** SystemCapability.BundleManager.BundleFramework.Resource

**参数:**

J
junyi233 已提交
2730
| 参数名      | 类型   | 必填 | 说明                      |
W
wanghang 已提交
2731
| ----------- | ------ | ---- | ------------------------- |
Z
zhaogan 已提交
2732 2733 2734
| bundleName  | string | 是   | 表示应用程序的bundleName。  |
| moduleName  | string | 是   | 表示应用程序的moduleName。  |
| abilityName | string | 是   | 表示应用程序的abilityName。 |
W
wanghang 已提交
2735 2736 2737 2738 2739

**返回值:**

| 类型             | 说明                                |
| ---------------- | ----------------------------------- |
Z
zhaogan 已提交
2740
| Promise\<string> | Promise对象,返回指定组件的Lablel值。 |
W
wanghang 已提交
2741 2742 2743

**错误码:**

Z
zengyawen 已提交
2744
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2745

J
junyi233 已提交
2746
| 错误码ID | 错误信息                              |
W
wanghang 已提交
2747
| -------- | --------------------------------------- |
Z
zhaogan 已提交
2748 2749 2750 2751 2752
| 17700001 | The specified bundleName is not found.  |
| 17700002 | The specified moduleName is not found.  |
| 17700003 | The specified abilityName is not found. |
| 17700026 | The specified bundle is disabled.       |
| 17700029 | The specified ability is disabled.      |
W
wanghang 已提交
2753 2754 2755 2756

**示例:**

```ts
L
Lotol 已提交
2757
import bundleManager from '@ohos.bundle.bundleManager';
2758
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2759
import hilog from '@ohos.hilog';
W
wanghang 已提交
2760 2761
let bundleName = 'com.example.myapplication';
let moduleName = 'entry';
2762
let abilityName = 'EntryAbility';
W
wanghang 已提交
2763 2764 2765

try {
    bundleManager.getAbilityLabel(bundleName, moduleName, abilityName).then((data) => {
L
longwei 已提交
2766
        hilog.info(0x0000, 'testTag', 'getAbilityLabel successfully. Data: %{public}s', JSON.stringify(data));
2767
    }).catch((err: BusinessError) => {
L
longwei 已提交
2768
        hilog.error(0x0000, 'testTag', 'getAbilityLabel failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2769
    });
2770
} catch (err) {
2771 2772
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAbilityLabel failed. Cause: %{public}s', message);
W
wanghang 已提交
2773 2774 2775 2776 2777 2778 2779 2780
}
```


### bundleManager.getApplicationInfoSync

getApplicationInfoSync(bundleName: string, applicationFlags: number, userId: number) : [ApplicationInfo](js-apis-bundleManager-applicationInfo.md);

W
wtt1995 已提交
2781
以同步方法根据给定的bundleName、applicationFlags和userId获取ApplicationInfo。
W
wanghang 已提交
2782 2783 2784 2785 2786

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

W
wtt1995 已提交
2787
**系统能力:** SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
2788 2789 2790

**参数:**

J
junyi233 已提交
2791
| 参数名       | 类型   | 必填 | 说明                                                       |
W
wanghang 已提交
2792
| ----------- | ------ | ---- | ----------------------------------------------------------|
Z
zhaogan 已提交
2793 2794
| bundleName  | string | 是   | 表示应用程序的bundleName。                                  |
| applicationFlags | [number](#applicationflag) | 是   | 表示用于指定将返回的ApplicationInfo对象中包含的信息。       |
L
Lotol 已提交
2795
| userId      | number | 是   | 表示用户ID。                                         |
W
wanghang 已提交
2796 2797 2798 2799 2800

**返回值:**

| 类型            | 说明                      |
| --------------- | ------------------------- |
Z
zhaogan 已提交
2801
| [ApplicationInfo](js-apis-bundleManager-applicationInfo.md) | 返回ApplicationInfo对象。 |
W
wanghang 已提交
2802 2803 2804

**错误码:**

Z
zengyawen 已提交
2805
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2806

J
junyi233 已提交
2807
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2808
| -------- | -------------------------------------- |
Z
zhaogan 已提交
2809
| 17700001 | The specified bundleName is not found. |
J
junyi233 已提交
2810
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
2811
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
2812 2813 2814 2815

**示例:**

```ts
L
Lotol 已提交
2816
import bundleManager from '@ohos.bundle.bundleManager';
2817
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2818
import hilog from '@ohos.hilog';
W
wanghang 已提交
2819 2820 2821 2822 2823 2824
let bundleName = 'com.example.myapplication';
let applicationFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;
let userId = 100;

try {
    let data = bundleManager.getApplicationInfoSync(bundleName, applicationFlags, userId);
L
longwei 已提交
2825
    hilog.info(0x0000, 'testTag', 'getApplicationInfoSync successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2826
} catch (err) {
2827 2828
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getApplicationInfoSync failed: %{public}s', message);
W
wanghang 已提交
2829 2830 2831
}
```

J
junyi233 已提交
2832 2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 2861 2862 2863 2864 2865 2866 2867
### bundleManager.getApplicationInfoSync

getApplicationInfoSync(bundleName: string, applicationFlags: number) : [ApplicationInfo](js-apis-bundleManager-applicationInfo.md);

以同步方法根据给定的bundleName、applicationFlags获取ApplicationInfo。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

| 参数名           | 类型                       | 必填 | 说明                                                  |
| ---------------- | -------------------------- | ---- | ----------------------------------------------------- |
| bundleName       | string                     | 是   | 表示应用程序的bundleName。                            |
| applicationFlags | [number](#applicationflag) | 是   | 表示用于指定将返回的ApplicationInfo对象中包含的信息。 |

**返回值:**

| 类型                                                        | 说明                      |
| ----------------------------------------------------------- | ------------------------- |
| [ApplicationInfo](js-apis-bundleManager-applicationInfo.md) | 返回ApplicationInfo对象。 |

**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found. |
| 17700026 | The specified bundle is disabled.      |

**示例:**

W
wanghang 已提交
2868
```ts
L
Lotol 已提交
2869
import bundleManager from '@ohos.bundle.bundleManager';
2870
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2871
import hilog from '@ohos.hilog';
W
wanghang 已提交
2872 2873 2874 2875 2876
let bundleName = 'com.example.myapplication';
let applicationFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;

try {
    let data = bundleManager.getApplicationInfoSync(bundleName, applicationFlags);
L
longwei 已提交
2877
    hilog.info(0x0000, 'testTag', 'getApplicationInfoSync successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2878
} catch (err) {
2879 2880
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getApplicationInfoSync failed: %{public}s', message);
W
wanghang 已提交
2881 2882 2883 2884 2885 2886 2887 2888 2889 2890 2891 2892 2893 2894 2895 2896 2897
}
```

### bundleManager.getBundleInfoSync

getBundleInfoSync(bundleName: string, bundleFlags: [number](#bundleflag), userId: number): [BundleInfo](js-apis-bundleManager-bundleInfo.md);

以同步方法根据给定的bundleName、bundleFlags和userId获取BundleInfo。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

J
junyi233 已提交
2898
| 参数名       | 类型   | 必填 | 说明                                                     |
W
wanghang 已提交
2899
| ----------- | ------ | ---- | -------------------------------------------------------- |
Z
zhaogan 已提交
2900 2901
| bundleName  | string | 是   | 表示应用程序的bundleName。                                 |
| bundleFlags | [number](#bundleflag) | 是   | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 |
J
junyi233 已提交
2902
| userId      | number | 是   | 表示用户ID。                                             |
W
wanghang 已提交
2903 2904 2905 2906 2907

**返回值:**

| 类型       | 说明                 |
| ---------- | -------------------- |
Z
zhaogan 已提交
2908
| [BundleInfo](js-apis-bundleManager-bundleInfo.md) | 返回BundleInfo对象。 |
W
wanghang 已提交
2909 2910 2911

**错误码:**

Z
zengyawen 已提交
2912
以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)
W
wanghang 已提交
2913

J
junyi233 已提交
2914
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2915
| -------- | ------------------------------------- |
Z
zhaogan 已提交
2916
| 17700001 | The specified bundleName is not found. |
2917
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
2918
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
2919 2920 2921 2922

**示例:**

```ts
L
Lotol 已提交
2923
import bundleManager from '@ohos.bundle.bundleManager';
2924
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2925
import hilog from '@ohos.hilog';
W
wanghang 已提交
2926 2927 2928 2929 2930 2931
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);
L
longwei 已提交
2932
    hilog.info(0x0000, 'testTag', 'getBundleInfoSync successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2933
} catch (err) {
2934 2935
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfoSync failed: %{public}s', message);
W
wanghang 已提交
2936 2937 2938
}
```

J
junyi233 已提交
2939 2940 2941 2942 2943 2944 2945 2946 2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 2957 2958 2959 2960 2961 2962 2963 2964 2965 2966 2967 2968 2969 2970 2971 2972 2973 2974
### bundleManager.getBundleInfoSync

getBundleInfoSync(bundleName: string, bundleFlags: [number](#bundleflag)): [BundleInfo](js-apis-bundleManager-bundleInfo.md);

以同步方法根据给定的bundleName、bundleFlags获取BundleInfo。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED or ohos.permission.GET_BUNDLE_INFO

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

**参数:**

| 参数名      | 类型                  | 必填 | 说明                                                   |
| ----------- | --------------------- | ---- | ------------------------------------------------------ |
| bundleName  | string                | 是   | 表示应用程序的bundleName。                             |
| bundleFlags | [number](#bundleflag) | 是   | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 |

**返回值:**

| 类型                                              | 说明                 |
| ------------------------------------------------- | -------------------- |
| [BundleInfo](js-apis-bundleManager-bundleInfo.md) | 返回BundleInfo对象。 |

**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found. |
| 17700026 | The specified bundle is disabled.      |

**示例:**

W
wanghang 已提交
2975
```ts
L
Lotol 已提交
2976
import bundleManager from '@ohos.bundle.bundleManager';
2977
import { BusinessError } from '@ohos.base';
G
geng-wenguang 已提交
2978
import hilog from '@ohos.hilog';
W
wanghang 已提交
2979 2980 2981
let bundleName = 'com.example.myapplication';
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION;
try {
Z
zhaogan 已提交
2982
    let data = bundleManager.getBundleInfoSync(bundleName, bundleFlags);
L
longwei 已提交
2983
    hilog.info(0x0000, 'testTag', 'getBundleInfoSync successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2984
} catch (err) {
2985 2986
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfoSync failed: %{public}s', message);
W
wanghang 已提交
2987
}
Z
zhongjianfei 已提交
2988
```
J
junyi233 已提交
2989

2990 2991 2992 2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007
### bundleManager.getSharedBundleInfo<sup>10+</sup>

getSharedBundleInfo(bundleName: string,  moduleName: string, callback: AsyncCallback\<Array\<SharedBundleInfo\>\>): void;

以异步的方法获取指定的共享包信息,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

| 参数名     | 类型                                                         | 必填 | 说明                                                         |
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| bundleName | string                                                       | 是   | 表示应用程序的bundleName。                                   |
| moduleName | string                                                       | 是   | 表示被查询的module的name。                                   |
3008
| callback   | AsyncCallback\<Array\<[SharedBundleInfo](js-apis-bundleManager-sharedBundleInfo.md)\>\> | 是   | 回调函数,当获取成功时,err为null,data为获取的指定共享包信息。 |
3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022

**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found. |
| 17700002 | The specified moduleName is not found. |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3023
import { BusinessError } from '@ohos.base';
3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036
import hilog from '@ohos.hilog';
let bundleName = 'com.example.myapplication';
let moduleName = 'library';

try {
    bundleManager.getSharedBundleInfo(bundleName, moduleName, (err, data) => {
        if (err) {
            hilog.error(0x0000, 'testTag', 'getSharedBundleInfo failed: %{public}s', err.message);
        } else {
            hilog.info(0x0000, 'testTag', 'getSharedBundleInfo successfully: %{public}s', JSON.stringify(data));
        }
    });
} catch (err) {
3037 3038
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getSharedBundleInfo failed: %{public}s', message);
3039 3040 3041 3042 3043
}
```

### bundleManager.getSharedBundleInfo<sup>10+</sup>

X
fix doc  
xsz233 已提交
3044
getSharedBundleInfo(bundleName: string, moduleName: string): Promise\<Array\<SharedBundleInfo\>\>;
3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064

以异步的方法获取指定的共享包信息,使用Promise形式返回结果。

**系统接口:** 此接口为系统接口

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

| 参数名     | 类型   | 必填 | 说明                       |
| ---------- | ------ | ---- | -------------------------- |
| bundleName | string | 是   | 表示应用程序的bundleName。 |
| moduleName | string | 是   | 表示被查询的module的name。 |

**返回值:**

| 类型                                                         | 说明                                |
| ------------------------------------------------------------ | ----------------------------------- |
3065
| Promise\<Array\<[SharedBundleInfo](js-apis-bundleManager-sharedBundleInfo.md)\>\> | Promise对象,返回指定的共享包信息。 |
3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079

**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found. |
| 17700002 | The specified moduleName is not found. |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3080
import { BusinessError } from '@ohos.base';
3081 3082 3083 3084 3085 3086 3087
import hilog from '@ohos.hilog';
let bundleName = 'com.example.myapplication';
let moduleName = 'library';

try {
    bundleManager.getSharedBundleInfo(bundleName, moduleName).then((data) => {
        hilog.info(0x0000, 'testTag', 'getSharedBundleInfo successfully. Data: %{public}s', JSON.stringify(data));
3088
    }).catch((err: BusinessError) => {
3089 3090 3091
        hilog.error(0x0000, 'testTag', 'getSharedBundleInfo failed. Cause: %{public}s', err.message);
    });
} catch (err) {
3092 3093
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getSharedBundleInfo failed. Cause: %{public}s', message);
3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118
}
```

### bundleManager.getAllSharedBundleInfo<sup>10+</sup>

getAllSharedBundleInfo(callback: AsyncCallback\<Array\<SharedBundleInfo\>\>): void;

以异步的方法获取所有的共享包信息,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

| 参数名   | 类型                                                         | 必填 | 说明                                                         |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| callback | AsyncCallback\<Array\<[SharedBundleInfo](js-apis-bundleManager-sharedBundleInfo.md)\>\> | 是   | 回调函数,当获取成功时,err为null,data为获所有的共享包信息。 |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3119
import { BusinessError } from '@ohos.base';
3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130
import hilog from '@ohos.hilog';

try {
    bundleManager.getAllSharedBundleInfo((err, data) => {
        if (err) {
            hilog.error(0x0000, 'testTag', 'getAllSharedBundleInfo failed: %{public}s', err.message);
        } else {
            hilog.info(0x0000, 'testTag', 'getAllSharedBundleInfo successfully: %{public}s', JSON.stringify(data));
        }
    });
} catch (err) {
3131 3132
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAllSharedBundleInfo failed: %{public}s', message);
3133 3134 3135 3136 3137
}
```

### bundleManager.getAllSharedBundleInfo<sup>10+</sup>

X
fix doc  
xsz233 已提交
3138
getAllSharedBundleInfo(): Promise\<Array\<SharedBundleInfo\>\>;
3139 3140 3141 3142 3143 3144 3145 3146 3147 3148 3149 3150 3151 3152 3153 3154 3155 3156 3157

以异步的方法获取所有的共享包信息,使用Promise形式返回结果。

**系统接口:** 此接口为系统接口

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**返回值:**

| 类型                                                         | 说明                                |
| ------------------------------------------------------------ | ----------------------------------- |
| Promise\<Array\<[SharedBundleInfo](js-apis-bundleManager-sharedBundleInfo.md)\>\> | Promise对象,返回所有的共享包信息。 |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3158
import { BusinessError } from '@ohos.base';
3159 3160 3161 3162 3163 3164 3165 3166 3167
import hilog from '@ohos.hilog';

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

W
wangtiantian 已提交
3173 3174
### bundleManager.getAppProvisionInfo<sup>10+</sup>

W
wangtiantian 已提交
3175
getAppProvisionInfo(bundleName: string, callback: AsyncCallback\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\>): void;
W
wangtiantian 已提交
3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188

以异步的方法获取指定bundleName的provision配置文件信息,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

| 参数名   | 类型                                                         | 必填 | 说明                                                         |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
W
wangtiantian 已提交
3189
| bundleName | string | 是   | 指定应用的bundleName。 |
W
wangtiantian 已提交
3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203
| callback | AsyncCallback\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\> | 是   | 回调函数,当获取成功时,err为null,data为指定bundleName的provision配置文件信息。 |

**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found. |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3204
import { BusinessError } from '@ohos.base';
W
wangtiantian 已提交
3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216
import hilog from '@ohos.hilog';
let bundleName = "com.ohos.myapplication";

try {
    bundleManager.getAppProvisionInfo(bundleName, (err, data) => {
        if (err) {
            hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', err.message);
        } else {
            hilog.info(0x0000, 'testTag', 'getAppProvisionInfo successfully: %{public}s', JSON.stringify(data));
        }
    });
} catch (err) {
3217 3218
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', message);
W
wangtiantian 已提交
3219 3220 3221 3222 3223
}
```

### bundleManager.getAppProvisionInfo<sup>10+</sup>

W
wangtiantian 已提交
3224
getAppProvisionInfo(bundleName: string, userId: number, callback: AsyncCallback\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\>): void;
W
wangtiantian 已提交
3225 3226 3227 3228 3229 3230 3231 3232 3233 3234 3235 3236 3237

以异步的方法获取指定bundleName和userId的provision配置文件信息,使用callback形式返回结果。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

| 参数名   | 类型                                                         | 必填 | 说明                                                         |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
W
wangtiantian 已提交
3238 3239
| bundleName | string | 是   | 指定应用的bundleName。 |
| userId | number | 是 | 指定用户ID, 可以通过接口[getOsAccountLocalId](js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 |
W
wangtiantian 已提交
3240 3241 3242 3243 3244 3245 3246 3247 3248 3249 3250 3251 3252 3253 3254 3255
| callback | AsyncCallback\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\> | 是   | 回调函数,当获取成功时,err为null,data为指定bundleName的provision配置文件信息。 |


**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found. |
| 17700004 | The specified user ID is not found. |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3256
import { BusinessError } from '@ohos.base';
W
wangtiantian 已提交
3257 3258 3259 3260 3261 3262 3263 3264 3265 3266 3267 3268 3269
import hilog from '@ohos.hilog';
let bundleName = "com.ohos.myapplication";
let userId = 100;

try {
    bundleManager.getAppProvisionInfo(bundleName, userId, (err, data) => {
        if (err) {
            hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', err.message);
        } else {
            hilog.info(0x0000, 'testTag', 'getAppProvisionInfo successfully: %{public}s', JSON.stringify(data));
        }
    });
} catch (err) {
3270 3271
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', message);
W
wangtiantian 已提交
3272 3273 3274 3275 3276
}
```

### bundleManager.getAppProvisionInfo<sup>10+</sup>

W
wangtiantian 已提交
3277
getAppProvisionInfo(bundleName: string, userId?: number): Promise\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\>;
W
wangtiantian 已提交
3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290

以异步的方法根据bundleName和userId获取应用的provision配置文件信息,使用Promise形式返回结果。

**系统接口:** 此接口为系统接口

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

| 参数名   | 类型         | 必填 | 说明          |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
W
wangtiantian 已提交
3291
| bundleName | string | 是 | 指定的bundleName。 |
L
Lotol 已提交
3292
| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0,可以通过接口[getOsAccountLocalId](js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 |
W
wangtiantian 已提交
3293 3294 3295 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312 3313


**返回值:**

| 类型                                                         | 说明                                |
| ------------------------------------------------------------ | ----------------------------------- |
| Promise\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\> | Promise对象,返回应用的provision配置文件信息。 |

**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
| 17700001 | The specified bundleName is not found. |
| 17700004 | The specified user ID is not found. |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3314
import { BusinessError } from '@ohos.base';
W
wangtiantian 已提交
3315 3316 3317 3318 3319 3320 3321
import hilog from '@ohos.hilog';
let bundleName = "com.ohos.myapplication";
let userId = 100;

try {
    bundleManager.getAppProvisionInfo(bundleName).then((data) => {
        hilog.info(0x0000, 'testTag', 'getAppProvisionInfo successfully. Data: %{public}s', JSON.stringify(data));
3322
    }).catch((err: BusinessError) => {
W
wangtiantian 已提交
3323 3324 3325
        hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed. Cause: %{public}s', err.message);
    });
} catch (err) {
3326 3327
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed. Cause: %{public}s', message);
W
wangtiantian 已提交
3328 3329 3330 3331 3332
}

try {
    bundleManager.getAppProvisionInfo(bundleName, userId).then((data) => {
        hilog.info(0x0000, 'testTag', 'getAppProvisionInfo successfully. Data: %{public}s', JSON.stringify(data));
3333
    }).catch((err: BusinessError) => {
W
wangtiantian 已提交
3334 3335 3336
        hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed. Cause: %{public}s', err.message);
    });
} catch (err) {
3337 3338
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed. Cause: %{public}s', message);
W
wangtiantian 已提交
3339 3340
}
```
W
wangtiantian 已提交
3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375

### bundleManager.getSpecifiedDistributionType<sup>10+</sup>
getSpecifiedDistributionType(bundleName: string): string;

以同步的方法查询指定bundleName的分发类型,该返回值是在调用install接口时传入的[InstallParam](./js-apis-installer.md#installparam)中的specifiedDistributionType字段。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

| 参数名         | 类型                                | 必填 | 说明                         |
| -------------- | ----------------------------------- | ---- | ---------------------------- |
| bundleName | string | 是   | 指定的bundleName。 |

**返回值:**

| 类型          | 说明                                   |
| ------------- | -------------------------------------- |
| string | 返回指定bundleName的分发类型。 |

**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                                                     |
| -------- | ------------------------------------------------------------ |
| 17700001 | The specified bundleName is not found. |

**示例:**
```ts
import bundleManager from '@ohos.bundle.bundleManager';
3376
import { BusinessError } from '@ohos.base';
W
wangtiantian 已提交
3377 3378 3379 3380 3381 3382
let bundleName = "com.example.myapplication";

try {
    let type = bundleManager.getSpecifiedDistributionType(bundleName);
    console.info('getSpecifiedDistributionType successfully, type:' + type);
} catch (error) {
3383 3384
    let message = (error as BusinessError).message;
    console.error('getSpecifiedDistributionType failed. Cause: ' + message);
W
wangtiantian 已提交
3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405 3406 3407 3408 3409 3410 3411 3412 3413 3414 3415 3416 3417 3418 3419 3420 3421 3422 3423 3424
}
```


### bundleManager.getAdditionalInfo<sup>10+</sup>

getAdditionalInfo(bundleName: string): string;

以同步接口查询指定bundleName的额外信息。该返回值是在调用install接口时传入的[InstallParam](./js-apis-installer.md#installparam)中的additionalInfo字段。

**系统接口:** 此接口为系统接口。

**需要权限:** ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

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

**参数:**

| 参数名         | 类型                                | 必填 | 说明                         |
| -------------- | ----------------------------------- | ---- | ---------------------------- |
| bundleName | string | 是   | 指定的bundleName。 |

**返回值:**

| 类型          | 说明                                   |
| ------------- | -------------------------------------- |
| string | 返回指定bundleName的额外信息。 |

**错误码:**

以下错误码的详细介绍请参见[ohos.bundle错误码](../errorcodes/errorcode-bundle.md)

| 错误码ID | 错误信息                                                     |
| -------- | ------------------------------------------------------------ |
| 17700001 | The specified bundleName is not found. |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3425
import { BusinessError } from '@ohos.base';
W
wangtiantian 已提交
3426 3427 3428 3429 3430 3431
let bundleName = "com.example.myapplication";

try {
    let info = bundleManager.getAdditionalInfo(bundleName);
    console.info('getAdditionalInfo successfully, additionInfo:' + info);
} catch (error) {
3432 3433
    let message = (error as BusinessError).message;
    console.error('getAdditionalInfo failed. Cause: ' + message);
W
wangtiantian 已提交
3434
}
H
Handsome_Afraican_Man 已提交
3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459 3460
```

### bundleManager.getBundleInfoForSelfSync<sup>10+</sup>

getBundleInfoForSelfSync(bundleFlags: number): BundleInfo;

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

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

**参数:**

| 参数名     | 类型   | 必填 | 说明                |
| ----------- | ------ | ---- | --------------------- |
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。 |

**返回值:**

| 类型                                              | 说明                 |
| ------------------------------------------------- | -------------------- |
| [BundleInfo](js-apis-bundleManager-bundleInfo.md) | 返回BundleInfo对象。 |

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
3461
import { BusinessError } from '@ohos.base';
H
Handsome_Afraican_Man 已提交
3462 3463 3464 3465 3466 3467
import hilog from '@ohos.hilog';
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) {
3468 3469
    let message = (err as BusinessError).message;
    hilog.error(0x0000, 'testTag', 'getBundleInfoForSelfSync failed: %{public}s', message);
H
Handsome_Afraican_Man 已提交
3470
}
W
wangtiantian 已提交
3471
```