js-apis-Bundle.md 73.8 KB
Newer Older
1
# @ohos.bundle (Bundle模块)
S
shuaiyutao 已提交
2

X
xsz233 已提交
3
本模块提供应用信息查询能力,支持[包信息](js-apis-bundle-BundleInfo.md)[应用信息](js-apis-bundle-ApplicationInfo.md)[Ability组件信息](js-apis-bundle-AbilityInfo.md)等信息的查询,以及应用禁用状态的查询、设置等。
S
shuaiyutao 已提交
4

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

X
xsz233 已提交
10
```ts
S
shuaiyutao 已提交
11 12 13 14 15
import bundle from '@ohos.bundle';
```

## 权限列表

X
xsz233 已提交
16 17
| 权限                                         | 权限等级         | 描述            |
|--------------------------------------------|--------------|---------------|
S
shuaiyutao 已提交
18 19
| ohos.permission.CHANGE_ABILITY_ENABLED_STATE | system_basic | 设置禁用使能所需的权限。 |
| ohos.permission.GET_BUNDLE_INFO | normal | 查询指定应用信息。 |
X
add 。  
xsz233 已提交
20 21
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息。     |
| ohos.permission.INSTALL_BUNDLE             | system_core  | 可安装、卸载应用。      |
S
shuaiyutao 已提交
22
| ohos.permission.REMOVE_CACHE_FILES | system_basic | 清理应用缓存。 |
S
shuaiyutao 已提交
23

Z
zengyawen 已提交
24
权限等级参考[权限等级说明](../../security/accesstoken-overview.md#权限等级说明)
S
shuaiyutao 已提交
25

W
wanghang 已提交
26 27 28
## bundle.getApplicationInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getApplicationInfo](js-apis-bundleManager.md#bundlemanagergetapplicationinfo)替代。
S
shuaiyutao 已提交
29

qq_41863798's avatar
qq_41863798 已提交
30
getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\<ApplicationInfo>
S
shuaiyutao 已提交
31

32
以异步方法根据给定的Bundle名称获取ApplicationInfo。使用Promise异步回调。
S
shuaiyutao 已提交
33

J
junyi233 已提交
34 35
获取调用方自己的信息时不需要权限。

S
shuaiyutao 已提交
36 37
**需要权限:**

J
junyi233 已提交
38
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
S
shuaiyutao 已提交
39

40 41 42 43
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
44 45
**参数:**

J
junyi233 已提交
46
| 参数名      | 类型   | 必填 | 说明                                                         |
S
shuaiyutao 已提交
47
| ----------- | ------ | ---- | ------------------------------------------------------------ |
48
| bundleName  | string | 是   | 要查询的应用Bundle名称。                                     |
X
xsz233 已提交
49
| bundleFlags | number | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围请参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 |
S
shuaiyutao 已提交
50
| userId      | number | 否   | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。        |
S
shuaiyutao 已提交
51 52 53

**返回值:**

H
HelloCrease 已提交
54 55
| 类型                        | 说明                 |
| ------------------------- | ------------------ |
J
junyi233 已提交
56
| Promise\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | Promise形式返回应用程序信息。 |
S
shuaiyutao 已提交
57 58 59

**示例:**

X
xsz233 已提交
60
```ts
W
wanghang 已提交
61 62 63 64 65 66 67 68
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
S
shuaiyutao 已提交
69 70 71
})
```

W
wanghang 已提交
72 73 74
## bundle.getApplicationInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getApplicationInfo](js-apis-bundleManager.md#bundlemanagergetapplicationinfo)替代。
S
shuaiyutao 已提交
75 76 77

getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback\<ApplicationInfo>): void

78
以异步方法根据给定的Bundle名称获取指定用户下的ApplicationInfo,使用callback形式返回结果。
S
shuaiyutao 已提交
79

J
junyi233 已提交
80 81
获取调用方自己的信息时不需要权限。

S
shuaiyutao 已提交
82 83
**需要权限:**

J
junyi233 已提交
84
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
S
shuaiyutao 已提交
85

86 87 88 89
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
90 91
**参数:**

J
junyi233 已提交
92
| 参数名      | 类型                                                         | 必填 | 说明                                                         |
S
shuaiyutao 已提交
93
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
94
| bundleName  | string                                                       | 是   | 要查询的应用Bundle名称。                                     |
Z
zhoagan 已提交
95
| bundleFlags | number                                                       | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 |
96
| userId      | number                                                       | 是   | 用户ID。取值范围:大于等于0。                                |
S
shuaiyutao 已提交
97
| callback    | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是   | 程序启动作为入参的回调函数,返回应用程序信息。               |
S
shuaiyutao 已提交
98 99 100

**示例:**

X
xsz233 已提交
101
```ts
W
wanghang 已提交
102 103 104 105 106 107 108 109 110 111
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
let userId = 100;
bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
 })
S
shuaiyutao 已提交
112 113
```

W
wanghang 已提交
114 115 116 117
## bundle.getApplicationInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getApplicationInfo](js-apis-bundleManager.md#bundlemanagergetapplicationinfo)替代。

qq_41863798's avatar
qq_41863798 已提交
118 119 120

getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<ApplicationInfo>): void

121
以异步方法根据给定的Bundle名称获取ApplicationInfo,使用callback形式返回结果。
X
xsz233 已提交
122

J
junyi233 已提交
123 124
获取调用方自己的信息时不需要权限。

qq_41863798's avatar
qq_41863798 已提交
125 126
**需要权限:**

J
junyi233 已提交
127
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
qq_41863798's avatar
qq_41863798 已提交
128 129 130 131 132 133 134

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
135
| 参数名      | 类型                                                         | 必填 | 说明                                                         |
S
shuaiyutao 已提交
136
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
137
| bundleName  | string                                                       | 是   | 要查询的应用Bundle名称。                                     |
Z
zhoagan 已提交
138
| bundleFlags | number                                                       | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 |
S
shuaiyutao 已提交
139
| callback    | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是   | 程序启动作为入参的回调函数,返回应用程序信息。               |
qq_41863798's avatar
qq_41863798 已提交
140 141 142

**示例:**

X
xsz233 已提交
143
```ts
qq_41863798's avatar
qq_41863798 已提交
144 145 146 147 148 149 150 151 152 153 154
let bundleName = "com.example.myapplication";
let bundleFlags = 0;
bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
 })
```

155

W
wanghang 已提交
156
## bundle.getAllBundleInfo<sup>deprecated<sup>
157

W
wanghang 已提交
158
> 从API version 9开始不再维护,建议使用[bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo)替代。
S
shuaiyutao 已提交
159

J
junyi233 已提交
160
getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise\<Array\<BundleInfo\>\>
S
shuaiyutao 已提交
161

X
xsz233 已提交
162
以异步方法获取指定用户所有的BundleInfo,使用Promise形式异步回调,
S
shuaiyutao 已提交
163 164 165 166 167

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

168 169 170 171
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
172 173
**参数:**

J
junyi233 已提交
174
| 参数名     | 类型       | 必填 | 说明                                                         |
S
shuaiyutao 已提交
175
| ---------- | ---------- | ---- | ------------------------------------------------------------ |
Z
zhoagan 已提交
176
| bundleFlag | BundleFlag | 是   | 用于指定返回的包信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 |
S
shuaiyutao 已提交
177
| userId     | number     | 否   | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。        |
S
shuaiyutao 已提交
178 179 180

**返回值:**

H
HelloCrease 已提交
181 182
| 类型                          | 说明                         |
| --------------------------- | -------------------------- |
J
junyi233 已提交
183
| Promise<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | Promise形式返回所有可用的BundleInfo |
S
shuaiyutao 已提交
184 185 186

**示例:**

X
xsz233 已提交
187
```ts
W
wanghang 已提交
188 189
let bundleFlag = 0;
let userId = 100;
S
shuaiyutao 已提交
190

W
wanghang 已提交
191 192 193 194 195
bundle.getAllBundleInfo(bundleFlag, userId)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
S
shuaiyutao 已提交
196 197 198
})
```

W
wanghang 已提交
199 200 201 202
## bundle.getAllBundleInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo)替代。

S
shuaiyutao 已提交
203

J
junyi233 已提交
204
getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback\<Array\<BundleInfo\>\>): void
S
shuaiyutao 已提交
205

X
xsz233 已提交
206
以异步方法获取当前用户所有的BundleInfo,使用callback形式返回结果。
S
shuaiyutao 已提交
207 208 209 210 211

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

212 213 214 215
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
216 217
**参数:**

J
junyi233 已提交
218
| 参数名     | 类型                                                         | 必填 | 说明                                                         |
S
shuaiyutao 已提交
219
| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
Z
zhoagan 已提交
220
| bundleFlag | BundleFlag                                                   | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 |
S
shuaiyutao 已提交
221
| callback   | AsyncCallback<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回所有可用的BundleInfo。       |
S
shuaiyutao 已提交
222 223 224

**示例:**

X
xsz233 已提交
225
```ts
W
wanghang 已提交
226 227 228 229 230 231 232 233 234
let bundleFlag = 0;
bundle.getAllBundleInfo(bundleFlag, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
 })
```
S
shuaiyutao 已提交
235

W
wanghang 已提交
236 237 238 239
## bundle.getAllBundleInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getAllBundleInfo](js-apis-bundleManager.md#bundlemanagergetallbundleinfo)替代。

W
wanghang 已提交
240

J
junyi233 已提交
241
getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback\<Array\<BundleInfo\>\>): void
W
wanghang 已提交
242

