js-apis-bundleManager.md 149.8 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
| PUSH<sup>10+</sup> | 17 | PushExtensionAbility:推送扩展能力,提供推送场景化消息能力。预留能力,当前暂未支持。 |
S
SoftSquirrel 已提交
117
| DRIVER<sup>10+</sup> | 18 | DriverExtensionAbility:驱动扩展能力,提供外设驱动扩展能力,当前暂未支持。 |
Z
zhongjianfei 已提交
118
| UNSPECIFIED      | 255 | 不指定类型,配合queryExtensionAbilityInfo接口可以查询所有类型的ExtensionAbility。 |
W
wanghang 已提交
119 120 121 122


### PermissionGrantState

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

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

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

### SupportWindowMode

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

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

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

### LaunchType

Z
zhaogan 已提交
146 147
指示组件的启动方式。

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

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

### AbilityType

Z
zhaogan 已提交
158 159
指示Ability组件的类型。

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

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

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

### DisplayOrientation

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

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

J
junyi233 已提交
176 177
| 名称                               |值 |说明 |
|:----------------------------------|---|---|
Z
zhaogan 已提交
178 179 180 181 182 183 184 185 186 187 188 189 190
| 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 已提交
191

X
xsz233 已提交
192
### CompatiblePolicy<sup>10+</sup>
Z
zhaogan 已提交
193 194 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

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

 **系统能力:** 以下各项对应的系统能力均为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 已提交
225
## 接口
W
wanghang 已提交
226 227 228 229 230 231 232 233 234 235 236

### bundleManager.getBundleInfoForSelf

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

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

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

**参数:**

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

**返回值:**

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

Z
zhaogan 已提交
247 248
**示例:**

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

### bundleManager.getBundleInfoForSelf

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

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

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

**参数:**

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

**示例:**

```ts
L
Lotol 已提交
282
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
283
import hilog from '@ohos.hilog';
W
wanghang 已提交
284 285 286 287 288
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getBundleInfoForSelf(bundleFlags, (err, data) => {
        if (err) {
289
            hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', err.message);
W
wanghang 已提交
290
        } else {
G
geng-wenguang 已提交
291
            hilog.info(0x0000, 'testTag', 'getBundleInfoForSelf successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
292 293 294
        }
    });
} catch (err) {
295
    hilog.error(0x0000, 'testTag', 'getBundleInfoForSelf failed: %{public}s', err.message);
W
wanghang 已提交
296 297 298 299 300 301 302 303 304
}
```

### bundleManager.getBundleInfo

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

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

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

W
wanghang 已提交
307 308 309 310 311 312 313 314
**系统接口:** 此接口为系统接口。

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
326
| 错误码ID | 错误信息                              |
W
wanghang 已提交
327
| -------- | ------------------------------------- |
Z
zhaogan 已提交
328
| 17700001 | The specified bundleName is not found. |
329
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
330
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
331 332 333 334

**示例:**

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

Z
zhaogan 已提交
355
```ts
J
junyi233 已提交
356
// 额外获取ApplicationInfo中的metadata
L
Lotol 已提交
357
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
358
import hilog from '@ohos.hilog';
J
junyi233 已提交
359 360
let bundleName = 'com.example.myapplication';
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA;
W
wanghang 已提交
361 362 363 364 365
let userId = 100;

try {
    bundleManager.getBundleInfo(bundleName, bundleFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
366
            hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
367
        } else {
L
longwei 已提交
368
            hilog.info(0x0000, 'testTag', 'getBundleInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
369 370 371
        }
    });
} catch (err) {
L
longwei 已提交
372
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
373 374 375 376 377 378 379 380 381
}
```

### bundleManager.getBundleInfo

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

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

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

W
wanghang 已提交
384 385 386 387 388 389 390 391
**系统接口:** 此接口为系统接口。

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
402
| 错误码ID | 错误信息                              |
W
wanghang 已提交
403
| -------- | ------------------------------------- |
Z
zhaogan 已提交
404 405
| 17700001 | The specified bundleName is not found. |
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
406 407 408 409

**示例:**

```ts
J
junyi233 已提交
410
// 额外获取extensionAbility
L
Lotol 已提交
411
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
412
import hilog from '@ohos.hilog';
W
wanghang 已提交
413
let bundleName = 'com.example.myapplication';
J
junyi233 已提交
414
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_HAP_MODULE | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY;
W
wanghang 已提交
415 416 417 418

try {
    bundleManager.getBundleInfo(bundleName, bundleFlags, (err, data) => {
        if (err) {
L
longwei 已提交
419
            hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
420
        } else {
L
longwei 已提交
421
            hilog.info(0x0000, 'testTag', 'getBundleInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
422 423 424
        }
    });
} catch (err) {
L
longwei 已提交
425
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
426 427 428 429 430 431 432 433 434
}
```

### 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 已提交
435 436
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
437 438 439 440 441 442 443 444
**系统接口:** 此接口为系统接口。

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

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

**参数:**

J
junyi233 已提交
445
| 参数名     | 类型   | 必填 | 说明                       |
W
wanghang 已提交
446
| ----------- | ------ | ---- | ---------------------------- |
447
| bundleName  | string | 是   | 表示要查询的应用Bundle名称。 |
Z
zhaogan 已提交
448
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。       |
L
Lotol 已提交
449
| userId      | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。  |
W
wanghang 已提交
450 451 452 453 454

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
461
| 错误码ID | 错误信息                            |
W
wanghang 已提交
462
| -------- | --------------------------------------|
Z
zhaogan 已提交
463
| 17700001 | The specified bundleName is not found. |
464
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
465
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
466 467 468 469

**示例:**

```ts
J
junyi233 已提交
470
// 额外获取ApplicationInfo和SignatureInfo
L
Lotol 已提交
471
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
472
import hilog from '@ohos.hilog';
W
wanghang 已提交
473
let bundleName = 'com.example.myapplication';
J
junyi233 已提交
474
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_SIGNATURE_INFO;
W
wanghang 已提交
475 476 477 478
let userId = 100;

try {
    bundleManager.getBundleInfo(bundleName, bundleFlags, userId).then((data) => {
L
longwei 已提交
479
        hilog.info(0x0000, 'testTag', 'getBundleInfo successfully. Data: %{public}s', JSON.stringify(data));
480
    }).catch(err => {
L
longwei 已提交
481
        hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
482
    });
483
} catch (err) {
L
longwei 已提交
484
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
485 486 487 488
}
```

```ts
L
Lotol 已提交
489
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
490
import hilog from '@ohos.hilog';
W
wanghang 已提交
491 492 493 494 495
let bundleName = 'com.example.myapplication';
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getBundleInfo(bundleName, bundleFlags).then((data) => {
L
longwei 已提交
496
        hilog.info(0x0000, 'testTag', 'getBundleInfo successfully. Data: %{public}s', JSON.stringify(data));
497
    }).catch(err => {
L
longwei 已提交
498
        hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
499
    });
500
} catch (err) {
L
longwei 已提交
501
    hilog.error(0x0000, 'testTag', 'getBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
502 503 504 505 506 507 508 509 510 511
}

```

### 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 已提交
512 513
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
514 515 516 517 518 519 520 521
**系统接口:** 此接口为系统接口。

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
533
| 错误码ID | 错误信息                             |
W
wanghang 已提交
534
| -------- | --------------------------------------|
Z
zhaogan 已提交
535
| 17700001 | The specified bundleName is not found. |
536
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
537
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
538

Z
zhaogan 已提交
539
**示例:**
W
wanghang 已提交
540 541

```ts
L
Lotol 已提交
542
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
543
import hilog from '@ohos.hilog';
W
wanghang 已提交
544 545 546 547 548 549 550
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 已提交
551
            hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
552
        } else {
L
longwei 已提交
553
            hilog.info(0x0000, 'testTag', 'getApplicationInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
554 555 556
        }
    });
} catch (err) {
L
longwei 已提交
557
    hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
558 559 560 561 562 563 564 565 566
}
```

### bundleManager.getApplicationInfo

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

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

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

W
wanghang 已提交
569 570 571 572 573 574 575 576
**系统接口:** 此接口为系统接口。

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
587
| 错误码ID | 错误信息                             |
W
wanghang 已提交
588
| -------- | --------------------------------------|
Z
zhaogan 已提交
589 590
| 17700001 | The specified bundleName is not found. |
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
591 592 593 594

**示例:**

```ts
L
Lotol 已提交
595
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
596
import hilog from '@ohos.hilog';
W
wanghang 已提交
597
let bundleName = 'com.example.myapplication';
Z
zhaogan 已提交
598
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
W
wanghang 已提交
599 600 601 602

try {
    bundleManager.getApplicationInfo(bundleName, appFlags, (err, data) => {
        if (err) {
L
longwei 已提交
603
            hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
604
        } else {
L
longwei 已提交
605
            hilog.info(0x0000, 'testTag', 'getApplicationInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
606 607 608
        }
    });
} catch (err) {
L
longwei 已提交
609
    hilog.error(0x0000, 'testTag', 'getApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
610 611 612 613 614 615 616 617 618
}
```

### 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 已提交
619 620
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
621 622 623 624 625 626 627 628
**系统接口:** 此接口为系统接口。

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

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

**参数:**