X
xsz233 已提交
243
以异步方法获取系统中指定用户下所有的BundleInfo,使用callback形式返回结果。
W
wanghang 已提交
244 245 246 247 248

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

249 250 251 252
**系统能力:**

SystemCapability.BundleManager.BundleFramework

W
wanghang 已提交
253 254
**参数:**

X
xsz233 已提交
255 256
| 参数名        | 类型                                                                | 必填  | 说明                                                                  |
|------------|-------------------------------------------------------------------|-----|---------------------------------------------------------------------|
Z
zhoagan 已提交
257
| bundleFlag | BundleFlag                                                        | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 |
X
xsz233 已提交
258 259 260
| userId     | number                                                            | 是   | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。                                        |
| callback   | AsyncCallback<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回指定用户下所有包的BundleInfo。                                |
|
W
wanghang 已提交
261 262 263

**示例:**

X
xsz233 已提交
264
```ts
W
wanghang 已提交
265 266 267 268 269 270 271 272 273
let bundleFlag = 0;
let userId = 100;
bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
 })
S
shuaiyutao 已提交
274 275
```

W
wanghang 已提交
276 277 278 279
## bundle.getBundleInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)替代。

S
shuaiyutao 已提交
280

W
wanghang 已提交
281
getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise\<BundleInfo>
S
shuaiyutao 已提交
282

283
以异步方法根据给定的Bundle名称获取BundleInfo,使用Promise异步回调。
S
shuaiyutao 已提交
284

J
junyi233 已提交
285 286
获取调用方自己的信息时不需要权限。

S
shuaiyutao 已提交
287 288
**需要权限:**

J
junyi233 已提交
289
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
S
shuaiyutao 已提交
290

291 292 293 294
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
295 296
**参数:**