J
junyi233 已提交
629
| 参数名    | 类型   | 必填 | 说明                       |
W
wanghang 已提交
630
| ---------- | ------ | ---- | ---------------------------- |
631
| bundleName | string | 是   | 表示要查询的应用Bundle名称。 |
Z
zhaogan 已提交
632
| appFlags   | [number](#applicationflag) | 是   | 指定返回的ApplicationInfo所包含的信息。    |
L
Lotol 已提交
633
| userId     | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。 |
W
wanghang 已提交
634 635 636 637 638

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
645
| 错误码ID | 错误信息                             |
W
wanghang 已提交
646
| -------- | ------------------------------------- |
Z
zhaogan 已提交
647
| 17700001 | The specified bundleName is not found. |
648
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
649
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
650 651 652 653

**示例:**

```ts
L
Lotol 已提交
654
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
655
import hilog from '@ohos.hilog';
W
wanghang 已提交
656 657 658 659 660 661
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 已提交
662
        hilog.info(0x0000, 'testTag', 'getApplicationInfo successfully. Data: %{public}s', JSON.stringify(data));
663
    }).catch(err => {
L
longwei 已提交
664
        hilog.error(0x0000, 'testTag', 'getApplicationInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
665
    });
666
} catch (err) {
L
longwei 已提交
667
    hilog.error(0x0000, 'testTag', 'getApplicationInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
668 669 670 671 672 673 674
}
```

### bundleManager.getAllBundleInfo

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

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

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

W
wangtiantian 已提交
679
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
680 681 682 683 684

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
695
| 错误码ID | 错误信息                         |
W
wanghang 已提交
696
| -------- | --------------------------------- |
697
| 17700004 | The specified user ID is not found. |
W
wanghang 已提交
698 699 700 701

**示例:**

```ts
L
Lotol 已提交
702
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
703
import hilog from '@ohos.hilog';
W
wanghang 已提交
704 705 706 707 708 709
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION;
let userId = 100;

try {
    bundleManager.getAllBundleInfo(bundleFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
710
            hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
711
        } else {
L
longwei 已提交
712
            hilog.info(0x0000, 'testTag', 'getAllBundleInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
713 714 715
        }
    });
} catch (err) {
L
longwei 已提交
716
    hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
717 718 719 720 721 722 723
}
```

### bundleManager.getAllBundleInfo

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

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

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

W
wangtiantian 已提交
728
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
729 730 731 732 733

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

**参数:**

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

**示例:**

```ts
L
Lotol 已提交
742
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
743
import hilog from '@ohos.hilog';
W
wanghang 已提交
744 745 746 747 748
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getAllBundleInfo(bundleFlags, (err, data) => {
        if (err) {
L
longwei 已提交
749
            hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
750
        } else {
L
longwei 已提交
751
            hilog.info(0x0000, 'testTag', 'getAllBundleInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
752 753 754
        }
    });
} catch (err) {
L
longwei 已提交
755
    hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed: %{public}s', err.message);
W
wanghang 已提交
756 757 758 759 760 761 762
}
```

### bundleManager.getAllBundleInfo

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

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

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

W
wangtiantian 已提交
767
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
768 769 770 771 772

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

**参数:**

J
junyi233 已提交
773
| 参数名     | 类型   | 必填 | 说明                                             |
W
wanghang 已提交
774
| ----------- | ------ | ---- | -------------------------------------------------- |
Z
zhaogan 已提交
775
| bundleFlags | [number](#bundleflag) | 是   | 指定返回的BundleInfo所包含的信息。                   |
L
Lotol 已提交
776
| userId      | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。                      |
W
wanghang 已提交
777 778 779 780 781

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
788
| 错误码ID | 错误信息                         |
W
wanghang 已提交
789
| -------- | ---------------------------------- |
790
| 17700004 | The specified user ID is not found. |
W
wanghang 已提交
791 792 793 794

**示例:**

```ts
L
Lotol 已提交
795
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
796
import hilog from '@ohos.hilog';
W
wanghang 已提交
797 798 799 800
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getAllBundleInfo(bundleFlags).then((data) => {
L
longwei 已提交
801
        hilog.info(0x0000, 'testTag', 'getAllBundleInfo successfully. Data: %{public}s', JSON.stringify(data));
802
    }).catch(err => {
L
longwei 已提交
803
        hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
804
    });
805
} catch (err) {
L
longwei 已提交
806
    hilog.error(0x0000, 'testTag', 'getAllBundleInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
807 808 809 810 811 812 813
}
```

### bundleManager.getAllApplicationInfo

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

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

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

W
wangtiantian 已提交
818
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
819 820 821 822 823

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
834
| 错误码ID | 错误信息                         |
W
wanghang 已提交
835
| -------- | ---------------------------------- |
836
| 17700004 | The specified user ID is not found. |
W
wanghang 已提交
837 838 839 840

**示例:**

```ts
L
Lotol 已提交
841
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
842
import hilog from '@ohos.hilog';
W
wanghang 已提交
843 844 845 846 847 848
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;
let userId = 100;

try {
    bundleManager.getAllApplicationInfo(appFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
849
            hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
850
        } else {
L
longwei 已提交
851
            hilog.info(0x0000, 'testTag', 'getAllApplicationInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
852 853 854
        }
    });
} catch (err) {
L
longwei 已提交
855
    hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
856 857 858 859 860 861 862
}
```

### bundleManager.getAllApplicationInfo

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

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

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

W
wangtiantian 已提交
867
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
868 869 870 871 872

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

**参数:**

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

**示例:**

```ts
L
Lotol 已提交
881
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
882
import hilog from '@ohos.hilog';
W
wanghang 已提交
883 884 885 886 887
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;

try {
    bundleManager.getAllApplicationInfo(appFlags, (err, data) => {
        if (err) {
L
longwei 已提交
888
            hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
889
        } else {
L
longwei 已提交
890
            hilog.info(0x0000, 'testTag', 'getAllApplicationInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
891 892 893
        }
    });
} catch (err) {
L
longwei 已提交
894
    hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed: %{public}s', err.message);
W
wanghang 已提交
895 896 897 898 899 900 901
}
```

### bundleManager.getAllApplicationInfo

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

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

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

W
wangtiantian 已提交
906
**需要权限:** ohos.permission.GET_INSTALLED_BUNDLE_LIST
W
wanghang 已提交
907 908 909 910 911

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

**参数:**

J
junyi233 已提交
912
| 参数名  | 类型   | 必填 | 说明                                                      |
W
wanghang 已提交
913
| -------- | ------ | ---- | ---------------------------------------------------------- |
Z
zhaogan 已提交
914
| appFlags | [number](#applicationflag) | 是   | 指定返回的ApplicationInfo所包含的信息。                       |
L
Lotol 已提交
915
| userId   | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。                        |
W
wanghang 已提交
916 917 918 919 920

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
927
| 错误码ID | 错误信息                         |
W
wanghang 已提交
928
| -------- | ---------------------------------- |
929
| 17700004 | The specified user ID is not found. |
W
wanghang 已提交
930 931 932 933

**示例:**

```ts
L
Lotol 已提交
934
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
935
import hilog from '@ohos.hilog';
W
wanghang 已提交
936 937 938 939
let appFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;

try {
    bundleManager.getAllApplicationInfo(appFlags).then((data) => {
L
longwei 已提交
940
        hilog.info(0x0000, 'testTag', 'getAllApplicationInfo successfully. Data: %{public}s', JSON.stringify(data));
941
    }).catch(err => {
L
longwei 已提交
942
        hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
943
    });
944
} catch (err) {
L
longwei 已提交
945
    hilog.error(0x0000, 'testTag', 'getAllApplicationInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963
}

```

### 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 已提交
964
| 参数名      | 类型   | 必填 | 说明                                                  |
W
wanghang 已提交
965
| ------------ | ------ | ---- | ------------------------------------------------------- |
966
| want         | Want   | 是   | 表示包含要查询的应用Bundle名称的Want。                 |
Z
zhaogan 已提交
967 968 969
| abilityFlags | [number](#abilityflag) | 是   | 指定返回的AbilityInfo所包含的信息。                       |
| userId       | number | 是   | 表示用户ID。                               |
| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<AbilityInfo>;否则为错误对象。 |
W
wanghang 已提交
970 971 972

**错误码:**

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

J
junyi233 已提交
975
| 错误码ID | 错误信息                             |
W
wanghang 已提交
976
| -------- | -------------------------------------- |
Z
zhaogan 已提交
977 978 979 980 981
| 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 已提交
982 983 984 985

**示例:**

```ts
L
Lotol 已提交
986
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
987
import hilog from '@ohos.hilog';
W
wanghang 已提交
988 989 990 991
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
992
    abilityName : "EntryAbility"
W
wanghang 已提交
993 994 995 996 997
};

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
998
            hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
999
        } else {
L
longwei 已提交
1000
            hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1001 1002 1003
        }
    });
} catch (err) {
L
longwei 已提交
1004
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021
}
```

### 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 已提交
1022
| 参数名      | 类型   | 必填 | 说明                                                  |
W
wanghang 已提交
1023
| ------------ | ------ | ---- | -------------------------------------------------------|
1024
| want         | Want   | 是   | 表示包含要查询的应用Bundle名称的Want。                 |
Z
zhaogan 已提交
1025 1026
| abilityFlags | [number](#abilityflag) | 是   | 指定返回的AbilityInfo所包含的信息。       |
| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundleManager-abilityInfo.md)>> | 是 | 回调函数,当获取成功时,err为null,data为获取到的Array\<AbilityInfo>;否则为错误对象。 |
W
wanghang 已提交
1027 1028 1029

**错误码:**

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

J
junyi233 已提交
1032
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1033
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1034 1035 1036 1037
| 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 已提交
1038 1039 1040 1041

**示例:**

```ts
L
Lotol 已提交
1042
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1043
import hilog from '@ohos.hilog';
W
wanghang 已提交
1044 1045 1046
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let want = {
    bundleName : "com.example.myapplication",
1047
    abilityName : "EntryAbility"
W
wanghang 已提交
1048 1049 1050 1051 1052
};

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, (err, data) => {
        if (err) {
L
longwei 已提交
1053
            hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1054
        } else {
L
longwei 已提交
1055
            hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1056 1057 1058
        }
    });
} catch (err) {
L
longwei 已提交
1059
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076
}
```

### 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 已提交
1077
| 参数名      | 类型   | 必填 | 说明                                                  |
W
wanghang 已提交
1078
| ------------ | ------ | ---- | ------------------------------------------------------- |
1079
| want         | Want   | 是   | 表示包含要查询的应用Bundle名称的Want。                 |
Z
zhaogan 已提交
1080
| abilityFlags | [number](#abilityflag) | 是   | 表示指定返回的AbilityInfo所包含的信息。 |
L
Lotol 已提交
1081
| userId       | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。                       |
W
wanghang 已提交
1082 1083 1084 1085 1086

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
1093
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1094
| -------- | ------------------------------------- |
Z
zhaogan 已提交
1095
| 17700001 | The specified bundleName is not found. |
X
xsz233 已提交
1096
| 17700003 | The specified ability is not found.    |
Z
zhaogan 已提交
1097 1098 1099
| 17700004 | The specified userId is invalid.       |
| 17700026 | The specified bundle is disabled.      |
| 17700029 | The specified ability is disabled.     |
W
wanghang 已提交
1100 1101 1102 1103

**示例:**

```ts
L
Lotol 已提交
1104
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1105
import hilog from '@ohos.hilog';
W
wanghang 已提交
1106 1107 1108 1109
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1110
    abilityName : "EntryAbility"
W
wanghang 已提交
1111 1112 1113 1114
};

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((data) => {
L
longwei 已提交
1115
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(data));
1116
    }).catch(err => {
L
longwei 已提交
1117
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1118
    });
1119
} catch (err) {
L
longwei 已提交
1120
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1121 1122 1123 1124
}
```

```ts
L
Lotol 已提交
1125
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1126
import hilog from '@ohos.hilog';
W
wanghang 已提交
1127 1128 1129
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let want = {
    bundleName : "com.example.myapplication",
1130
    abilityName : "EntryAbility"
W
wanghang 已提交
1131 1132 1133 1134
};

try {
    bundleManager.queryAbilityInfo(want, abilityFlags).then((data) => {
L
longwei 已提交
1135
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(data));
1136
    }).catch(err => {
L
longwei 已提交
1137
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1138
    })
1139
} catch (err) {
L
longwei 已提交
1140
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157
}
```

### 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 已提交
1158
| 参数名                | 类型                                                         | 必填 | 说明                                                         |
W
wanghang 已提交
1159
| --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
1160 1161 1162 1163
| want                  | Want                                                         | 是   | 表示包含要查询的应用Bundle名称的Want。                       |
| extensionAbilityType  | [ExtensionAbilityType](#extensionabilitytype)                | 是   | 标识extensionAbility的类型。                                 |
| extensionAbilityFlags | [number](#extensionabilityflag)                              | 是   | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。    |
| userId                | number                                                       | 是   | 表示用户ID。                                                 |
Z
zhaogan 已提交
1164
| callback              | AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>> | 是   | 回调函数,当获取成功时,err为null,data为获取到Array\<ExtensionAbilityInfo>;否则为错误对象。 |
W
wanghang 已提交
1165 1166 1167

**错误码:**

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

J
junyi233 已提交
1170 1171
| 错误码ID | 错误信息                                    |
| -------- | ------------------------------------------- |
Z
zhaogan 已提交
1172 1173 1174 1175
| 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 已提交
1176 1177 1178 1179

**示例:**

```ts
L
Lotol 已提交
1180
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1181
import hilog from '@ohos.hilog';
W
wanghang 已提交
1182 1183 1184 1185 1186
let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM;
let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1187
    abilityName : "EntryAbility"
W
wanghang 已提交
1188 1189 1190 1191 1192
};

try {
    bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, userId, (err, data) => {
        if (err) {
L
longwei 已提交
1193
            hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1194
        } else {
L
longwei 已提交
1195
            hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1196 1197 1198
        }
    });
} catch (err) {
L
longwei 已提交
1199
    hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216
}
```

### 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 已提交
1217
| 参数名                | 类型                                                         | 必填 | 说明                                                         |
W
wanghang 已提交
1218
| --------------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
1219 1220 1221
| want                  | Want                                                         | 是   | 表示包含要查询的应用Bundle名称的Want。                       |
| extensionAbilityType  | [ExtensionAbilityType](#extensionabilitytype)                | 是   | 标识extensionAbility的类型。                                 |
| extensionAbilityFlags | [number](#extensionabilityflag)                              | 是   | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。    |
Z
zhaogan 已提交
1222
| callback              | AsyncCallback<Array\<[ExtensionAbilityInfo](js-apis-bundleManager-extensionAbilityInfo.md)>> | 是   | 回调函数,当获取成功时,err为null,data为获取到Array\<ExtensionAbilityInfo>;否则为错误对象。 |
W
wanghang 已提交
1223 1224 1225

**错误码:**

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

J
junyi233 已提交
1228 1229
| 错误码ID | 错误信息                                     |
| -------- | -------------------------------------------- |
Z
zhaogan 已提交
1230 1231 1232
| 17700001 | The specified bundleName is not found.       |
| 17700003 | The specified extensionAbility is not found. |
| 17700026 | The specified bundle is disabled.            |
W
wanghang 已提交
1233 1234 1235 1236

**示例:**

```ts
L
Lotol 已提交
1237
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1238
import hilog from '@ohos.hilog';
W
wanghang 已提交
1239 1240 1241 1242
let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM;
let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT;
let want = {
    bundleName : "com.example.myapplication",
1243
    abilityName : "EntryAbility"
W
wanghang 已提交
1244 1245 1246 1247 1248
};

try {
    bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, (err, data) => {
        if (err) {
L
longwei 已提交
1249
            hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1250
        } else {
L
longwei 已提交
1251
            hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1252 1253 1254
        }
    });
} catch (err) {
L
longwei 已提交
1255
    hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed: %{public}s', err.message);
W
wanghang 已提交
1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272
}
```

### 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

**参数:**

1273 1274 1275
| 参数名                | 类型                                          | 必填 | 说明                                                      |
| --------------------- | --------------------------------------------- | ---- | --------------------------------------------------------- |
| want                  | Want                                          | 是   | 表示包含要查询的应用Bundle名称的Want。                    |
Z
zhaogan 已提交
1276 1277
| extensionAbilityType  | [ExtensionAbilityType](#extensionabilitytype) | 是   | 标识extensionAbility的类型。                              |
| extensionAbilityFlags | [number](#extensionabilityflag)               | 是   | 表示用于指定将返回的ExtensionInfo对象中包含的信息的标志。 |
L
Lotol 已提交
1278
| userId                | number                                        | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。                                              |
W
wanghang 已提交
1279 1280 1281 1282 1283

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
1290
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1291
| -------- | --------------------------------------|
Z
zhaogan 已提交
1292 1293 1294 1295
| 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 已提交
1296 1297 1298 1299

**示例:**

```ts
L
Lotol 已提交
1300
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1301
import hilog from '@ohos.hilog';
W
wanghang 已提交
1302 1303 1304 1305 1306 1307

let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM;
let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1308
    abilityName : "EntryAbility"
W
wanghang 已提交
1309 1310 1311 1312
};

try {
    bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags, userId).then((data) => {
L
longwei 已提交
1313
        hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo successfully. Data: %{public}s', JSON.stringify(data));
1314
    }).catch(err => {
L
longwei 已提交
1315
        hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1316
    });
1317
} catch (err) {
L
longwei 已提交
1318
    hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1319 1320 1321 1322
}
```

```ts
L
Lotol 已提交
1323
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1324
import hilog from '@ohos.hilog';
W
wanghang 已提交
1325 1326 1327 1328
let extensionAbilityType = bundleManager.ExtensionAbilityType.FORM;
let extensionFlags = bundleManager.ExtensionAbilityFlag.GET_EXTENSION_ABILITY_INFO_DEFAULT;
let want = {
    bundleName : "com.example.myapplication",
1329
    abilityName : "EntryAbility"
W
wanghang 已提交
1330 1331 1332 1333
};

try {
    bundleManager.queryExtensionAbilityInfo(want, extensionAbilityType, extensionFlags).then((data) => {
L
longwei 已提交
1334
        hilog.info(0x0000, 'testTag', 'queryExtensionAbilityInfo successfully. Data: %{public}s', JSON.stringify(data));
1335
    }).catch(err => {
L
longwei 已提交
1336
        hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1337
    })
1338
} catch (err) {
L
longwei 已提交
1339
    hilog.error(0x0000, 'testTag', 'queryExtensionAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1340 1341 1342 1343 1344 1345 1346
}
```

### bundleManager.getBundleNameByUid

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

W
wtt1995 已提交
1347
以异步方法根据给定的uid获取对应的bundleName,使用callback形式返回结果。
W
wanghang 已提交
1348 1349 1350 1351 1352 1353 1354 1355 1356

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

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
1366
| 错误码ID | 错误信息            |
W
wanghang 已提交
1367
| -------- | --------------------- |
Z
zhaogan 已提交
1368
| 17700021 | The uid is not found. |
W
wanghang 已提交
1369 1370 1371 1372

**示例:**

```ts
L
Lotol 已提交
1373
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1374
import hilog from '@ohos.hilog';
W
wanghang 已提交
1375 1376 1377 1378
let uid = 20010005;
try {
    bundleManager.getBundleNameByUid(uid, (err, data) => {
        if (err) {
L
longwei 已提交
1379
            hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', err.message);
W
wanghang 已提交
1380
        } else {
L
longwei 已提交
1381
            hilog.info(0x0000, 'testTag', 'getBundleNameByUid successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1382 1383 1384
        }
    });
} catch (err) {
L
longwei 已提交
1385
    hilog.error(0x0000, 'testTag', 'getBundleNameByUid failed: %{public}s', err.message);
W
wanghang 已提交
1386 1387 1388 1389 1390 1391 1392
}
```

### bundleManager.getBundleNameByUid

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

W
wtt1995 已提交
1393
以异步方法根据给定的uid获取对应的bundleName,使用Promise形式返回结果。
W
wanghang 已提交
1394 1395 1396 1397 1398 1399 1400 1401 1402

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

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

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

**参数:**

J
junyi233 已提交
1403
| 参数名 | 类型   | 必填 | 说明                |
W
wanghang 已提交
1404
| ---- | ------ | ---- | ------------------ |
Z
zhaogan 已提交
1405
| uid  | number | 是   | 表示应用程序的UID。 |
W
wanghang 已提交
1406 1407 1408 1409 1410

**返回值:**

| 类型             | 说明                        |
| ---------------- | --------------------------- |
Z
zhaogan 已提交
1411
| Promise\<string> | Promise对象,返回bundleName。 |
W
wanghang 已提交
1412 1413 1414

**错误码:**

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

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

**示例:**

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

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

**错误码:**

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

J
junyi233 已提交
1462
| 错误码ID | 错误信息                  |
W
wanghang 已提交
1463
| -------- | --------------------------- |
Z
zhaogan 已提交
1464
| 17700022 | The hapFilePath is invalid. |
W
wanghang 已提交
1465 1466 1467 1468

**示例:**

```ts
L
Lotol 已提交
1469
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1470
import hilog from '@ohos.hilog';
W
wanghang 已提交
1471 1472 1473 1474 1475 1476
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 已提交
1477
            hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1478
        } else {
L
longwei 已提交
1479
            hilog.info(0x0000, 'testTag', 'getBundleArchiveInfo successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
1480 1481 1482
        }
    });
} catch (err) {
L
longwei 已提交
1483
    hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500
}
```

### 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 已提交
1501
| 参数名       | 类型   | 必填 | 说明                                                         |
W
wanghang 已提交
1502
| ----------- | ------ | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
1503 1504
| hapFilePath | string | 是   | 表示存储HAP的路径,路径应该是当前应用程序数据目录的相对路径。 |
| bundleFlags | [number](#bundleflag) | 是   | 表示用于指定要返回的BundleInfo对象中包含的信息的标志。       |
W
wanghang 已提交
1505 1506 1507 1508 1509

**返回值:**

| 类型                                                        | 说明                        |
| ----------------------------------------------------------- | --------------------------- |
Z
zhaogan 已提交
1510
| Promise\<[BundleInfo](js-apis-bundleManager-bundleInfo.md)> | Promise对象,返回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';
G
geng-wenguang 已提交
1524
import hilog from '@ohos.hilog';
W
wanghang 已提交
1525 1526 1527 1528 1529
let hapFilePath = "/data/xxx/test.hap";
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT;

try {
    bundleManager.getBundleArchiveInfo(hapFilePath, bundleFlags).then((data) => {
L
longwei 已提交
1530
        hilog.info(0x0000, 'testTag', 'getBundleArchiveInfo successfully. Data: %{public}s', JSON.stringify(data));
1531
    }).catch(err => {
L
longwei 已提交
1532
        hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1533
    });
1534
} catch (err) {
L
longwei 已提交
1535
    hilog.error(0x0000, 'testTag', 'getBundleArchiveInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1536 1537 1538 1539 1540 1541 1542
}
```

### bundleManager.cleanBundleCacheFiles

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

W
wtt1995 已提交
1543
以异步方法根据给定的bundleName清理BundleCache,使用callback形式返回结果。
W
wanghang 已提交
1544 1545 1546 1547 1548 1549 1550 1551 1552

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

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
1562
| 错误码ID | 错误信息                                                     |
W
wanghang 已提交
1563
| -------- | ------------------------------------------------------------ |
Z
zhaogan 已提交
1564
| 17700001 | The specified bundleName is not found.                        |
1565
| 17700030 | The specified bundle does not support clearing of cache files. |
W
wanghang 已提交
1566 1567 1568 1569

**示例:**

```ts
L
Lotol 已提交
1570
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1571
import hilog from '@ohos.hilog';
W
wanghang 已提交
1572 1573 1574 1575 1576
let bundleName = "com.ohos.myapplication";

try {
    bundleManager.cleanBundleCacheFiles(bundleName, err => {
        if (err) {
L
longwei 已提交
1577
            hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', err.message);
W
wanghang 已提交
1578
        } else {
G
geng-wenguang 已提交
1579
            hilog.info(0x0000, 'testTag', 'cleanBundleCacheFiles successfully.');
W
wanghang 已提交
1580 1581 1582
        }
    });
} catch (err) {
L
longwei 已提交
1583
    hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', err.message);
W
wanghang 已提交
1584 1585 1586 1587 1588 1589 1590
}
```

### bundleManager.cleanBundleCacheFiles

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

W
wtt1995 已提交
1591
以异步方法根据给定的bundleName清理BundleCache,使用Promise形式返回结果。
W
wanghang 已提交
1592 1593 1594 1595 1596 1597 1598 1599 1600

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

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

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

**参数:**

J
junyi233 已提交
1601 1602
| 参数名     | 类型   | 必填 | 说明                                       |
| ---------- | ------ | ---- | ------------------------------------------ |
Z
zhaogan 已提交
1603
| bundleName | string | 是   | 表示要清理其缓存数据的应用程序的bundleName。 |
W
wanghang 已提交
1604 1605 1606 1607 1608

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
1615 1616
| 错误码ID | 错误信息                                                   |
| -------- | ---------------------------------------------------------- |
Z
zhaogan 已提交
1617
| 17700001 | The specified bundleName is not found.                      |
J
junyi233 已提交
1618
| 17700030 | The specified bundle does not support clearing of cache files. |
W
wanghang 已提交
1619 1620 1621 1622

**示例:**

```ts
L
Lotol 已提交
1623
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1624
import hilog from '@ohos.hilog';
W
wanghang 已提交
1625 1626 1627
let bundleName = "com.ohos.myapplication";

try {
W
wtt1995 已提交
1628
    bundleManager.cleanBundleCacheFiles(bundleName).then(() => {
G
geng-wenguang 已提交
1629
        hilog.info(0x0000, 'testTag', 'cleanBundleCacheFiles successfully.');
W
wtt1995 已提交
1630
    }).catch(err => {
L
longwei 已提交
1631
        hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', err.message);
W
wanghang 已提交
1632 1633
    });
} catch (err) {
L
longwei 已提交
1634
    hilog.error(0x0000, 'testTag', 'cleanBundleCacheFiles failed: %{public}s', err.message);
W
wanghang 已提交
1635 1636 1637 1638 1639 1640 1641
}
```

### bundleManager.setApplicationEnabled

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

W
wtt1995 已提交
1642
设置指定应用的禁用或使能状态,使用callback形式返回结果。
W
wanghang 已提交
1643 1644 1645 1646 1647 1648 1649 1650 1651

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

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
1662
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1663
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1664
| 17700001 | The specified bundleName is not found. |
W
wanghang 已提交
1665 1666 1667 1668

**示例:**

```ts
L
Lotol 已提交
1669
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1670
import hilog from '@ohos.hilog';
W
wanghang 已提交
1671 1672 1673 1674 1675
let bundleName = "com.ohos.myapplication";

try {
    bundleManager.setApplicationEnabled(bundleName, false, err => {
        if (err) {
L
longwei 已提交
1676
            hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1677
        } else {
G
geng-wenguang 已提交
1678
            hilog.info(0x0000, 'testTag', 'setApplicationEnabled successfully.');
W
wanghang 已提交
1679 1680 1681
        }
    });
} catch (err) {
L
longwei 已提交
1682
    hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1683 1684 1685 1686 1687 1688 1689
}
```

### bundleManager.setApplicationEnabled

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

W
wtt1995 已提交
1690
设置指定应用的禁用或使能状态,使用Promise形式返回结果。
W
wanghang 已提交
1691 1692 1693 1694 1695 1696 1697 1698 1699

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

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

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

**参数:**

J
junyi233 已提交
1700
| 参数名      | 类型    | 必填 | 说明                                  |
W
wanghang 已提交
1701
| ---------- | ------- | ---- | ------------------------------------- |
Z
zhaogan 已提交
1702 1703
| bundleName | string  | 是   | 表示应用程序的bundleName。            |
| isEnabled  | boolean | 是   | 值为true表示使能,值为false表示禁用。 |
W
wanghang 已提交
1704 1705 1706 1707 1708

**返回值:**

| 类型           | 说明                                 |
| -------------- | ------------------------------------ |
Z
zhaogan 已提交
1709
| Promise\<void> | Promise对象。无返回结果的Promise对象。 |
W
wanghang 已提交
1710 1711 1712

**错误码:**

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

J
junyi233 已提交
1715
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1716
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1717
| 17700001 | The specified bundleName is not found. |
W
wanghang 已提交
1718 1719 1720 1721

**示例:**

```ts
L
Lotol 已提交
1722
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1723
import hilog from '@ohos.hilog';
W
wanghang 已提交
1724 1725 1726
let bundleName = "com.ohos.myapplication";

try {
W
wtt1995 已提交
1727
    bundleManager.setApplicationEnabled(bundleName, false).then(() => {
G
geng-wenguang 已提交
1728
        hilog.info(0x0000, "testTag", "setApplicationEnabled successfully.");
W
wtt1995 已提交
1729
    }).catch(err => {
L
longwei 已提交
1730
        hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1731 1732
    });
} catch (err) {
L
longwei 已提交
1733
    hilog.error(0x0000, 'testTag', 'setApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1734 1735 1736
}
```

1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778
### bundleManager.setApplicationEnabledSync<sup>10+</sup>

setApplicationEnabledSync(bundleName: string, isEnabled: boolean): void;

以同步方法设置指定应用的禁用或使能状态。

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

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

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

**参数:**

| 参数名      | 类型    | 必填 | 说明                                  |
| ---------- | ------- | ---- | ------------------------------------- |
| bundleName | string  | 是   | 指定应用的bundleName。                |
| isEnabled  | boolean | 是   | 值为true表示使能,值为false表示禁用。 |

**错误码:**

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

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

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
import hilog from '@ohos.hilog';
let bundleName = "com.ohos.myapplication";

try {
    bundleManager.setApplicationEnabledSync(bundleName, false);
    hilog.info(0x0000, 'testTag', 'setApplicationEnabledSync successfully.');
} catch (err) {
    hilog.error(0x0000, 'testTag', 'setApplicationEnabledSync failed: %{public}s', err.message);
}
```

W
wanghang 已提交
1779 1780 1781 1782
### bundleManager.setAbilityEnabled

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

W
wtt1995 已提交
1783
设置指定组件的禁用或使能状态,使用callback形式返回结果。
W
wanghang 已提交
1784 1785 1786 1787 1788 1789 1790 1791 1792

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

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
1803
| 错误码ID | 错误信息                              |
W
wanghang 已提交
1804
| -------- | ---------------------------------------|
Z
zhaogan 已提交
1805 1806
| 17700001 | The specified bundleName is not found.  |
| 17700003 | The specified abilityInfo is not found. |
W
wanghang 已提交
1807 1808 1809 1810

**示例:**

```ts
L
Lotol 已提交
1811
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1812
import hilog from '@ohos.hilog';
W
wanghang 已提交
1813 1814 1815 1816
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1817
    abilityName : "EntryAbility"
W
wanghang 已提交
1818
};
1819
let info;
W
wanghang 已提交
1820 1821 1822

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

        bundleManager.setAbilityEnabled(info, false, err => {
            if (err) {
L
longwei 已提交
1828
                hilog.error(0x0000, 'testTag', 'setAbilityEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1829
            } else {
1830
                hilog.info(0x0000, "testTag", "setAbilityEnabled successfully.");
W
wanghang 已提交
1831 1832
            }
        });
1833
    }).catch(err => {
L
longwei 已提交
1834
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1835
    });
1836
} catch (err) {
L
longwei 已提交
1837
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1838 1839 1840 1841 1842 1843 1844
}
```

### bundleManager.setAbilityEnabled

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

W
wtt1995 已提交
1845
设置指定组件的禁用或使能状态,使用Promise形式返回结果。
W
wanghang 已提交
1846 1847 1848 1849 1850 1851 1852 1853 1854

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

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

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

**参数:**

J
junyi233 已提交
1855
| 参数名    | 类型        | 必填 | 说明                                  |
W
wanghang 已提交
1856
| -------- | ----------- | ---- | ------------------------------------- |
Z
zhaogan 已提交
1857 1858
| info     | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是   | 需要被设置的组件。                   |
| isEnabled| boolean     | 是   | 值为true表示使能,值为false表示禁用。 |
W
wanghang 已提交
1859 1860 1861 1862 1863

**返回值:**

| 类型           | 说明                              |
| -------------- | --------------------------------- |
Z
zhaogan 已提交
1864
| Promise\<void> | Promise对象。无返回结果的Promise对象。 |
W
wanghang 已提交
1865 1866 1867

**错误码:**

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

J
junyi233 已提交
1870
| 错误码ID | 错误信息                              |
W
wanghang 已提交
1871
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1872 1873
| 17700001 | The specified bundleName is not found.  |
| 17700003 | The specified abilityInfo is not found. |
W
wanghang 已提交
1874 1875 1876 1877

**示例:**

```ts
L
Lotol 已提交
1878
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1879
import hilog from '@ohos.hilog';
W
wanghang 已提交
1880 1881 1882 1883
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1884
    abilityName : "EntryAbility"
W
wanghang 已提交
1885
};
1886
let info;
W
wanghang 已提交
1887 1888 1889

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

W
wtt1995 已提交
1893
        bundleManager.setAbilityEnabled(info, false).then(() => {
G
geng-wenguang 已提交
1894
            hilog.info(0x0000, "testTag", "setAbilityEnabled successfully.");
W
wtt1995 已提交
1895
        }).catch(err => {
L
longwei 已提交
1896
            hilog.error(0x0000, 'testTag', 'setAbilityEnabled failed: %{public}s', err.message);
W
wanghang 已提交
1897
        });
1898
    }).catch(err => {
L
longwei 已提交
1899
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1900
    });
1901
} catch (err) {
L
longwei 已提交
1902
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
1903 1904 1905
}
```

1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965
### bundleManager.setAbilityEnabledSync<sup>10+</sup>

setAbilityEnabledSync(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md), isEnabled: boolean): void;

以同步方法设置指定组件的禁用或使能状态。

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

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

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

**参数:**

| 参数名    | 类型        | 必填 | 说明                                  |
| -------- | ----------- | ---- | ------------------------------------- |
| info     | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是   | 需要被设置的组件。              |
| isEnabled| boolean     | 是   | 值为true表示使能,值为false表示禁用。 |

**错误码:**

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

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

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
import hilog from '@ohos.hilog';
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "EntryAbility"
};
let info;

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((abilitiesInfo) => {
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(abilitiesInfo));
        info = abilitiesInfo[0];

        try {
            bundleManager.setAbilityEnabledSync(info, false);
            hilog.info(0x0000, "testTag", "setAbilityEnabledSync successfully.");
        } catch (err) {
            hilog.error(0x0000, 'testTag', 'setAbilityEnabledSync failed: %{public}s', err.message);
        }
    }).catch(err => {
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
    });
} catch (err) {
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
}
```

W
wanghang 已提交
1966 1967 1968 1969
### bundleManager.isApplicationEnabled

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

W
wtt1995 已提交
1970
以异步的方法获取指定应用的禁用或使能状态,使用callback形式返回结果。
W
wanghang 已提交
1971 1972 1973 1974 1975 1976 1977

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

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

**参数:**

J
junyi233 已提交
1978
| 参数名      | 类型   | 必填 | 说明                       |
W
wanghang 已提交
1979
| ---------- | ------ | ---- | -------------------------- |
Z
zhaogan 已提交
1980 1981
| bundleName | string | 是   | 表示应用程序的bundleName。 |
| callback | AsyncCallback\<boolean> | 是 | 回调函数,返回true表示当前应用为使能状态,返回false表示应用为禁用状态。 |
W
wanghang 已提交
1982 1983 1984

**错误码:**

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

J
junyi233 已提交
1987
| 错误码ID | 错误信息                             |
W
wanghang 已提交
1988
| -------- | -------------------------------------- |
Z
zhaogan 已提交
1989
| 17700001 | The specified bundleName is not found. |
W
wanghang 已提交
1990 1991 1992 1993

**示例:**

```ts
L
Lotol 已提交
1994
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
1995
import hilog from '@ohos.hilog';
W
wanghang 已提交
1996 1997 1998 1999 2000
let bundleName = 'com.example.myapplication';

try {
    bundleManager.isApplicationEnabled(bundleName, (err, data) => {
        if (err) {
L
longwei 已提交
2001
            hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
2002
        } else {
L
longwei 已提交
2003
            hilog.info(0x0000, 'testTag', 'isApplicationEnabled successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2004 2005 2006
        }
    });
} catch (err) {
L
longwei 已提交
2007
    hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed: %{public}s', err.message);
W
wanghang 已提交
2008 2009 2010 2011 2012 2013 2014
}
```

### bundleManager.isApplicationEnabled

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

W
wtt1995 已提交
2015
以异步的方法获取指定应用的禁用或使能状态,使用Promise形式返回结果。
W
wanghang 已提交
2016 2017 2018 2019 2020 2021 2022

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

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

**参数:**

J
junyi233 已提交
2023
| 参数名      | 类型   | 必填 | 说明                       |
W
wanghang 已提交
2024
| ---------- | ------ | ---- | -------------------------- |
Z
zhaogan 已提交
2025
| bundleName | string | 是   | 表示应用程序的bundleName。  |
W
wanghang 已提交
2026 2027 2028 2029 2030 2031 2032 2033 2034

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
2037
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2038
| -------- | -------------------------------------- |
Z
zhaogan 已提交
2039
| 17700001 | The specified bundleName is not found. |
W
wanghang 已提交
2040 2041 2042 2043

**示例:**

```ts
L
Lotol 已提交
2044
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2045
import hilog from '@ohos.hilog';
W
wanghang 已提交
2046 2047 2048 2049
let bundleName = 'com.example.myapplication';

try {
    bundleManager.isApplicationEnabled(bundleName).then((data) => {
L
longwei 已提交
2050
        hilog.info(0x0000, 'testTag', 'isApplicationEnabled successfully. Data: %{public}s', JSON.stringify(data));
2051
    }).catch(err => {
L
longwei 已提交
2052
        hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2053
    });
2054
} catch (err) {
L
longwei 已提交
2055
    hilog.error(0x0000, 'testTag', 'isApplicationEnabled failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2056 2057 2058
}
```

2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103
### bundleManager.isApplicationEnabledSync<sup>10+</sup>

isApplicationEnabledSync(bundleName: string): boolean;

以同步方法获取指定应用的禁用或使能状态。

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

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

**参数:**

| 参数名      | 类型   | 必填 | 说明                       |
| ---------- | ------ | ---- | -------------------------- |
| bundleName | string | 是   | 表示应用程序的bundleName。 |

**返回值:**

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

**错误码:**

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

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

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
import hilog from '@ohos.hilog';
let bundleName = 'com.example.myapplication';

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

W
wanghang 已提交
2104 2105 2106 2107
### bundleManager.isAbilityEnabled

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

W
wtt1995 已提交
2108
以异步的方法获取指定组件的禁用或使能状态,使用callback形式返回结果。
W
wanghang 已提交
2109 2110 2111 2112 2113 2114 2115

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
2125
| 错误码ID | 错误信息                              |
W
wanghang 已提交
2126
| -------- | --------------------------------------- |
Z
zhaogan 已提交
2127 2128
| 17700001 | The specified bundleName is not found.  |
| 17700003 | The specified abilityName is not found. |
W
wanghang 已提交
2129 2130 2131 2132

**示例:**

```ts
L
Lotol 已提交
2133
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2134
import hilog from '@ohos.hilog';
W
wanghang 已提交
2135 2136 2137 2138
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
2139
    abilityName : "EntryAbility"
W
wanghang 已提交
2140
};
2141
let info;
W
wanghang 已提交
2142 2143 2144

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

        bundleManager.isAbilityEnabled(info, (err, data) => {
            if (err) {
L
longwei 已提交
2150
                hilog.error(0x0000, 'testTag', 'isAbilityEnabled failed: %{public}s', err.message);
W
wanghang 已提交
2151
            } else {
L
longwei 已提交
2152
                hilog.info(0x0000, 'testTag', 'isAbilityEnabled successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2153 2154
            }
        });
2155
    }).catch(err => {
L
longwei 已提交
2156
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2157
    });
2158
} catch (err) {
L
longwei 已提交
2159
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2160 2161 2162 2163 2164 2165 2166
}
```

### bundleManager.isAbilityEnabled

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

W
wtt1995 已提交
2167
以异步的方法获取指定组件的禁用或使能状态,使用Promise形式返回结果。
W
wanghang 已提交
2168 2169 2170 2171 2172 2173 2174

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

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

**参数:**

J
junyi233 已提交
2175
| 参数名 | 类型        | 必填 | 说明                        |
W
wanghang 已提交
2176
| ---- | ----------- | ---- | --------------------------- |
Z
zhaogan 已提交
2177
| info | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是   | 表示关于检查ability的信息。 |
W
wanghang 已提交
2178 2179 2180 2181 2182 2183 2184 2185 2186

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
2189
| 错误码ID | 错误信息                              |
W
wanghang 已提交
2190
| -------- | --------------------------------------- |
Z
zhaogan 已提交
2191 2192
| 17700001 | The specified bundleName is not found.  |
| 17700003 | The specified abilityName is not found. |
W
wanghang 已提交
2193 2194 2195 2196

**示例:**

```ts
L
Lotol 已提交
2197
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2198
import hilog from '@ohos.hilog';
W
wanghang 已提交
2199 2200 2201 2202
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
2203
    abilityName : "EntryAbility"
W
wanghang 已提交
2204
};
2205
let info;
W
wanghang 已提交
2206 2207 2208

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

        bundleManager.isAbilityEnabled(info).then((data) => {
L
longwei 已提交
2213
            hilog.info(0x0000, 'testTag', 'isAbilityEnabled successfully. Data: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2214
        }).catch(err => {
L
longwei 已提交
2215
            hilog.error(0x0000, 'testTag', 'isAbilityEnabled failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2216
        });
2217
    }).catch(err => {
L
longwei 已提交
2218
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2219
    });
2220
} catch (err) {
L
longwei 已提交
2221
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2222 2223 2224
}
```

2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287
### bundleManager.isAbilityEnabledSync<sup>10+</sup>

isAbilityEnabledSync(info: [AbilityInfo](js-apis-bundleManager-abilityInfo.md)): boolean;

以同步方法获取指定组件的禁用或使能状态。

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

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

**参数:**

| 参数名 | 类型        | 必填 | 说明                        |
| ---- | ----------- | ---- | --------------------------- |
| info | [AbilityInfo](js-apis-bundleManager-abilityInfo.md) | 是   | 表示关于检查ability的信息。 |

**返回值:**

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

**错误码:**

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

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

**示例:**

```ts
import bundleManager from '@ohos.bundle.bundleManager';
import hilog from '@ohos.hilog';
let abilityFlags = bundleManager.AbilityFlag.GET_ABILITY_INFO_DEFAULT;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "EntryAbility"
};
let info;

try {
    bundleManager.queryAbilityInfo(want, abilityFlags, userId).then((abilitiesInfo) => {
        hilog.info(0x0000, 'testTag', 'queryAbilityInfo successfully. Data: %{public}s', JSON.stringify(abilitiesInfo));
        info = abilitiesInfo[0];

        try {
            let data = bundleManager.isAbilityEnabledSync(info);
            hilog.info(0x0000, 'testTag', 'isAbilityEnabledSync successfully: %{public}s', JSON.stringify(data));
        } catch (err) {
            hilog.error(0x0000, 'testTag', 'isAbilityEnabledSync failed: %{public}s', err.message);
        }
    }).catch(err => {
        hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
    });
} catch (err) {
    hilog.error(0x0000, 'testTag', 'queryAbilityInfo failed. Cause: %{public}s', err.message);
}
```

W
wanghang 已提交
2288 2289 2290 2291
### bundleManager.getLaunchWantForBundle

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

W
wtt1995 已提交
2292
以异步方法根据给定的bundleName和userId获取用于启动应用程序的Want参数,使用callback形式返回结果。
W
wanghang 已提交
2293 2294 2295 2296 2297 2298 2299 2300 2301

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

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

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

**参数:**

J
junyi233 已提交
2302
| 参数名     | 类型                 | 必填 | 说明                                                         |
W
wanghang 已提交
2303
| ---------- | -------------------- | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
2304 2305 2306
| bundleName | string               | 是   | 表示应用程序的bundleName。                                     |
| userId     | number               | 是   | 表示用户ID。                                                   |
| callback   | AsyncCallback\<Want> | 是   | 回调函数,当获取成功时,err为null,data为获取到的Want;否则为错误对象。 |
W
wanghang 已提交
2307 2308 2309

**错误码:**

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

J
junyi233 已提交
2312
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2313
| -------- | --------------------------------------|
Z
zhaogan 已提交
2314
| 17700001 | The specified bundleName is not found. |
J
junyi233 已提交
2315
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
2316
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
2317 2318 2319 2320

**示例:**

```ts
L
Lotol 已提交
2321
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2322
import hilog from '@ohos.hilog';
W
wanghang 已提交
2323 2324 2325 2326 2327 2328
let bundleName = 'com.example.myapplication';
let userId = 100;

try {
    bundleManager.getLaunchWantForBundle(bundleName, userId, (err, data) => {
        if (err) {
L
longwei 已提交
2329
            hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', err.message);
W
wanghang 已提交
2330
        } else {
L
longwei 已提交
2331
            hilog.info(0x0000, 'testTag', 'getLaunchWantForBundle successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2332 2333 2334
        }
    });
} catch (err) {
L
longwei 已提交
2335
    hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', err.message);
W
wanghang 已提交
2336 2337 2338 2339 2340 2341 2342
}
```

### bundleManager.getLaunchWantForBundle

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

W
wtt1995 已提交
2343
以异步方法根据给定的bundleName获取用于启动应用程序的Want参数,使用callback形式返回结果。
W
wanghang 已提交
2344 2345 2346 2347 2348 2349 2350 2351 2352

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

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
2362
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2363
| -------- | --------------------------------------|
Z
zhaogan 已提交
2364 2365
| 17700001 | The specified bundleName is not found. |
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
2366 2367 2368 2369

**示例:**

```ts
L
Lotol 已提交
2370
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2371
import hilog from '@ohos.hilog';
W
wanghang 已提交
2372 2373 2374 2375 2376
let bundleName = 'com.example.myapplication';

try {
    bundleManager.getLaunchWantForBundle(bundleName, (err, data) => {
        if (err) {
L
longwei 已提交
2377
            hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', err.message);
W
wanghang 已提交
2378
        } else {
L
longwei 已提交
2379
            hilog.info(0x0000, 'testTag', 'getLaunchWantForBundle successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2380 2381 2382
        }
    });
} catch (err) {
L
longwei 已提交
2383
    hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed: %{public}s', err.message);
W
wanghang 已提交
2384 2385 2386 2387 2388 2389 2390
}
```

### bundleManager.getLaunchWantForBundle

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

W
wtt1995 已提交
2391
以异步方法根据给定的bundleName和userId获取用于启动应用程序的Want参数,使用Promise形式返回结果。
W
wanghang 已提交
2392 2393 2394 2395 2396 2397 2398 2399 2400

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

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

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

**参数:**

Z
zhaogan 已提交
2401 2402 2403
| 参数名     | 类型   | 必填 | 说明                       |
| ---------- | ------ | ---- | ------------------------- |
| bundleName | string | 是   | 表示应用程序的bundleName。 |
L
Lotol 已提交
2404
| userId     | number | 否   | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0。  |
W
wanghang 已提交
2405 2406 2407 2408 2409

**返回值:**

| 类型           | 说明                      |
| -------------- | ------------------------- |
Z
zhaogan 已提交
2410
| Promise\<Want> | Promise对象,返回Want对象。 |
W
wanghang 已提交
2411 2412 2413

**错误码:**

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

J
junyi233 已提交
2416
| 错误码ID | 错误信息                             |
W
wanghang 已提交
2417
| -------- | --------------------------------------|
Z
zhaogan 已提交
2418
| 17700001 | The specified bundleName is not found. |
2419
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
2420
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
2421 2422 2423 2424

**示例:**

```ts
L
Lotol 已提交
2425
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2426
import hilog from '@ohos.hilog';
W
wanghang 已提交
2427 2428 2429 2430 2431
let bundleName = 'com.example.myapplication';
let userId = 100;

try {
    bundleManager.getLaunchWantForBundle(bundleName, userId).then((data) => {
L
longwei 已提交
2432
        hilog.info(0x0000, 'testTag', 'getLaunchWantForBundle successfully. Data: %{public}s', JSON.stringify(data));
2433
    }).catch(err => {
L
longwei 已提交
2434
        hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2435
    });
2436
} catch (err) {
L
longwei 已提交
2437
    hilog.error(0x0000, 'testTag', 'getLaunchWantForBundle failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2438 2439 2440 2441 2442
}
```

### bundleManager.getProfileByAbility

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

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

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

**参数:**

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

**错误码:**

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

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

**示例:**

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

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

### bundleManager.getProfileByAbility

J
junyi233 已提交
2494
getProfileByAbility(moduleName: string, abilityName: string, metadataName?: string): Promise\<Array\<string\>\>;
W
wanghang 已提交
2495 2496 2497 2498 2499 2500 2501

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

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

**参数:**

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

**返回值:**

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

**错误码:**

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

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

**示例:**

```ts
L
Lotol 已提交
2529
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2530
import hilog from '@ohos.hilog';
W
wanghang 已提交
2531
let moduleName = 'entry';
2532
let abilityName = 'EntryAbility';
W
wanghang 已提交
2533 2534 2535

try {
    bundleManager.getProfileByAbility(moduleName, abilityName).then((data) => {
L
longwei 已提交
2536
        hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully. Data: %{public}s', JSON.stringify(data));
2537
    }).catch(err => {
L
longwei 已提交
2538
        hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2539
    });
2540
} catch (err) {
L
longwei 已提交
2541
    hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2542
}
Z
zhaogan 已提交
2543
```
W
wanghang 已提交
2544

Z
zhaogan 已提交
2545
```ts
L
Lotol 已提交
2546
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2547
import hilog from '@ohos.hilog';
Z
zhaogan 已提交
2548
let moduleName = 'entry';
2549
let abilityName = 'EntryAbility';
Z
zhaogan 已提交
2550
let metadataName = 'com.example.myapplication.metadata';
W
wanghang 已提交
2551
try {
Z
zhaogan 已提交
2552
    bundleManager.getProfileByAbility(moduleName, abilityName, metadataName).then((data) => {
L
longwei 已提交
2553
        hilog.info(0x0000, 'testTag', 'getProfileByAbility successfully. Data: %{public}s', JSON.stringify(data));
2554
    }).catch(err => {
L
longwei 已提交
2555
        hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2556
    });
2557
} catch (err) {
L
longwei 已提交
2558
    hilog.error(0x0000, 'testTag', 'getProfileByAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2559 2560 2561 2562 2563
}
```

### bundleManager.getProfileByExtensionAbility

J
junyi233 已提交
2564
getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, metadataName: string, callback: AsyncCallback\<Array\<string\>\>): void;
W
wanghang 已提交
2565 2566 2567 2568 2569 2570 2571

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

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

**参数:**

2572
| 参数名                 | 类型                          | 必填 | 说明                                                         |
W
wanghang 已提交
2573
| -------------------- | ----------------------------- | ---- | ------------------------------------------------------------ |
J
junyi233 已提交
2574 2575 2576
| moduleName           | string                        | 是   | 表示应用程序的moduleName。                                   |
| extensionAbilityName | string                        | 是   | 表示应用程序的extensionAbilityName。                         |
| metadataName         | string                        | 是   | 表示应用程序的metadataName。                                 |
Z
zhaogan 已提交
2577
| callback             | AsyncCallback<Array\<string>> | 是   | 回调函数,当获取成功时,err为null,data为获取到的Array\<string>;否则为错误对象。 |
W
wanghang 已提交
2578 2579 2580

**错误码:**

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

J
junyi233 已提交
2583
| 错误码ID | 错误信息                                                     |
W
wanghang 已提交
2584
| -------- | ------------------------------------------------------------ |
L
Lotol 已提交
2585
| 17700002 | The specified moduleName is not existed.                      |
J
junyi233 已提交
2586
| 17700003 | The specified extensionAbilityName not existed.            |
2587
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
Z
zhaogan 已提交
2588
| 17700026 | The specified bundle is disabled.                             |
W
wanghang 已提交
2589 2590 2591 2592

**示例:**

```ts
L
Lotol 已提交
2593
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2594
import hilog from '@ohos.hilog';
W
wanghang 已提交
2595 2596 2597 2598 2599 2600 2601
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 已提交
2602
            hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed: %{public}s', err.message);
W
wanghang 已提交
2603
        } else {
L
longwei 已提交
2604
            hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2605 2606 2607
        }
    });
} catch (err) {
L
longwei 已提交
2608
    hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed: %{public}s', err.message);
W
wanghang 已提交
2609 2610 2611 2612 2613
}
```

### bundleManager.getProfileByExtensionAbility

J
junyi233 已提交
2614
getProfileByExtensionAbility(moduleName: string, extensionAbilityName: string, metadataName?: string): Promise\<Array\<string\>\>;
W
wanghang 已提交
2615 2616 2617 2618 2619 2620 2621

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

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

**参数:**

2622
| 参数名                 | 类型   | 必填 | 说明                               |
J
junyi233 已提交
2623
| -------------------- | ------ | ---- | ---------------------------------- |
Z
zhaogan 已提交
2624 2625
| moduleName           | string | 是   | 表示应用程序的moduleName。           |
| extensionAbilityName | string | 是   | 表示应用程序的extensionAbilityName。 |
L
Lotol 已提交
2626
| metadataName         | string | 否   | 表示应用程序的metadataName,默认值为空。         |
W
wanghang 已提交
2627 2628 2629 2630 2631

**返回值:**

| 类型                    | 说明                                |
| ----------------------- | ----------------------------------- |
Z
zhaogan 已提交
2632
| Promise<Array\<string>> | Promise对象,返回Array\<string>对象。 |
W
wanghang 已提交
2633 2634 2635

**错误码:**

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

J
junyi233 已提交
2638
| 错误码ID | 错误信息                                                     |
W
wanghang 已提交
2639
| -------- | ------------------------------------------------------------ |
L
Lotol 已提交
2640
| 17700002 | The specified moduleName is not existed.                      |
J
junyi233 已提交
2641
| 17700003 | The specified extensionAbilityName not existed.            |
2642
| 17700024 | Failed to get the profile because there is no profile in the HAP. |
Z
zhaogan 已提交
2643
| 17700026 | The specified bundle is disabled.                             |
W
wanghang 已提交
2644 2645 2646 2647

**示例:**

```ts
L
Lotol 已提交
2648
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2649
import hilog from '@ohos.hilog';
W
wanghang 已提交
2650 2651 2652 2653 2654 2655
let moduleName = 'entry';
let extensionAbilityName = 'com.example.myapplication.extension';
let metadataName = 'com.example.myapplication.metadata';

try {
    bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName).then((data) => {
L
longwei 已提交
2656
        hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully. Data: %{public}s', JSON.stringify(data));
2657
    }).catch(err => {
L
longwei 已提交
2658
        hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2659
    });
2660
} catch (err) {
L
longwei 已提交
2661
    hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2662 2663 2664 2665
}

try {
    bundleManager.getProfileByExtensionAbility(moduleName, extensionAbilityName, metadataName).then((data) => {
L
longwei 已提交
2666
        hilog.info(0x0000, 'testTag', 'getProfileByExtensionAbility successfully. Data: %{public}s', JSON.stringify(data));
2667
    }).catch(err => {
L
longwei 已提交
2668
        hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2669
    });
2670
} catch (err) {
L
longwei 已提交
2671
    hilog.error(0x0000, 'testTag', 'getProfileByExtensionAbility failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2672 2673 2674 2675 2676 2677 2678
}
```

### bundleManager.getPermissionDef

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

W
wtt1995 已提交
2679
以异步方法根据给定的permissionName获取权限定义结构体PermissionDef信息,使用callback形式返回结果。
W
wanghang 已提交
2680 2681 2682 2683 2684 2685 2686 2687 2688

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

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

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

**参数:**

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

**错误码:**

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

J
junyi233 已提交
2698 2699
| 错误码ID | 错误信息                              |
| -------- | ------------------------------------- |
Z
zhaogan 已提交
2700
| 17700006 | The specified permission is not found. |
W
wanghang 已提交
2701 2702 2703 2704

**示例:**

```ts
L
Lotol 已提交
2705
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2706
import hilog from '@ohos.hilog';
W
wanghang 已提交
2707 2708 2709 2710
let permission = "ohos.permission.GET_BUNDLE_INFO";
try {
    bundleManager.getPermissionDef(permission, (err, data) => {
        if (err) {
L
longwei 已提交
2711
            hilog.error(0x0000, 'testTag', 'getPermissionDef failed: %{public}s', err.message);
W
wanghang 已提交
2712
        } else {
L
longwei 已提交
2713
            hilog.info(0x0000, 'testTag', 'getPermissionDef successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2714 2715 2716
        }
    });
} catch (err) {
L
longwei 已提交
2717
    hilog.error(0x0000, 'testTag', 'getPermissionDef failed: %{public}s', err.message);
W
wanghang 已提交
2718 2719 2720 2721 2722 2723 2724
}
```

### bundleManager.getPermissionDef

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

W
wtt1995 已提交
2725
以异步方法根据给定的permissionName获取权限定义结构体PermissionDef信息,使用Promise形式返回结果。
W
wanghang 已提交
2726 2727 2728 2729 2730 2731 2732 2733 2734

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

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

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

**参数:**

2735
| 参数名           | 类型   | 必填 | 说明           |
J
junyi233 已提交
2736
| -------------- | ------ | ---- | -------------- |
Z
zhaogan 已提交
2737
| permissionName | string | 是   | 表示权限参数名。 |
W
wanghang 已提交
2738 2739 2740 2741 2742

**返回值:**

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

**错误码:**

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

J
junyi233 已提交
2749 2750
| 错误码ID | 错误信息                              |
| -------- | ------------------------------------- |
Z
zhaogan 已提交
2751
| 17700006 | The specified permission is not found. |
W
wanghang 已提交
2752 2753 2754 2755

**示例:**

```ts
L
Lotol 已提交
2756
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2757
import hilog from '@ohos.hilog';
W
wanghang 已提交
2758 2759 2760
let permissionName = "ohos.permission.GET_BUNDLE_INFO";
try {
    bundleManager.getPermissionDef(permissionName).then((data) => {
L
longwei 已提交
2761
        hilog.info(0x0000, 'testTag', 'getPermissionDef successfully. Data: %{public}s', JSON.stringify(data));
2762
    }).catch(err => {
L
longwei 已提交
2763
        hilog.error(0x0000, 'testTag', 'getPermissionDef failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2764
    });
2765
} catch (err) {
L
longwei 已提交
2766
    hilog.error(0x0000, 'testTag', 'getPermissionDef failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2767 2768 2769 2770 2771 2772 2773 2774 2775 2776 2777 2778 2779 2780 2781 2782 2783
}
```

### 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 已提交
2784
| 参数名      | 类型                   | 必填 | 说明                                                         |
W
wanghang 已提交
2785
| ----------- | ---------------------- | ---- | ------------------------------------------------------------ |
Z
zhaogan 已提交
2786 2787 2788 2789
| bundleName  | string                 | 是   | 表示应用程序的bundleName。                                     |
| moduleName  | string                 | 是   | 表示应用程序的moduleName。                                     |
| abilityName | string                 | 是   | 表示应用程序的abilityName。                                    |
| callback    | AsyncCallback\<string> | 是   | 回调函数,当获取成功时,err为null,data为获指定组件的Label值;否则为错误对象。 |
W
wanghang 已提交
2790 2791 2792

**错误码:**

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

J
junyi233 已提交
2795 2796
| 错误码ID | 错误信息                               |
| -------- | -------------------------------------- |
Z
zhaogan 已提交
2797 2798 2799 2800 2801
| 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 已提交
2802 2803 2804 2805

**示例:**

```ts
L
Lotol 已提交
2806
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2807
import hilog from '@ohos.hilog';
W
wanghang 已提交
2808 2809
let bundleName = 'com.example.myapplication';
let moduleName = 'entry';
2810
let abilityName = 'EntryAbility';
W
wanghang 已提交
2811 2812 2813 2814

try {
    bundleManager.getAbilityLabel(bundleName, moduleName, abilityName, (err, data) => {
        if (err) {
L
longwei 已提交
2815
            hilog.error(0x0000, 'testTag', 'getAbilityLabel failed: %{public}s', err.message);
W
wanghang 已提交
2816
        } else {
L
longwei 已提交
2817
            hilog.info(0x0000, 'testTag', 'getAbilityLabel successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2818 2819 2820
        }
    });
} catch (err) {
L
longwei 已提交
2821
    hilog.error(0x0000, 'testTag', 'getAbilityLabel failed: %{public}s', err.message);
W
wanghang 已提交
2822 2823 2824 2825 2826 2827 2828 2829 2830 2831 2832 2833 2834 2835 2836 2837 2838
}
```

### 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 已提交
2839
| 参数名      | 类型   | 必填 | 说明                      |
W
wanghang 已提交
2840
| ----------- | ------ | ---- | ------------------------- |
Z
zhaogan 已提交
2841 2842 2843
| bundleName  | string | 是   | 表示应用程序的bundleName。  |
| moduleName  | string | 是   | 表示应用程序的moduleName。  |
| abilityName | string | 是   | 表示应用程序的abilityName。 |
W
wanghang 已提交
2844 2845 2846 2847 2848

**返回值:**

| 类型             | 说明                                |
| ---------------- | ----------------------------------- |
Z
zhaogan 已提交
2849
| Promise\<string> | Promise对象,返回指定组件的Lablel值。 |
W
wanghang 已提交
2850 2851 2852

**错误码:**

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

J
junyi233 已提交
2855
| 错误码ID | 错误信息                              |
W
wanghang 已提交
2856
| -------- | --------------------------------------- |
Z
zhaogan 已提交
2857 2858 2859 2860 2861
| 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 已提交
2862 2863 2864 2865

**示例:**

```ts
L
Lotol 已提交
2866
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2867
import hilog from '@ohos.hilog';
W
wanghang 已提交
2868 2869
let bundleName = 'com.example.myapplication';
let moduleName = 'entry';
2870
let abilityName = 'EntryAbility';
W
wanghang 已提交
2871 2872 2873

try {
    bundleManager.getAbilityLabel(bundleName, moduleName, abilityName).then((data) => {
L
longwei 已提交
2874
        hilog.info(0x0000, 'testTag', 'getAbilityLabel successfully. Data: %{public}s', JSON.stringify(data));
2875
    }).catch(err => {
L
longwei 已提交
2876
        hilog.error(0x0000, 'testTag', 'getAbilityLabel failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2877
    });
2878
} catch (err) {
L
longwei 已提交
2879
    hilog.error(0x0000, 'testTag', 'getAbilityLabel failed. Cause: %{public}s', err.message);
W
wanghang 已提交
2880 2881 2882 2883 2884 2885 2886 2887
}
```


### bundleManager.getApplicationInfoSync

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

W
wtt1995 已提交
2888
以同步方法根据给定的bundleName、applicationFlags和userId获取ApplicationInfo。
W
wanghang 已提交
2889 2890 2891 2892 2893

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

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

W
wtt1995 已提交
2894
**系统能力:** SystemCapability.BundleManager.BundleFramework.Core。
W
wanghang 已提交
2895 2896 2897

**参数:**

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

**返回值:**

| 类型            | 说明                      |
| --------------- | ------------------------- |
Z
zhaogan 已提交
2908
| [ApplicationInfo](js-apis-bundleManager-applicationInfo.md) | 返回ApplicationInfo对象。 |
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. |
J
junyi233 已提交
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';
G
geng-wenguang 已提交
2924
import hilog from '@ohos.hilog';
W
wanghang 已提交
2925 2926 2927 2928 2929 2930
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 已提交
2931
    hilog.info(0x0000, 'testTag', 'getApplicationInfoSync successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2932
} catch (err) {
L
longwei 已提交
2933
    hilog.error(0x0000, 'testTag', 'getApplicationInfoSync failed: %{public}s', err.message);
W
wanghang 已提交
2934 2935 2936
}
```

J
junyi233 已提交
2937 2938 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
### 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 已提交
2973
```ts
L
Lotol 已提交
2974
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
2975
import hilog from '@ohos.hilog';
W
wanghang 已提交
2976 2977 2978 2979 2980
let bundleName = 'com.example.myapplication';
let applicationFlags = bundleManager.ApplicationFlag.GET_APPLICATION_INFO_DEFAULT;

try {
    let data = bundleManager.getApplicationInfoSync(bundleName, applicationFlags);
L
longwei 已提交
2981
    hilog.info(0x0000, 'testTag', 'getApplicationInfoSync successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
2982
} catch (err) {
L
longwei 已提交
2983
    hilog.error(0x0000, 'testTag', 'getApplicationInfoSync failed: %{public}s', err.message);
W
wanghang 已提交
2984 2985 2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996 2997 2998 2999 3000
}
```

### 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 已提交
3001
| 参数名       | 类型   | 必填 | 说明                                                     |
W
wanghang 已提交
3002
| ----------- | ------ | ---- | -------------------------------------------------------- |
Z
zhaogan 已提交
3003 3004
| bundleName  | string | 是   | 表示应用程序的bundleName。                                 |
| bundleFlags | [number](#bundleflag) | 是   | 表示用于指定将返回的BundleInfo对象中包含的信息的标志。 |
J
junyi233 已提交
3005
| userId      | number | 是   | 表示用户ID。                                             |
W
wanghang 已提交
3006 3007 3008 3009 3010

**返回值:**

| 类型       | 说明                 |
| ---------- | -------------------- |
Z
zhaogan 已提交
3011
| [BundleInfo](js-apis-bundleManager-bundleInfo.md) | 返回BundleInfo对象。 |
W
wanghang 已提交
3012 3013 3014

**错误码:**

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

J
junyi233 已提交
3017
| 错误码ID | 错误信息                             |
W
wanghang 已提交
3018
| -------- | ------------------------------------- |
Z
zhaogan 已提交
3019
| 17700001 | The specified bundleName is not found. |
3020
| 17700004 | The specified user ID is not found.     |
Z
zhaogan 已提交
3021
| 17700026 | The specified bundle is disabled.      |
W
wanghang 已提交
3022 3023 3024 3025

**示例:**

```ts
L
Lotol 已提交
3026
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
3027
import hilog from '@ohos.hilog';
W
wanghang 已提交
3028 3029 3030 3031 3032 3033
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 已提交
3034
    hilog.info(0x0000, 'testTag', 'getBundleInfoSync successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
3035
} catch (err) {
L
longwei 已提交
3036
    hilog.error(0x0000, 'testTag', 'getBundleInfoSync failed: %{public}s', err.message);
W
wanghang 已提交
3037 3038 3039
}
```

J
junyi233 已提交
3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075
### 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 已提交
3076
```ts
L
Lotol 已提交
3077
import bundleManager from '@ohos.bundle.bundleManager';
G
geng-wenguang 已提交
3078
import hilog from '@ohos.hilog';
W
wanghang 已提交
3079 3080 3081
let bundleName = 'com.example.myapplication';
let bundleFlags = bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION;
try {
Z
zhaogan 已提交
3082
    let data = bundleManager.getBundleInfoSync(bundleName, bundleFlags);
L
longwei 已提交
3083
    hilog.info(0x0000, 'testTag', 'getBundleInfoSync successfully: %{public}s', JSON.stringify(data));
W
wanghang 已提交
3084
} catch (err) {
L
longwei 已提交
3085
    hilog.error(0x0000, 'testTag', 'getBundleInfoSync failed: %{public}s', err.message);
W
wanghang 已提交
3086
}
Z
zhongjianfei 已提交
3087
```
J
junyi233 已提交
3088

3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106
### 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。                                   |
3107
| callback   | AsyncCallback\<Array\<[SharedBundleInfo](js-apis-bundleManager-sharedBundleInfo.md)\>\> | 是   | 回调函数,当获取成功时,err为null,data为获取的指定共享包信息。 |
3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133 3134 3135 3136 3137 3138 3139 3140

**错误码:**

以下错误码的详细介绍请参见[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';
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) {
    hilog.error(0x0000, 'testTag', 'getSharedBundleInfo failed: %{public}s', err.message);
}
```

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

X
fix doc  
xsz233 已提交
3141
getSharedBundleInfo(bundleName: string, moduleName: string): Promise\<Array\<SharedBundleInfo\>\>;
3142 3143 3144 3145 3146 3147 3148 3149 3150 3151 3152 3153 3154 3155 3156 3157 3158 3159 3160 3161

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

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

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

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

**参数:**

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

**返回值:**

| 类型                                                         | 说明                                |
| ------------------------------------------------------------ | ----------------------------------- |
3162
| Promise\<Array\<[SharedBundleInfo](js-apis-bundleManager-sharedBundleInfo.md)\>\> | Promise对象,返回指定的共享包信息。 |
3163 3164 3165 3166 3167 3168 3169 3170 3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230

**错误码:**

以下错误码的详细介绍请参见[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';
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));
    }).catch(err => {
        hilog.error(0x0000, 'testTag', 'getSharedBundleInfo failed. Cause: %{public}s', err.message);
    });
} catch (err) {
    hilog.error(0x0000, 'testTag', 'getSharedBundleInfo failed. Cause: %{public}s', err.message);
}
```

### 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';
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) {
    hilog.error(0x0000, 'testTag', 'getAllSharedBundleInfo failed: %{public}s', err.message);
}
```

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

X
fix doc  
xsz233 已提交
3231
getAllSharedBundleInfo(): Promise\<Array\<SharedBundleInfo\>\>;
3232 3233 3234 3235 3236 3237 3238 3239 3240 3241 3242 3243 3244 3245 3246 3247 3248 3249 3250 3251 3252 3253 3254 3255 3256 3257 3258 3259 3260 3261 3262 3263

以异步的方法获取所有的共享包信息,使用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';
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) {
    hilog.error(0x0000, 'testTag', 'getAllSharedBundleInfo failed. Cause: %{public}s', err.message);
}
```

W
wangtiantian 已提交
3264 3265
### bundleManager.getAppProvisionInfo<sup>10+</sup>

W
wangtiantian 已提交
3266
getAppProvisionInfo(bundleName: string, callback: AsyncCallback\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\>): void;
W
wangtiantian 已提交
3267 3268 3269 3270 3271 3272 3273 3274 3275 3276 3277 3278 3279

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

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

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

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

**参数:**

| 参数名   | 类型                                                         | 必填 | 说明                                                         |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
W
wangtiantian 已提交
3280
| bundleName | string | 是   | 指定应用的bundleName。 |
W
wangtiantian 已提交
3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312
| 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';
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) {
    hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', err.message);
}
```

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

W
wangtiantian 已提交
3313
getAppProvisionInfo(bundleName: string, userId: number, callback: AsyncCallback\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\>): void;
W
wangtiantian 已提交
3314 3315 3316 3317 3318 3319 3320 3321 3322 3323 3324 3325 3326

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

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

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

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

**参数:**

| 参数名   | 类型                                                         | 必填 | 说明                                                         |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
W
wangtiantian 已提交
3327 3328
| bundleName | string | 是   | 指定应用的bundleName。 |
| userId | number | 是 | 指定用户ID, 可以通过接口[getOsAccountLocalId](js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 |
W
wangtiantian 已提交
3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363
| 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';
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) {
    hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed: %{public}s', err.message);
}
```

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

W
wangtiantian 已提交
3364
getAppProvisionInfo(bundleName: string, userId?: number): Promise\<[AppProvisionInfo](js-apis-bundleManager-AppProvisionInfo.md)\>;
W
wangtiantian 已提交
3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377

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

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

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

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

**参数:**

| 参数名   | 类型         | 必填 | 说明          |
| -------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
W
wangtiantian 已提交
3378
| bundleName | string | 是 | 指定的bundleName。 |
L
Lotol 已提交
3379
| userId | number | 否 | 表示用户ID,默认值:调用方所在用户,取值范围:大于等于0,可以通过接口[getOsAccountLocalId](js-apis-osAccount.md#getosaccountlocalid9)获取当前设备上的用户ID。 |
W
wangtiantian 已提交
3380 3381 3382 3383 3384 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


**返回值:**

| 类型                                                         | 说明                                |
| ------------------------------------------------------------ | ----------------------------------- |
| 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';
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));
    }).catch(err => {
        hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed. Cause: %{public}s', err.message);
    });
} catch (err) {
    hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed. Cause: %{public}s', err.message);
}

try {
    bundleManager.getAppProvisionInfo(bundleName, userId).then((data) => {
        hilog.info(0x0000, 'testTag', 'getAppProvisionInfo successfully. Data: %{public}s', JSON.stringify(data));
    }).catch(err => {
        hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed. Cause: %{public}s', err.message);
    });
} catch (err) {
    hilog.error(0x0000, 'testTag', 'getAppProvisionInfo failed. Cause: %{public}s', err.message);
}
```
W
wangtiantian 已提交
3425 3426 3427 3428 3429 3430 3431 3432 3433 3434 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 3461 3462 3463 3464 3465 3466 3467 3468 3469 3470 3471 3472 3473 3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493 3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514

### 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';
let bundleName = "com.example.myapplication";

try {
    let type = bundleManager.getSpecifiedDistributionType(bundleName);
    console.info('getSpecifiedDistributionType successfully, type:' + type);
} catch (error) {
    console.error('getSpecifiedDistributionType failed. Cause: ' + error.message);
}
```


### 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';
let bundleName = "com.example.myapplication";

try {
    let info = bundleManager.getAdditionalInfo(bundleName);
    console.info('getAdditionalInfo successfully, additionInfo:' + info);
} catch (error) {
    console.error('getAdditionalInfo failed. Cause: ' + error.message);
}
H
Handsome_Afraican_Man 已提交
3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525 3526 3527 3528 3529 3530 3531 3532 3533 3534 3535 3536 3537 3538 3539 3540 3541 3542 3543 3544 3545 3546 3547 3548
```

### 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';
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) {
    hilog.error(0x0000, 'testTag', 'getBundleInfoForSelfSync failed: %{public}s', err.message);
}
W
wangtiantian 已提交
3549
```