X
xsz233 已提交
297 298
| 参数名         | 类型            | 必填   | 说明                                                                  |
| ----------- | ------------- | ---- |---------------------------------------------------------------------|
299
| bundleName  | string        | 是    | 要查询的应用Bundle名称。                                                 |
Z
zhoagan 已提交
300 301
| bundleFlags | number        | 是    | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 |
| options     | [BundleOptions](#bundleoptionsdeprecated) | 否    | 包含userid的查询选项。                                                      |
S
shuaiyutao 已提交
302 303 304

**返回值:**

H
HelloCrease 已提交
305 306
| 类型                   | 说明                           |
| -------------------- | ---------------------------- |
307
| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | Promise对象,获取成功时返回包信息。 |
S
shuaiyutao 已提交
308 309 310

**示例:**

X
xsz233 已提交
311
```ts
W
wanghang 已提交
312 313 314
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
X
xsz233 已提交
315
    "userId": 100
W
wanghang 已提交
316 317 318 319 320 321
};
bundle.getBundleInfo(bundleName, bundleFlags, options)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
S
shuaiyutao 已提交
322 323 324
})
```

W
wanghang 已提交
325 326 327
## bundle.getBundleInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)替代。
S
shuaiyutao 已提交
328 329 330

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

331
以异步方法根据给定的Bundle名称获取BundleInfo,使用callback异步回调。
S
shuaiyutao 已提交
332

J
junyi233 已提交
333 334
获取调用方自己的信息时不需要权限。

S
shuaiyutao 已提交
335 336
**需要权限:**

J
junyi233 已提交
337
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
S
shuaiyutao 已提交
338

339 340 341 342
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
343 344
**参数:**

345 346 347
| 参数名      | 类型                                                       | 必填 | 说明                                                         |
| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| bundleName  | string                                                     | 是   | 需要查询的应用Bundle名称。                                   |
Z
zhoagan 已提交
348
| bundleFlags | number                                                     | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 |
349
| callback    | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是   | 程序启动作为入参的回调函数,返回包信息。                     |
S
shuaiyutao 已提交
350 351 352

**示例:**

X
xsz233 已提交
353
```ts
W
wanghang 已提交
354 355 356 357 358 359 360 361 362
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
S
shuaiyutao 已提交
363 364
```

W
wanghang 已提交
365 366 367
## bundle.getBundleInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo)替代。
W
wanghang 已提交
368 369 370

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

371
以异步方法根据给定的Bundle名称获取BundleInfo,使用callback异步回调。
W
wanghang 已提交
372

J
junyi233 已提交
373 374
获取调用方自己的信息时不需要权限。

W
wanghang 已提交
375 376
**需要权限:**

J
junyi233 已提交
377
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
W
wanghang 已提交
378

379 380 381 382
**系统能力:**

SystemCapability.BundleManager.BundleFramework

W
wanghang 已提交
383 384
**参数:**

J
junyi233 已提交
385
| 参数名      | 类型                                                       | 必填 | 说明                                                         |
S
shuaiyutao 已提交
386
| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
387
| bundleName  | string                                                     | 是   | 要查询的应用Bundle名称。                                     |
Z
zhoagan 已提交
388 389
| bundleFlags | number                                                     | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 |
| options     | [BundleOptions](#bundleoptionsdeprecated)                            | 是   | 包含userid。                                                 |
S
shuaiyutao 已提交
390
| callback    | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是   | 程序启动作为入参的回调函数,返回包信息。                     |
W
wanghang 已提交
391 392 393

**示例:**

X
xsz233 已提交
394
```ts
W
wanghang 已提交
395 396 397
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
X
xsz233 已提交
398
    "userId": 100
W
wanghang 已提交
399 400 401 402 403 404 405 406 407 408
};
bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

409 410


W
wanghang 已提交
411
## bundle.getBundleInstaller<sup>deprecated<sup>
412

W
wanghang 已提交
413
> 从API version 9开始不再维护,建议使用[installer.getBundleInstaller](js-apis-installer.md#bundleinstallergetbundleinstaller)替代。
J
junyi233 已提交
414 415 416

getBundleInstaller(): Promise&lt;BundleInstaller&gt;;

X
xsz233 已提交
417
获取用于安装包的接口,使用Promise异步回调,返回安装接口对象。
J
junyi233 已提交
418 419 420 421 422 423 424 425 426 427 428

**需要权限:**

ohos.permission.INSTALL_BUNDLE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

429
此接口为系统接口。
J
junyi233 已提交
430 431 432 433 434

**返回值:**

| 类型                                                         | 说明                                         |
| ------------------------------------------------------------ | -------------------------------------------- |
X
xsz233 已提交
435 436 437 438 439 440 441 442 443 444 445
| Promise<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | Promise对象,返回安装接口对象。 |

**示例:**

```ts
bundle.getBundleInstaller().then((data) => {
    console.info('getBundleInstaller successfully.');
}).catch((error) => {
    console.error('getBundleInstaller failed.');
});
```
J
junyi233 已提交
446

W
wanghang 已提交
447 448 449
## bundle.getBundleInstaller<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[installer.getBundleInstaller](js-apis-installer.md#bundleinstallergetbundleinstaller)替代。
J
junyi233 已提交
450 451 452

getBundleInstaller(callback: AsyncCallback&lt;BundleInstaller&gt;): void;

X
xsz233 已提交
453
获取用于安装包的接口,使用callback异步回调。
J
junyi233 已提交
454 455 456 457 458 459 460 461 462 463 464

**需要权限:**

ohos.permission.INSTALL_BUNDLE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

465
此接口为系统接口。
J
junyi233 已提交
466 467 468

**参数:**

J
junyi233 已提交
469
| 参数名   | 类型                                                         | 必填 | 说明             |
J
junyi233 已提交
470
| -------- | ------------------------------------------------------------ | ---- | ---------------- |
X
xsz233 已提交
471 472 473
| callback | AsyncCallback<[BundleInstaller](js-apis-bundle-BundleInstaller.md)> | 是   | 回调函数,返回安装接口对象。 |

**示例:**
J
junyi233 已提交
474

X
xsz233 已提交
475 476 477 478 479 480 481 482 483
```ts
bundle.getBundleInstaller((err, data) => {
    if (err.code == 0) {
        console.error('getBundleInstaller failed.');
    } else {
        console.info('getBundleInstaller successfully');
    }
});
```
J
junyi233 已提交
484
## bundle.cleanBundleCacheFiles<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
485 486

> 从API version 9开始不再维护,建议使用[bundleManager.cleanBundleCacheFiles](js-apis-bundleManager.md#bundlemanagercleanbundlecachefiles)替代。
J
junyi233 已提交
487 488 489

cleanBundleCacheFiles(bundleName: string, callback: AsyncCallback&lt;void&gt;): void;

X
xsz233 已提交
490
清除指定应用程序的缓存数据,使用callback异步回调。
J
junyi233 已提交
491 492 493 494 495 496 497 498 499 500 501

**需要权限:**

ohos.permission.REMOVE_CACHE_FILES

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

502
此接口为系统接口。
J
junyi233 已提交
503 504 505

**参数:**

J
junyi233 已提交
506
| 参数名      | 类型                | 必填 | 说明                                  |
J
junyi233 已提交
507
| ---------- | ------------------- | ---- | ------------------------------------- |
508
| bundleName | string              | 是   | 指示要清除其缓存数据的应用Bundle名称。 |
X
xsz233 已提交
509 510 511 512 513 514 515 516 517 518 519 520 521 522 523
| callback   | AsyncCallback\<void> | 是   | 回调函数。          |

**示例:**

```ts
let bundleName = "com.example.myapplication";

bundle.cleanBundleCacheFiles(bundleName, err => {
    if (err) {
        console.error('cleanBundleCacheFiles failed.');
    } else {
        console.info('cleanBundleCacheFiles successfully.');
    }
});
```
J
junyi233 已提交
524

J
junyi233 已提交
525
## bundle.cleanBundleCacheFiles<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
526 527

> 从API version 9开始不再维护,建议使用[bundleManager.cleanBundleCacheFiles](js-apis-bundleManager.md#bundlemanagercleanbundlecachefiles)替代。
J
junyi233 已提交
528 529 530

cleanBundleCacheFiles(bundleName: string): Promise&lt;void&gt;

X
xsz233 已提交
531
清除指定应用程序的缓存数据,使用Promise异步回调。
J
junyi233 已提交
532 533 534 535 536 537 538 539 540 541 542

**需要权限:**

ohos.permission.REMOVE_CACHE_FILES

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

543
此接口为系统接口。
J
junyi233 已提交
544 545 546

**参数:**

J
junyi233 已提交
547
| 参数名     | 类型   | 必填 | 说明                                  |
J
junyi233 已提交
548
| ---------- | ------ | ---- | ------------------------------------- |
549
| bundleName | string | 是   | 指示要清除其缓存数据的应用Bundle名称。 |
J
junyi233 已提交
550 551 552 553 554

**返回值:**

| 类型          | 说明                                 |
| ------------- | ------------------------------------ |
X
xsz233 已提交
555 556 557 558 559 560 561 562 563 564 565 566 567
| Promise\<void> | Promise对象,无返回结果的Promise对象。 |

**示例:**

```ts
let bundleName = "com.example.myapplication";

bundle.cleanBundleCacheFiles(bundleName).then(()=> {
    console.info('cleanBundleCacheFiles successfully.');
}).catch(err=> {
    console.error('cleanBundleCacheFiles failed.');
});
```
J
junyi233 已提交
568

J
junyi233 已提交
569
## bundle.setApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
570 571

> 从API version 9开始不再维护,建议使用[bundleManager.setApplicationEnabled](js-apis-bundleManager.md#bundlemanagersetapplicationenabled)替代。
J
junyi233 已提交
572 573 574

setApplicationEnabled(bundleName: string, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void;

X
xsz233 已提交
575
设置是否启用指定的应用程序,使用callback异步回调。
J
junyi233 已提交
576 577 578 579 580 581 582 583 584 585 586

**需要权限:**

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

587
此接口为系统接口。
J
junyi233 已提交
588 589 590

**参数:**

X
xsz233 已提交
591 592
| 参数名      | 类型                | 必填 | 说明                             |
| ---------- | ------------------- | ---- |--------------------------------|
593
| bundleName | string              | 是   | 指示需要启用或禁用的应用Bundle名称。          |
X
xsz233 已提交
594
| isEnable   | boolean             | 是   | 指定是否启用应用程序。true表示启用,false表示禁用。 |
X
xsz233 已提交
595
| callback   | AsyncCallback\<void> | 是   | 回调函数。                          |
X
xsz233 已提交
596 597 598 599 600 601 602 603 604 605 606 607 608 609

**示例:**

```ts
let bundleName = "com.example.myapplication";

bundle.setApplicationEnabled(bundleName, false, err => {
    if (err) {
        console.error('setApplicationEnabled failed.');
    } else {
        console.info('setApplicationEnabled successfully.');
    }
});
```
J
junyi233 已提交
610

J
junyi233 已提交
611
## bundle.setApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
612 613

> 从API version 9开始不再维护,建议使用[bundleManager.setApplicationEnabled](js-apis-bundleManager.md#bundlemanagersetapplicationenabled)替代。
J
junyi233 已提交
614 615 616

setApplicationEnabled(bundleName: string, isEnable: boolean): Promise&lt;void&gt;

X
xsz233 已提交
617
设置是否启用指定的应用程序,使用Promise异步回调。
J
junyi233 已提交
618 619 620 621 622 623 624 625 626 627 628

**需要权限:**

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

629
此接口为系统接口。
J
junyi233 已提交
630 631 632

**参数:**

633 634 635
| 参数名     | 类型    | 必填 | 说明                                            |
| ---------- | ------- | ---- | ----------------------------------------------- |
| bundleName | string  | 是   | 指示需要启用或禁用的应用Bundle名称。            |
J
junyi233 已提交
636 637 638 639 640 641
| isEnable   | boolean | 是   | 指定是否启用应用程序。true表示启用,false禁用。 |

**返回值:**

| 类型          | 说明                                 |
| ------------- | ------------------------------------ |
X
xsz233 已提交
642 643 644 645 646 647 648 649 650 651 652 653 654
| Promise\<void> | Promise对象,无返回结果的Promise对象。 |

**示例:**

```ts
let bundleName = "com.example.myapplication";

bundleManager.setApplicationEnabled(bundleName, false).then(()=> {
    console.info('setApplicationEnabled successfully.');
}).catch(err=> {
    console.error('setApplicationEnabled failed.');
});
```
J
junyi233 已提交
655

J
junyi233 已提交
656
## bundle.setAbilityEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
657 658

> 从API version 9开始不再维护,建议使用[bundleManager.setAbilityEnabled](js-apis-bundleManager.md#bundlemanagersetabilityenabled)替代。
J
junyi233 已提交
659

660
setAbilityEnabled(info: AbilityInfo, isEnable: boolean, callback: AsyncCallback&lt;void&gt;): void;
J
junyi233 已提交
661

X
xsz233 已提交
662
设置是否启用指定的Ability组件,使用callback异步回调。
J
junyi233 已提交
663 664 665 666 667 668 669 670 671 672 673

**需要权限:**

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

674
此接口为系统接口。
J
junyi233 已提交
675 676 677

**参数:**

J
junyi233 已提交
678
| 参数名   | 类型                                         | 必填 | 说明                                            |
J
junyi233 已提交
679
| -------- | -------------------------------------------- | ---- | ----------------------------------------------- |
X
xsz233 已提交
680
| info     | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是   | Ability信息,指示需要设置启用状态的Ability。                                   |
J
junyi233 已提交
681
| isEnable | boolean                                      | 是   | 指定是否启用应用程序。true表示启用,false禁用。 |
J
junyi233 已提交
682
| callback | AsyncCallback\<void>                         | 是   | 为返回操作结果而调用的回调。                    |
J
junyi233 已提交
683

J
junyi233 已提交
684
## bundle.setAbilityEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
685 686

> 从API version 9开始不再维护,建议使用[bundleManager.setAbilityEnabled](js-apis-bundleManager.md#bundlemanagersetabilityenabled)替代。
J
junyi233 已提交
687 688 689

setAbilityEnabled(info: AbilityInfo, isEnable: boolean): Promise&lt;void&gt;

X
xsz233 已提交
690
设置是否启用指定的Ability组件,使用Promise异步回调。
J
junyi233 已提交
691 692 693 694 695 696 697 698 699 700 701

**需要权限:**

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

702
此接口为系统接口。
J
junyi233 已提交
703 704 705

**参数:**

J
junyi233 已提交
706
| 参数名   | 类型                                         | 必填 | 说明                                            |
J
junyi233 已提交
707
| -------- | -------------------------------------------- | ---- | ----------------------------------------------- |
X
xsz233 已提交
708
| info     | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是   | Ability信息,指示需要设置启用状态的Ability。                                   |
J
junyi233 已提交
709 710 711 712 713 714
| isEnable | boolean                                      | 是   | 指定是否启用应用程序。true表示启用,false禁用。 |

**返回值:**

| 类型          | 说明                                 |
| ------------- | ------------------------------------ |
X
xsz233 已提交
715 716 717
| Promise\<void> | Promise对象,无返回结果的Promise对象。 |

**示例:**
J
junyi233 已提交
718

X
xsz233 已提交
719 720 721 722 723
```ts
let flag = bundle.BundleFlag.GET_ABILITY_INFO_WITH_PERMISSION;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
724
    abilityName : "EntryAbility"
X
xsz233 已提交
725 726 727 728 729 730 731 732 733 734 735 736 737 738
};

bundle.getAbilityInfo(want, flag, userId).then((abilityInfo) => {
    console.info('getAbilityInfo successfully. Data: ' + JSON.stringify(abilityInfo));

    bundle.setAbilityEnabled(abilityInfo, false).then(data => {
        console.info('setAbilityEnabled successfully.');
    }).catch(err => {
        console.error('setAbilityEnabled failed:' + JSON.stringify(err));
    })
}).catch(error => {
    console.error('getAbilityInfo failed. Cause: ' + JSON.stringify(error));
});
```
J
junyi233 已提交
739
## bundle.getPermissionDef<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
740 741

> 从API version 9开始不再维护,建议使用[bundleManager.getPermissionDef](js-apis-bundleManager.md#bundlemanagergetpermissiondef)替代。
J
junyi233 已提交
742 743 744

getPermissionDef(permissionName: string, callback: AsyncCallback&lt;PermissionDef&gt;): void;

X
xsz233 已提交
745
按权限名称获取权限的详细信息,使用callback异步回调。
J
junyi233 已提交
746 747 748 749 750 751 752 753 754 755 756

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

757
此接口为系统接口。
J
junyi233 已提交
758 759 760

**参数:**

J
junyi233 已提交
761
| 参数名         | 类型                                                         | 必填 | 说明                                             |
J
junyi233 已提交
762
| -------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------ |
X
xsz233 已提交
763
| permissionName | string                                                       | 是   | 需要查询的权限的名称。                                 |
Z
zhoagan 已提交
764
| callback       | AsyncCallback<[PermissionDef](js-apis-bundle-PermissionDef.md)> | 是   | 程序启动作为入参的回调函数,返回定义的权限信息。 |
J
junyi233 已提交
765

X
xsz233 已提交
766 767 768 769 770 771 772 773 774 775 776 777 778
**示例:**

```ts
let permission = "ohos.permission.GET_BUNDLE_INFO";
bundleManager.getPermissionDef(permission, (err, data) => {
    if (err) {
        console.error('getPermissionDef failed:' + err.message);
    } else {
        console.info('getPermissionDef successfully:' + JSON.stringify(data));
    }
});
```

J
junyi233 已提交
779
## bundle.getPermissionDef<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
780 781

> 从API version 9开始不再维护,建议使用[bundleManager.getPermissionDef](js-apis-bundleManager.md#bundlemanagergetpermissiondef)替代。
J
junyi233 已提交
782 783 784

getPermissionDef(permissionName: string): Promise&lt;PermissionDef&gt;

785
按权限名称获取权限的详细信息,使用promise异步回调。。
J
junyi233 已提交
786 787 788 789 790 791 792 793 794 795 796

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

797
此接口为系统接口。
J
junyi233 已提交
798 799 800

**参数:**

J
junyi233 已提交
801
| 参数名         | 类型   | 必填 | 说明             |
J
junyi233 已提交
802
| -------------- | ------ | ---- | ---------------- |
X
xsz233 已提交
803
| permissionName | string | 是   | 需要查询的权限的名称。 |
J
junyi233 已提交
804 805 806 807 808

**返回值:**

| 类型                                                   | 说明                                                   |
| ------------------------------------------------------ | ------------------------------------------------------ |
Z
zhaogan 已提交
809
| Promise<[PermissionDef](js-apis-bundle-PermissionDef.md)> | Promise对象,获取成功时返回权限详细信息。 |
J
junyi233 已提交
810

X
xsz233 已提交
811 812 813 814 815 816 817 818 819 820
**示例:**

```ts
let permissionName = "ohos.permission.GET_BUNDLE_INFO";
bundle.getPermissionDef(permissionName).then((data) => {
    console.info('getPermissionDef successfully. Data: ' + JSON.stringify(data));
}).catch(error => {
    console.error('getPermissionDef failed. Cause: ' + error.message);
});
```
J
junyi233 已提交
821

W
wanghang 已提交
822
## bundle.getAllApplicationInfo<sup>deprecated<sup>
S
shuaiyutao 已提交
823

W
wanghang 已提交
824
> 从API version 9开始不再维护,建议使用[bundleManager.getAllApplicationInfo](js-apis-bundleManager.md#bundlemanagergetallapplicationinfo)替代。
S
shuaiyutao 已提交
825

J
junyi233 已提交
826
getAllApplicationInfo(bundleFlags: number, userId?: number): Promise\<Array\<ApplicationInfo\>\>
S
shuaiyutao 已提交
827

X
xsz233 已提交
828
获取指定用户下所有已安装的应用信息,使用promise异步回调。
S
shuaiyutao 已提交
829 830 831

**需要权限:**

W
wanghang 已提交
832
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
S
shuaiyutao 已提交
833

834 835 836 837
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
838 839
**参数:**

J
junyi233 已提交
840
| 参数名      | 类型   | 必填 | 说明                                                         |
S
shuaiyutao 已提交
841
| ----------- | ------ | ---- | ------------------------------------------------------------ |
Z
zhoagan 已提交
842
| bundleFlags | number | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 |
S
shuaiyutao 已提交
843
| userId      | number | 否   | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。        |
S
shuaiyutao 已提交
844 845 846

**返回值:**

H
HelloCrease 已提交
847 848
| 类型                               | 说明                              |
| -------------------------------- | ------------------------------- |
849
| Promise<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | Promise对象,获取成功时返回应用信息列表。 |
S
shuaiyutao 已提交
850 851 852

**示例:**

X
xsz233 已提交
853
```ts
W
wanghang 已提交
854 855 856 857 858 859 860
let bundleFlags = 8;
let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
S
shuaiyutao 已提交
861 862 863
})
```

W
wanghang 已提交
864
## bundle.getAllApplicationInfo<sup>deprecated<sup>
S
shuaiyutao 已提交
865

W
wanghang 已提交
866
> 从API version 9开始不再维护,建议使用[bundleManager.getAllApplicationInfo](js-apis-bundleManager.md#bundlemanagergetallapplicationinfo)替代。
S
shuaiyutao 已提交
867

J
junyi233 已提交
868
getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback\<Array\<ApplicationInfo\>\>): void
S
shuaiyutao 已提交
869

870
获取指定用户下所有已安装的应用信息,使用callback异步回调。
S
shuaiyutao 已提交
871 872 873

**需要权限:**

W
wanghang 已提交
874
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
S
shuaiyutao 已提交
875

876 877 878 879
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
880 881
**参数:**

J
junyi233 已提交
882
| 参数名      | 类型                                                         | 必填 | 说明                                                         |
S
shuaiyutao 已提交
883
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
Z
zhoagan 已提交
884
| bundleFlags | number                                                       | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 |
J
junyi233 已提交
885
| userId      | number                                                       | 是   | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。        |
S
shuaiyutao 已提交
886
| callback    | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回应用信息列表。               |
S
shuaiyutao 已提交
887 888 889

**示例:**

X
xsz233 已提交
890
```ts
X
xsz233 已提交
891
let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
W
wanghang 已提交
892 893 894 895 896 897 898 899
let userId = 100;
bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
S
shuaiyutao 已提交
900 901 902
```


W
wanghang 已提交
903 904 905
## bundle.getAllApplicationInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getAllApplicationInfo](js-apis-bundleManager.md#bundlemanagergetallapplicationinfo)替代。
qq_41863798's avatar
qq_41863798 已提交
906

qq_41863798's avatar
qq_41863798 已提交
907
getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback<Array\<ApplicationInfo>>) : void;
qq_41863798's avatar
qq_41863798 已提交
908

J
junyi233 已提交
909
获取调用方所在用户下已安装的应用信息,使用callback异步回调。
qq_41863798's avatar
qq_41863798 已提交
910 911 912 913 914 915 916 917 918 919 920

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
921
| 参数名      | 类型                                                         | 必填 | 说明                                                         |
S
shuaiyutao 已提交
922
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
Z
zhoagan 已提交
923
| bundleFlags | number                                                       | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 |
S
shuaiyutao 已提交
924
| callback    | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回应用信息列表。               |
qq_41863798's avatar
qq_41863798 已提交
925 926 927

**示例:**

X
xsz233 已提交
928
```ts
X
xsz233 已提交
929
let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
qq_41863798's avatar
qq_41863798 已提交
930 931 932 933 934 935 936 937 938
bundle.getAllApplicationInfo(bundleFlags, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

W
wanghang 已提交
939 940 941
## bundle.getBundleArchiveInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getBundleArchiveInfo](js-apis-bundleManager.md#bundlemanagergetbundlearchiveinfo)替代。
W
wanghang 已提交
942

943
getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise\<BundleInfo>
W
wanghang 已提交
944

945
获取有关HAP中包含的应用程序包的信息,使用Promise形式返回结果。
W
wanghang 已提交
946 947 948 949 950 951 952

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
953
| 参数名        | 类型     | 必填   | 说明           |
W
wanghang 已提交
954
| ---------- | ------ | ---- | ------------ |
X
xsz233 已提交
955
| hapFilePath | string | 是    | HAP存放路径。支持当前应用程序的绝对路径和数据目录沙箱路径。 |
Z
zhoagan 已提交
956
| bundleFlags | number | 是    | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 |
W
wanghang 已提交
957 958

**返回值:**
959 960 961
| 类型                                                 | 说明                                                         |
| ---------------------------------------------------- | ------------------------------------------------------------ |
| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 返回值为Promise对象,Promise中包含有关HAP中包含的应用程序的信息。 |
W
wanghang 已提交
962 963 964

**示例:**

X
xsz233 已提交
965
```ts
X
xsz233 已提交
966
let hapFilePath = "/data/storage/el2/base/test.hap";
W
wanghang 已提交
967 968 969 970 971 972 973 974 975
let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
```

W
wanghang 已提交
976 977 978
## bundle.getBundleArchiveInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getBundleArchiveInfo](js-apis-bundleManager.md#bundlemanagergetbundlearchiveinfo)替代。
W
wanghang 已提交
979

980
getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback\<BundleInfo>) : void
W
wanghang 已提交
981

982
以异步方法获取有关HAP中包含的应用程序包的信息,使用callback形式返回结果。
W
wanghang 已提交
983 984 985 986 987 988 989

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
990
| 参数名        | 类型     | 必填   | 说明           |
W
wanghang 已提交
991
| ---------- | ------ | ---- | ------------ |
X
xsz233 已提交
992
| hapFilePath | string | 是    | HAP存放路径,支持当前应用程序的绝对路径和数据目录沙箱路径。 |
Z
zhoagan 已提交
993
| bundleFlags | number | 是    | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 |
994
| callback| AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是    | 程序启动作为入参的回调函数,返回HAP中包含的应用程序包的信息。 |
W
wanghang 已提交
995 996 997

**示例:**

X
xsz233 已提交
998
```ts
X
xsz233 已提交
999
let hapFilePath = "/data/storage/el2/base/test.hap";
W
wanghang 已提交
1000 1001 1002 1003 1004 1005 1006 1007 1008 1009
let bundleFlags = 0;
bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

W
wanghang 已提交
1010 1011 1012
## bundle.getAbilityInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)替代。
qq_41863798's avatar
qq_41863798 已提交
1013

D
dy 已提交
1014
getAbilityInfo(bundleName: string, abilityName: string): Promise\<AbilityInfo>
qq_41863798's avatar
qq_41863798 已提交
1015

1016
通过Bundle名称和组件名获取Ability组件信息,使用Promise形式异步回调。
D
dy 已提交
1017

J
junyi233 已提交
1018 1019
获取调用方自己的信息时不需要权限。

D
dy 已提交
1020 1021
**需要权限:**

J
junyi233 已提交
1022
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
D
dy 已提交
1023 1024 1025 1026 1027 1028 1029

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

X
xsz233 已提交
1030 1031
| 参数名         | 类型     | 必填   | 说明         |
| ----------- | ------ | ---- |------------|
1032
| bundleName  | string | 是    | 应用Bundle名称。 |
X
xsz233 已提交
1033
| abilityName | string | 是    | Ability组件名称。 |
D
dy 已提交
1034 1035 1036

**返回值:**

H
HelloCrease 已提交
1037 1038
| 类型                    | 说明                    |
| --------------------- | --------------------- |
J
junyi233 已提交
1039
| Promise\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | Promise形式返回Ability信息。 |
D
dy 已提交
1040 1041 1042

**示例:**

X
xsz233 已提交
1043
```ts
D
dy 已提交
1044
let bundleName = "com.example.myapplication";
1045
let abilityName = "EntryAbility";
D
dy 已提交
1046 1047 1048 1049 1050 1051 1052 1053
bundle.getAbilityInfo(bundleName, abilityName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
```

W
wanghang 已提交
1054 1055 1056
## bundle.getAbilityInfo<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)替代。
D
dy 已提交
1057

qq_41863798's avatar
qq_41863798 已提交
1058
getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback\<AbilityInfo>): void;
D
dy 已提交
1059

1060
通过Bundle名称和组件名获取Ability组件信息,使用callback形式返回结果。
D
dy 已提交
1061

J
junyi233 已提交
1062 1063
获取调用方自己的信息时不需要权限。

D
dy 已提交
1064 1065
**需要权限:**

J
junyi233 已提交
1066
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
D
dy 已提交
1067 1068 1069 1070 1071 1072 1073

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

X
xsz233 已提交
1074 1075
| 参数名        | 类型     | 必填   | 说明                         |
| ----------- | ------------ | ---- |----------------------------|
1076
| bundleName  | string | 是    | 应用Bundle名称。                |
X
xsz233 已提交
1077
| abilityName | string | 是    | Ability名称。                 |
J
junyi233 已提交
1078
| callback    | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是    | 程序启动作为入参的回调函数,返回Ability信息。 |
D
dy 已提交
1079 1080 1081

**示例:**

X
xsz233 已提交
1082
```ts
D
dy 已提交
1083
let bundleName = "com.example.myapplication";
1084
let abilityName = "EntryAbility";
D
dy 已提交
1085 1086 1087 1088 1089 1090 1091 1092
bundle.getAbilityInfo(bundleName, abilityName, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
```
1093

J
junyi233 已提交
1094
## bundle.getAbilityLabel<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1095 1096 1097 1098

> 从API version 9开始不再维护,建议使用[bundleManager.getAbilityLabel](js-apis-bundleManager.md#bundlemanagergetabilitylabel)替代。

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

1100
通过Bundle名称和ability名称获取应用名称,使用Promise形式返回结果。
D
dy 已提交
1101

J
junyi233 已提交
1102 1103
获取调用方自己的信息时不需要权限。

D
dy 已提交
1104 1105
**需要权限:**

J
junyi233 已提交
1106
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
D
dy 已提交
1107 1108 1109 1110 1111 1112 1113

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

1114 1115 1116 1117
| 参数名      | 类型   | 必填 | 说明             |
| ----------- | ------ | ---- | ---------------- |
| bundleName  | string | 是   | 应用Bundle名称。 |
| abilityName | string | 是   | Ability名称。    |
D
dy 已提交
1118 1119 1120

**返回值:**

H
HelloCrease 已提交
1121 1122
| 类型               | 说明                 |
| ---------------- | ------------------ |
D
dy 已提交
1123 1124 1125 1126
| Promise\<string> | Promise形式返回应用名称信息。 |

**示例:**

X
xsz233 已提交
1127
```ts
D
dy 已提交
1128
let bundleName = "com.example.myapplication";
1129
let abilityName = "EntryAbility";
D
dy 已提交
1130 1131 1132 1133 1134 1135 1136 1137
bundle.getAbilityLabel(bundleName, abilityName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
```

J
junyi233 已提交
1138
## bundle.getAbilityLabel<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1139 1140

> 从API version 9开始不再维护,建议使用[bundleManager.getAbilityLabel](js-apis-bundleManager.md#bundlemanagergetabilitylabel)替代。
D
dy 已提交
1141 1142 1143

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

1144
通过Bundle名称和Ability组件名获取应用名称,使用callback形式返回结果。
D
dy 已提交
1145

J
junyi233 已提交
1146 1147
获取调用方自己的信息时不需要权限。

D
dy 已提交
1148 1149
**需要权限:**

J
junyi233 已提交
1150
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
D
dy 已提交
1151 1152 1153 1154 1155 1156 1157

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

1158 1159 1160 1161
| 参数名      | 类型                   | 必填 | 说明                                           |
| ----------- | ---------------------- | ---- | ---------------------------------------------- |
| bundleName  | string                 | 是   | 应用Bundle名称。                               |
| abilityName | string                 | 是   | Ability名称。                                  |
X
xsz233 已提交
1162
| callback    | AsyncCallback\<string> | 是   | 程序启动作为入参的回调函数,返回应用名称信息。 |
D
dy 已提交
1163 1164 1165

**示例:**

X
xsz233 已提交
1166
```ts
D
dy 已提交
1167
let bundleName = "com.example.myapplication";
1168
let abilityName = "EntryAbility";
D
dy 已提交
1169 1170 1171 1172 1173 1174 1175 1176
bundle.getAbilityLabel(bundleName, abilityName, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
```
1177

J
junyi233 已提交
1178
## bundle.isAbilityEnabled<sup>8+</sup> <sup>deprecated<sup>
1179

W
wanghang 已提交
1180
> 从API version 9开始不再维护,建议使用[bundleManager.isAbilityEnabled](js-apis-bundleManager.md#bundlemanagerisabilityenabled)替代。
D
dy 已提交
1181 1182 1183

isAbilityEnabled(info: AbilityInfo): Promise\<boolean>

1184
以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用Promise形式返回结果。
D
dy 已提交
1185 1186 1187 1188 1189 1190 1191

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
1192 1193
| 参数名 | 类型                                         | 必填 | 说明              |
| ------ | -------------------------------------------- | ---- | ----------------- |
X
add 。  
xsz233 已提交
1194
| info   | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是   | Ability的配置信息。 |
D
dy 已提交
1195 1196 1197

**返回值:**

H
HelloCrease 已提交
1198 1199
| 类型                | 说明                        |
| ----------------- | ------------------------- |
D
dy 已提交
1200 1201 1202 1203
| Promise\<boolean> | Promise形式返回boolean代表是否启用。 |

**示例:**

X
xsz233 已提交
1204
```ts
W
wanghang 已提交
1205
let bundleName = "com.example.myapplication";
1206
let abilityName = "EntryAbility";
W
wanghang 已提交
1207 1208 1209 1210 1211 1212
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
    bundle.isAbilityEnabled(abilityInfo).then((data) => {
        console.info('Operation successful. Data: ' + JSON.stringify(data));
    }).catch((error) => {
        console.error('Operation failed. Cause: ' + JSON.stringify(error));
    })
D
dy 已提交
1213 1214 1215
})
```

J
junyi233 已提交
1216
## bundle.isAbilityEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1217 1218

> 从API version 9开始不再维护,建议使用[bundleManager.isAbilityEnabled](js-apis-bundleManager.md#bundlemanagerisabilityenabled)替代。
D
dy 已提交
1219 1220 1221

isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback\<boolean>): void

1222
以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用callback形式返回结果。
D
dy 已提交
1223 1224 1225 1226 1227 1228 1229

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
1230 1231
| 参数名   | 类型                                         | 必填 | 说明                    |
| -------- | -------------------------------------------- | ---- | ----------------------- |
X
add 。  
xsz233 已提交
1232
| info     | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是   | Ability的配置信息。       |
S
shuaiyutao 已提交
1233
| callback | AsyncCallback\<boolean>                      | 是   | 回调函数,返回boolean代表是否启用。 |
D
dy 已提交
1234 1235 1236

**示例:**

X
xsz233 已提交
1237
```ts
W
wanghang 已提交
1238
let bundleName = "com.example.myapplication";
1239
let abilityName = "EntryAbility";
W
wanghang 已提交
1240 1241
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
    bundle.isAbilityEnabled(abilityInfo, (err, data) => {
D
dy 已提交
1242 1243 1244 1245 1246
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
W
wanghang 已提交
1247
    })
D
dy 已提交
1248 1249 1250
})
```

J
junyi233 已提交
1251
## bundle.isApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1252 1253

> 从API version 9开始不再维护,建议使用[bundleManager.isApplicationEnabled](js-apis-bundleManager.md#bundlemanagerisapplicationenabled)替代。
D
dy 已提交
1254 1255 1256

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

1257
以异步方法根据给定的bundleName查询指定应用程序是否已经启用,使用Promise形式返回结果。
D
dy 已提交
1258 1259 1260 1261 1262 1263 1264

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
1265 1266
| 参数名     | 类型   | 必填 | 说明                     |
| ---------- | ------ | ---- | ------------------------ |
1267
| bundleName | string | 是   | 要查询的应用Bundle名称。 |
D
dy 已提交
1268 1269 1270

**返回值:**

H
HelloCrease 已提交
1271 1272
| 类型                | 说明                        |
| ----------------- | ------------------------- |
D
dy 已提交
1273 1274 1275 1276
| Promise\<boolean> | Promise形式返回boolean代表是否启用。 |

**示例:**

X
xsz233 已提交
1277
```ts
qq_41863798's avatar
api 9  
qq_41863798 已提交
1278 1279
let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName)
D
dy 已提交
1280 1281 1282 1283 1284 1285 1286
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
```

J
junyi233 已提交
1287
## bundle.isApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1288 1289

> 从API version 9开始不再维护,建议使用[bundleManager.isApplicationEnabled](js-apis-bundleManager.md#bundlemanagerisapplicationenabled)替代。
D
dy 已提交
1290 1291 1292

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

1293
以异步方法根据给定的bundleName查询指定应用程序是否已经启用,使用callback形式返回结果。
D
dy 已提交
1294 1295 1296 1297 1298 1299 1300

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
1301 1302
| 参数名     | 类型                    | 必填 | 说明                     |
| ---------- | ----------------------- | ---- | ------------------------ |
1303
| bundleName | string                  | 是   | 要查询的应用Bundle名称。 |
S
shuaiyutao 已提交
1304
| callback   | AsyncCallback\<boolean> | 是   | 回调函数,返回boolean代表是否启用。 |
D
dy 已提交
1305 1306 1307

**示例:**

X
xsz233 已提交
1308
```ts
H
HelloCrease 已提交
1309
let bundleName = "com.example.myapplication";
D
dy 已提交
1310 1311 1312 1313 1314 1315 1316 1317
bundle.isApplicationEnabled(bundleName, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
```
S
shuaiyutao 已提交
1318

W
wanghang 已提交
1319 1320 1321
## bundle.queryAbilityByWant<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)替代。
S
shuaiyutao 已提交
1322

J
junyi233 已提交
1323
queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise\<Array\<AbilityInfo\>\>
S
shuaiyutao 已提交
1324

X
xsz233 已提交
1325
以异步方法根据给定的意图获取Ability组件信息,使用Promise形式返回结果。
S
shuaiyutao 已提交
1326

J
junyi233 已提交
1327 1328
获取调用方自己的信息时不需要权限。

S
shuaiyutao 已提交
1329 1330
**需要权限:**

J
junyi233 已提交
1331
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
S
shuaiyutao 已提交
1332

1333 1334 1335 1336
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1337 1338
**参数:**

J
junyi233 已提交
1339
| 参数名         | 类型     | 必填   | 说明                                    |
H
HelloCrease 已提交
1340
| ----------- | ------ | ---- | ------------------------------------- |
1341
| want        | [Want](js-apis-application-want.md)   | 是    | 包含要查询的应用Bundle名称的意图。                  |
Z
zhoagan 已提交
1342
| bundleFlags | number | 是    | 用于指定返回abilityInfo信息。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中Ability信息相关flag。 |
X
xsz233 已提交
1343
| userId      | number | 否    | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。           |
S
shuaiyutao 已提交
1344 1345 1346

**返回值:**

H
HelloCrease 已提交
1347 1348
| 类型                           | 说明                    |
| ---------------------------- | --------------------- |
J
junyi233 已提交
1349
| Promise<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | Promise形式返回Ability信息。 |
S
shuaiyutao 已提交
1350 1351 1352

**示例:**

X
xsz233 已提交
1353
```ts
W
wanghang 已提交
1354 1355 1356 1357
let bundleFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1358
    abilityName : "EntryAbility"
W
wanghang 已提交
1359 1360 1361 1362 1363 1364
};
bundle.queryAbilityByWant(want, bundleFlags, userId)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
S
shuaiyutao 已提交
1365 1366 1367 1368 1369
})
```



W
wanghang 已提交
1370 1371 1372
## bundle.queryAbilityByWant<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)替代。
S
shuaiyutao 已提交
1373

J
junyi233 已提交
1374
queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: AsyncCallback\<Array\<AbilityInfo\>\>): void
S
shuaiyutao 已提交
1375

1376
以异步方法根据给定的意图获取指定用户下Ability信息,使用callback形式返回结果。
S
shuaiyutao 已提交
1377

J
junyi233 已提交
1378 1379
获取调用方自己的信息时不需要权限。

J
junyi233 已提交
1380 1381 1382 1383
**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

X
xuezhongzhu 已提交
1384 1385 1386 1387
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1388 1389
**参数:**

1390 1391 1392
| 参数名      | 类型                                                         | 必填 | 说明                                                         |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want        | [Want](js-apis-application-want.md)                          | 是   | 指示包含要查询的应用Bundle名称的意图。                       |
Z
zhoagan 已提交
1393
| bundleFlags | number                                                       | 是   | 用于指定返回abilityInfo信息。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中Ability信息相关flag。 |
1394 1395
| userId      | number                                                       | 是   | 用户ID。取值范围:大于等于0。                                |
| callback    | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回Ability信息。                |
S
shuaiyutao 已提交
1396 1397 1398

**示例:**

X
xsz233 已提交
1399
```ts
W
wanghang 已提交
1400 1401 1402 1403
let bundleFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
1404
    abilityName : "EntryAbility"
W
wanghang 已提交
1405 1406 1407 1408 1409 1410 1411 1412
};
bundle.queryAbilityByWant(want, bundleFlags, userId, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
S
shuaiyutao 已提交
1413 1414
```

W
wanghang 已提交
1415 1416 1417
## bundle.queryAbilityByWant<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)替代。
S
shuaiyutao 已提交
1418

J
junyi233 已提交
1419
queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback\<Array\<AbilityInfo\>\>): void;
S
shuaiyutao 已提交
1420 1421 1422

以异步方法根据给定的意图获取Ability信息,使用callback形式返回结果。

J
junyi233 已提交
1423 1424
获取调用方自己的信息时不需要权限。

J
junyi233 已提交
1425 1426 1427 1428
**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO

X
xuezhongzhu 已提交
1429 1430 1431 1432
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1433 1434
**参数:**

1435 1436 1437
| 参数名      | 类型                                                         | 必填 | 说明                                                         |
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
| want        | [Want](js-apis-application-want.md)                          | 是   | 指示包含要查询的应用Bundle名称的意图。                       |
Z
zhoagan 已提交
1438
| bundleFlags | number                                                       | 是   | 用于指定返回abilityInfo信息。取值范围:参考[BundleFlag说明](#bundleflagdeprecated)中Ability信息相关flag。 |
1439
| callback    | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回Ability信息。                |
S
shuaiyutao 已提交
1440 1441 1442

**示例:**

X
xsz233 已提交
1443
```ts
W
wanghang 已提交
1444 1445 1446
let bundleFlags = 0;
let want = {
    bundleName : "com.example.myapplication",
1447
    abilityName : "EntryAbility"
W
wanghang 已提交
1448 1449 1450 1451 1452 1453 1454 1455
};
bundle.queryAbilityByWant(want, bundleFlags, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
S
shuaiyutao 已提交
1456 1457 1458 1459
```



W
wanghang 已提交
1460 1461 1462
## bundle.getLaunchWantForBundle<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getLaunchWantForBundle](js-apis-bundleManager.md#bundlemanagergetlaunchwantforbundle)替代。
S
shuaiyutao 已提交
1463

W
wanghang 已提交
1464 1465 1466
getLaunchWantForBundle(bundleName: string): Promise\<Want>

以异步方法查询拉起指定应用的want对象,使用Promise形式返回结果。
S
shuaiyutao 已提交
1467

W
wanghang 已提交
1468 1469 1470 1471
**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

1472 1473 1474 1475
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1476 1477
**参数:**

J
junyi233 已提交
1478 1479
| 参数名     | 类型   | 必填 | 说明                     |
| ---------- | ------ | ---- | ------------------------ |
1480
| bundleName | string | 是   | 要查询的应用Bundle名称。 |
S
shuaiyutao 已提交
1481 1482

**返回值:**
H
HelloCrease 已提交
1483 1484
| 类型             | 说明                                     |
| -------------- | -------------------------------------- |
1485
| Promise\<[Want](js-apis-application-want.md)> | 返回值为Promise对象,Promise中包含拉起指定应用的Want对象。 |
S
shuaiyutao 已提交
1486 1487 1488

**示例:**

X
xsz233 已提交
1489
```ts
W
wanghang 已提交
1490 1491 1492 1493 1494 1495 1496
let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
S
shuaiyutao 已提交
1497 1498
```

W
wanghang 已提交
1499 1500 1501
## bundle.getLaunchWantForBundle<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.getLaunchWantForBundle](js-apis-bundleManager.md#bundlemanagergetlaunchwantforbundle)替代。
S
shuaiyutao 已提交
1502

qq_41863798's avatar
api 9  
qq_41863798 已提交
1503
getLaunchWantForBundle(bundleName: string, callback: AsyncCallback\<Want>): void;
S
shuaiyutao 已提交
1504

W
wanghang 已提交
1505
以异步方法查询拉起指定应用的want对象,使用callback形式返回结果。
S
shuaiyutao 已提交
1506

W
wanghang 已提交
1507 1508 1509 1510
**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

1511 1512 1513 1514
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1515 1516
**参数:**

J
junyi233 已提交
1517 1518
| 参数名     | 类型                                                | 必填 | 说明                                                     |
| ---------- | --------------------------------------------------- | ---- | -------------------------------------------------------- |
1519
| bundleName | string                                              | 是   | 要查询的应用Bundle名称。                                 |
1520
| callback   | AsyncCallback\<[Want](js-apis-application-want.md)> | 是   | 程序启动作为入参的回调函数,返回拉起指定应用的want对象。 |
S
shuaiyutao 已提交
1521 1522 1523

**示例:**

X
xsz233 已提交
1524
```ts
W
wanghang 已提交
1525 1526 1527 1528 1529 1530 1531 1532
let bundleName = "com.example.myapplication";
bundle.getLaunchWantForBundle(bundleName, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
S
shuaiyutao 已提交
1533 1534 1535
```


J
junyi233 已提交
1536
## bundle.getNameForUid<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1537 1538

> 从API version 9开始不再维护,建议使用[bundleManager.getBundleNameByUid](js-apis-bundleManager.md#bundlemanagergetbundlenamebyuid)替代。
W
wanghang 已提交
1539 1540

getNameForUid(uid: number): Promise\<string>
S
shuaiyutao 已提交
1541

1542
以异步方法通过uid获取对应的Bundle名称,使用Promise形式返回结果。
S
shuaiyutao 已提交
1543

X
xuezhongzhu 已提交
1544 1545 1546 1547
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1548 1549
**参数:**

J
junyi233 已提交
1550 1551 1552
| 参数名 | 类型   | 必填 | 说明          |
| ------ | ------ | ---- | ------------- |
| uid    | number | 是   | 要查询的uid。 |
S
shuaiyutao 已提交
1553 1554

**返回值:**
H
HelloCrease 已提交
1555 1556
| 类型               | 说明                                |
| ---------------- | --------------------------------- |
1557
| Promise\<string> | 返回值为Promise对象,Promise中包含指定uid的Bundle名称。 |
S
shuaiyutao 已提交
1558 1559 1560

**示例:**

X
xsz233 已提交
1561
```ts
W
wanghang 已提交
1562 1563 1564 1565 1566 1567 1568
let uid = 20010005;
bundle.getNameForUid(uid)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
S
shuaiyutao 已提交
1569 1570
```

J
junyi233 已提交
1571
## bundle.getNameForUid<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1572 1573

> 从API version 9开始不再维护,建议使用[bundleManager.getBundleNameByUid](js-apis-bundleManager.md#bundlemanagergetbundlenamebyuid)替代。
S
shuaiyutao 已提交
1574

qq_41863798's avatar
qq_41863798 已提交
1575
getNameForUid(uid: number, callback: AsyncCallback\<string>) : void
S
shuaiyutao 已提交
1576

1577
以异步方法通过uid获取对应的Bundle名称,使用callback形式返回结果。
S
shuaiyutao 已提交
1578

X
xuezhongzhu 已提交
1579 1580 1581 1582
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1583 1584
**参数:**

1585 1586 1587 1588
| 参数名   | 类型                   | 必填 | 说明                                                  |
| -------- | ---------------------- | ---- | ----------------------------------------------------- |
| uid      | number                 | 是   | 要查询的uid。                                         |
| callback | AsyncCallback\<string> | 是   | 程序启动作为入参的回调函数,返回指定uid的Bundle名称。 |
S
shuaiyutao 已提交
1589 1590 1591

**示例:**

X
xsz233 已提交
1592
```ts
W
wanghang 已提交
1593 1594 1595 1596 1597 1598 1599 1600
let uid = 20010005;
bundle.getNameForUid(uid, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
S
shuaiyutao 已提交
1601 1602
```

qq_41863798's avatar
qq_41863798 已提交
1603

J
junyi233 已提交
1604
## bundle.getAbilityIcon<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1605

W
wangtiantian 已提交
1606
> 从API version 9开始不再维护,建议使用[resourceManager.getMediaContent](js-apis-resource-manager.md#getmediacontent9)替代。
qq_41863798's avatar
qq_41863798 已提交
1607

qq_41863798's avatar
qq_41863798 已提交
1608
getAbilityIcon(bundleName: string, abilityName: string): Promise\<image.PixelMap>;
qq_41863798's avatar
qq_41863798 已提交
1609

1610
以异步方法通过bundleName和abilityName获取对应Icon的[PixelMap](js-apis-image.md),使用Promise形式返回结果。
qq_41863798's avatar
qq_41863798 已提交
1611

J
junyi233 已提交
1612 1613
获取调用方自己的信息时不需要权限。

qq_41863798's avatar
qq_41863798 已提交
1614 1615
**需要权限:**

J
junyi233 已提交
1616
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
qq_41863798's avatar
qq_41863798 已提交
1617 1618 1619 1620 1621

**系统能力:**

SystemCapability.BundleManager.BundleFramework

qq_41863798's avatar
qq_41863798 已提交
1622 1623
**参数:**

1624 1625 1626 1627
| 参数名      | 类型   | 必填 | 说明                     |
| ----------- | ------ | ---- | ------------------------ |
| bundleName  | string | 是   | 要查询的应用Bundle名称。 |
| abilityName | string | 是   | 要查询的Ability组件名。  |
qq_41863798's avatar
qq_41863798 已提交
1628 1629 1630 1631

**返回值:**
| 类型                  | 说明                                                         |
| --------------------- | ------------------------------------------------------------ |
1632
| Promise\<image.PixelMap> | 返回值为[PixelMap](js-apis-image.md)。 |
qq_41863798's avatar
qq_41863798 已提交
1633 1634 1635

**示例:**

X
xsz233 已提交
1636
```ts
1637
let bundleName = "com.example.myapplication";
1638
let abilityName = "EntryAbility";
qq_41863798's avatar
qq_41863798 已提交
1639 1640 1641 1642 1643 1644 1645 1646
bundle.getAbilityIcon(bundleName, abilityName)
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
```

J
junyi233 已提交
1647
## bundle.getAbilityIcon<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1648

W
wangtiantian 已提交
1649
> 从API version 9开始不再维护,建议使用[resourceManager.getMediaContent](js-apis-resource-manager.md#getmediacontent9)替代。
qq_41863798's avatar
qq_41863798 已提交
1650

qq_41863798's avatar
qq_41863798 已提交
1651
getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback\<image.PixelMap>): void;
qq_41863798's avatar
qq_41863798 已提交
1652

1653
以异步方法通过bundleName和abilityName获取对应Icon的[PixelMap](js-apis-image.md),使用callback形式返回结果。
qq_41863798's avatar
qq_41863798 已提交
1654

J
junyi233 已提交
1655 1656
获取调用方自己的信息时不需要权限。

qq_41863798's avatar
qq_41863798 已提交
1657 1658
**需要权限:**

J
junyi233 已提交
1659
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1660

qq_41863798's avatar
qq_41863798 已提交
1661 1662 1663 1664 1665

**系统能力:**

SystemCapability.BundleManager.BundleFramework

qq_41863798's avatar
qq_41863798 已提交
1666 1667
**参数:**

X
xsz233 已提交
1668 1669
| 参数名         | 类型                                       | 必填   | 说明                                              |
| ----------- | ---------------------------------------- | ---- |-------------------------------------------------|
1670
| bundleName  | string                                   | 是    | 要查询的应用Bundle名称。                                |
X
xsz233 已提交
1671
| abilityName | string                                   | 是    | 要查询的Ability组件名。                                 |
1672
| callback   | AsyncCallback\<image.PixelMap> | 是   | 程序启动作为入参的回调函数,返回指定[PixelMap](js-apis-image.md)。 |
qq_41863798's avatar
qq_41863798 已提交
1673 1674 1675

**示例:**

X
xsz233 已提交
1676
```ts
1677
let bundleName = "com.example.myapplication";
1678
let abilityName = "EntryAbility";
qq_41863798's avatar
qq_41863798 已提交
1679 1680 1681 1682 1683 1684 1685 1686 1687
bundle.getAbilityIcon(bundleName, abilityName, (err, data) => {
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
})
```

W
wanghang 已提交
1688 1689
## InstallErrorCode<sup>deprecated<sup>
> 从API version 9开始不再维护,不推荐使用。
S
shuaiyutao 已提交
1690

qq_41863798's avatar
api 9  
qq_41863798 已提交
1691
 **系统能力:** SystemCapability.BundleManager.BundleFramework
X
xuezhongzhu 已提交
1692

J
junyi233 已提交
1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714
| 名称                                                 | 值   | 说明                                             |
| ---------------------------------------------------- | ---- | ------------------------------------------------ |
| SUCCESS                                              | 0    | 安装成功                                         |
| STATUS_INSTALL_FAILURE                               | 1    | 安装失败(不存在安装的应用)                     |
| STATUS_INSTALL_FAILURE_ABORTED                       | 2    | 安装中止                                         |
| STATUS_INSTALL_FAILURE_INVALID                       | 3    | 安装参数无效                                     |
| STATUS_INSTALL_FAILURE_CONFLICT                      | 4    | 安装冲突 (常见于升级和已有应用基本信息不一致)  |
| STATUS_INSTALL_FAILURE_STORAGE                       | 5    | 存储包信息失败                                   |
| STATUS_INSTALL_FAILURE_INCOMPATIBLE                  | 6    | 安装不兼容(常见于版本降级安装或者签名信息错误) |
| STATUS_UNINSTALL_FAILURE                             | 7    | 卸载失败 (不存在卸载的应用)                    |
| STATUS_UNINSTALL_FAILURE_BLOCKED                     | 8    | 卸载中止 (没有使用)                            |
| STATUS_UNINSTALL_FAILURE_ABORTED                     | 9    | 卸载中止 (参数无效导致)                        |
| STATUS_UNINSTALL_FAILURE_CONFLICT                    | 10   | 卸载冲突 (卸载系统应用失败, 结束应用进程失败) |
| STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT              | 0x0B | 安装失败 (下载超时)                            |
| STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED               | 0x0C | 安装失败 (下载失败)                            |
| STATUS_RECOVER_FAILURE_INVALID<sup>8+</sup>          | 0x0D | 恢复预置应用失败                                 |
| STATUS_ABILITY_NOT_FOUND                             | 0x40 | Ability未找到                                    |
| STATUS_BMS_SERVICE_ERROR                             | 0x41 | BMS服务错误                                      |
| STATUS_FAILED_NO_SPACE_LEFT<sup>8+</sup>             | 0x42 | 设备空间不足                                     |
| STATUS_GRANT_REQUEST_PERMISSIONS_FAILED<sup>8+</sup> | 0x43 | 应用授权失败                                     |
| STATUS_INSTALL_PERMISSION_DENIED<sup>8+</sup>        | 0x44 | 缺少安装权限                                     |
| STATUS_UNINSTALL_PERMISSION_DENIED<sup>8+</sup>      | 0x45 | 缺少卸载权限                                     |
W
wanghang 已提交
1715

W
wanghang 已提交
1716 1717 1718
## BundleFlag<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.BundleFlag](js-apis-bundleManager.md#bundleflag)替代。
W
wanghang 已提交
1719

X
xsz233 已提交
1720
包信息标志,指示需要获取的包信息的内容。
X
xsz233 已提交
1721 1722 1723 1724

当接口与标志不匹配时,该标志会被忽略,例如获取application时使用GET_ABILITY_INFO_WITH_PERMISSION对结果不会产生影响。

标志可以叠加使用,例如使用GET_APPLICATION_INFO_WITH_PERMISSION + GET_APPLICATION_INFO_WITH_DISABLE可以使结果同时包含应用权限信息和被禁用的应用信息。
W
wanghang 已提交
1725

qq_41863798's avatar
api 9  
qq_41863798 已提交
1726
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
X
xuezhongzhu 已提交
1727

J
junyi233 已提交
1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741
| 名称                                            | 值         | 说明                            |
| ----------------------------------------------- | ---------- | ------------------------------- |
| GET_BUNDLE_DEFAULT                              | 0x00000000 | 获取默认的应用信息              |
| GET_BUNDLE_WITH_ABILITIES                       | 0x00000001 | 获取包括Ability信息的包信息     |
| GET_ABILITY_INFO_WITH_PERMISSION                | 0x00000002 | 获取包括权限的Ability信息       |
| GET_ABILITY_INFO_WITH_APPLICATION               | 0x00000004 | 获取包括Application的ability信息       |
| GET_APPLICATION_INFO_WITH_PERMISSION            | 0x00000008 | 获取包括权限的应用信息          |
| GET_BUNDLE_WITH_REQUESTED_PERMISSION            | 0x00000010 | 获取包括所需权限的包信息        |
| GET_ABILITY_INFO_WITH_METADATA<sup>8+</sup>     | 0x00000020 | 获取ability的元数据信息         |
| GET_APPLICATION_INFO_WITH_METADATA<sup>8+</sup> | 0x00000040 | 获取应用的元数据信息            |
| GET_ABILITY_INFO_SYSTEMAPP_ONLY<sup>8+</sup>    | 0x00000080 | 获取仅包括系统应用的ability信息 |
| GET_ABILITY_INFO_WITH_DISABLE<sup>8+</sup>      | 0x00000100 | 获取包括被禁用的ability信息     |
| GET_APPLICATION_INFO_WITH_DISABLE<sup>8+</sup>  | 0x00000200 | 获取包括被禁用的应用信息        |
| GET_ALL_APPLICATION_INFO                        | 0xFFFF0000 | 获取应用所有的信息              |
W
wanghang 已提交
1742

W
wanghang 已提交
1743 1744
## BundleOptions<sup>deprecated<sup>
> 从API version 9开始不再维护,不推荐使用。
W
wanghang 已提交
1745

X
xsz233 已提交
1746
查询选项,包含userId。
W
wanghang 已提交
1747

qq_41863798's avatar
api 9  
qq_41863798 已提交
1748
 **系统能力:** SystemCapability.BundleManager.BundleFramework
X
xuezhongzhu 已提交
1749

J
junyi233 已提交
1750
| 名称   | 类型   | 可读 | 可写 | 说明                                                  |
J
junyi233 已提交
1751 1752
| ------ | ------ | ---- | ---- | ----------------------------------------------------- |
| userId | number | 是   | 是   | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。 |
W
wanghang 已提交
1753

W
wanghang 已提交
1754 1755 1756
## AbilityType<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.AbilityType](js-apis-bundleManager.md#abilitytype)替代。
W
wanghang 已提交
1757

X
xsz233 已提交
1758
Ability组件类型。
W
wanghang 已提交
1759

qq_41863798's avatar
api 9  
qq_41863798 已提交
1760
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
X
xuezhongzhu 已提交
1761

J
junyi233 已提交
1762
| 名称 | 值 | 说明                        |
J
junyi233 已提交
1763 1764 1765 1766 1767
| ------- | ---- | --------------------------- |
| UNKNOWN | 无   | 未知Ability类型             |
| PAGE    | 无   | 表示基于Page模板开发的FA,用于提供与用户交互的能力        |
| SERVICE | 无   | 表示基于Service模板开发的PA,用于提供后台运行任务的能力           |
| DATA    | 无   | 表示基于Data模板开发的PA,用于对外部提供统一的数据访问对象 |
W
wanghang 已提交
1768

W
wanghang 已提交
1769 1770 1771
## DisplayOrientation<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.DisplayOrientation](js-apis-bundleManager.md#displayorientation)替代。
W
wanghang 已提交
1772

X
xsz233 已提交
1773
屏幕显示方向。
W
wanghang 已提交
1774

qq_41863798's avatar
api 9  
qq_41863798 已提交
1775
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
X
xuezhongzhu 已提交
1776

J
junyi233 已提交
1777
| 名称          | 值   | 说明                     |
J
junyi233 已提交
1778 1779 1780 1781 1782
| ------------- | ---- | ------------------------ |
| UNSPECIFIED   | 无   | 屏幕方向--不指定         |
| LANDSCAPE     | 无   | 屏幕方向--横屏           |
| PORTRAIT      | 无   | 屏幕方向--竖屏           |
| FOLLOW_RECENT | 无   | 屏幕方向--紧跟上一个组件 |
W
wanghang 已提交
1783 1784 1785
## LaunchMode<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.LaunchType](js-apis-bundleManager.md#launchtype)替代。
W
wanghang 已提交
1786

X
xsz233 已提交
1787
Ability组件的启动模式。
W
wanghang 已提交
1788

qq_41863798's avatar
api 9  
qq_41863798 已提交
1789
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
X
xuezhongzhu 已提交
1790

J
junyi233 已提交
1791
| 名称      | 值   | 说明                |
J
junyi233 已提交
1792 1793 1794
| --------- | ---- | ------------------- |
| SINGLETON | 0    | Ability只有一个实例 |
| STANDARD  | 1    | Ability有多个实例   |
W
wanghang 已提交
1795

W
wanghang 已提交
1796 1797
## AbilitySubType<sup>deprecated<sup>
> 从API version 9开始不再维护,不推荐使用。
W
wanghang 已提交
1798

X
xsz233 已提交
1799
Ability组件的子类型。
W
wanghang 已提交
1800

qq_41863798's avatar
api 9  
qq_41863798 已提交
1801
 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework
X
xuezhongzhu 已提交
1802

J
junyi233 已提交
1803
| 名称        | 值   | 说明                          |
J
junyi233 已提交
1804 1805
| ----------- | ---- | ----------------------------- |
| UNSPECIFIED | 0    | 未定义Ability子类型           |
W
wanghang 已提交
1806
| CA          | 1    | Ability子类型是带有 UI 的服务 |
qq_41863798's avatar
api 9  
qq_41863798 已提交
1807

W
wanghang 已提交
1808 1809
## ColorMode<sup>deprecated<sup>
> 从API version 9开始不再维护,不推荐使用。
qq_41863798's avatar
qq_41863798 已提交
1810

X
xsz233 已提交
1811
应用、卡片等的颜色模式。
qq_41863798's avatar
qq_41863798 已提交
1812 1813 1814

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

J
junyi233 已提交
1815
| 名称       | 值   | 说明     |
J
junyi233 已提交
1816
| ---------- | ---- | -------- |
H
HelloCrease 已提交
1817
| AUTO_MODE  | -1   | 自动模式 |
qq_41863798's avatar
qq_41863798 已提交
1818 1819
| DARK_MODE  | 0    | 黑色模式 |
| LIGHT_MODE | 1    | 亮度模式 |
qq_41863798's avatar
qq_41863798 已提交
1820 1821


W
wanghang 已提交
1822 1823 1824
## GrantStatus<sup>deprecated<sup>

> 从API version 9开始不再维护,建议使用[bundleManager.PermissionGrantState](js-apis-bundleManager.md#permissiongrantstate)替代。
qq_41863798's avatar
qq_41863798 已提交
1825

X
xsz233 已提交
1826
权限授予状态。
qq_41863798's avatar
qq_41863798 已提交
1827 1828 1829

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

J
junyi233 已提交
1830
| 名称               | 值   | 说明         |
J
junyi233 已提交
1831 1832
| ------------------ | ---- | ------------ |
| PERMISSION_DENIED  | -1   | 拒绝授予权限 |
1833
| PERMISSION_GRANTED | 0    | 授予权限     |