js-apis-Bundle.md 74.1 KB
Newer Older
S
shuaiyutao 已提交
1 2
# Bundle模块(JS端SDK接口)

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 18 19 20 21
| 权限                                         | 权限等级         | 描述            |
|--------------------------------------------|--------------|---------------|
| ohos.permission.GET_BUNDLE_INFO            | normal       | 查询指定应用信息      |
| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息     |
| ohos.permission.INSTALL_BUNDLE             | system_core  | 可安装、卸载应用      |
| ohos.permission.MANAGE_DISPOSED_APP_STATUS | system_core  | 可设置和查询应用的处置状态 |
S
shuaiyutao 已提交
22

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

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

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

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

X
xsz233 已提交
31
以异步方法根据给定的包名获取ApplicationInfo。使用Promise异步回调。
S
shuaiyutao 已提交
32 33 34

**需要权限:**

J
junyi233 已提交
35
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
36
<br>获取调用方自己的信息时不需要权限。
S
shuaiyutao 已提交
37

38 39 40 41
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
42 43
**参数:**

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

**返回值:**

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

**示例:**

X
xsz233 已提交
58
```ts
W
wanghang 已提交
59 60 61 62 63 64 65 66
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 已提交
67 68 69
})
```

W
wanghang 已提交
70 71 72
## bundle.getApplicationInfo<sup>deprecated<sup>

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

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

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

**需要权限:**

J
junyi233 已提交
80
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
81
<br>获取调用方自己的信息时不需要权限。
S
shuaiyutao 已提交
82

83 84 85 86
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
87 88
**参数:**

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

**示例:**

X
xsz233 已提交
98
```ts
W
wanghang 已提交
99 100 101 102 103 104 105 106 107 108
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 已提交
109 110
```

W
wanghang 已提交
111 112 113 114
## bundle.getApplicationInfo<sup>deprecated<sup>

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

qq_41863798's avatar
qq_41863798 已提交
115 116 117

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

X
xsz233 已提交
118
以异步方法根据给定的包名获取ApplicationInfo,使用callback形式返回结果。
qq_41863798's avatar
qq_41863798 已提交
119 120
**需要权限:**

J
junyi233 已提交
121
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
122
获取调用方自己的信息时不需要权限。
qq_41863798's avatar
qq_41863798 已提交
123 124 125 126 127 128 129

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

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

**示例:**

X
xsz233 已提交
138
```ts
qq_41863798's avatar
qq_41863798 已提交
139 140 141 142 143 144 145 146 147 148 149
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));
 })
```

150

W
wanghang 已提交
151
## bundle.getAllBundleInfo<sup>deprecated<sup>
152

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

W
wanghang 已提交
155
getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise<Array\<BundleInfo>>
S
shuaiyutao 已提交
156

X
xsz233 已提交
157
以异步方法获取指定用户所有的BundleInfo,使用Promise形式异步回调,
S
shuaiyutao 已提交
158 159 160 161 162

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

163 164 165 166
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
167 168
**参数:**

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

**返回值:**

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

**示例:**

X
xsz233 已提交
182
```ts
W
wanghang 已提交
183 184 185 186 187 188 189
let bundleFlag = 0;
let userId = 100;
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 已提交
190 191 192
})
```

W
wanghang 已提交
193 194 195 196
## bundle.getAllBundleInfo<sup>deprecated<sup>

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

S
shuaiyutao 已提交
197 198 199

getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback<Array\<BundleInfo>>): void

X
xsz233 已提交
200
以异步方法获取当前用户所有的BundleInfo,使用callback形式返回结果。
S
shuaiyutao 已提交
201 202 203 204 205

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

206 207 208 209
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
210 211
**参数:**

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

**示例:**

X
xsz233 已提交
219
```ts
W
wanghang 已提交
220 221 222 223 224 225 226 227 228
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 已提交
229

W
wanghang 已提交
230 231 232 233
## bundle.getAllBundleInfo<sup>deprecated<sup>

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

W
wanghang 已提交
234 235 236

getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback<Array\<BundleInfo>>): void

X
xsz233 已提交
237
以异步方法获取系统中指定用户下所有的BundleInfo,使用callback形式返回结果。
W
wanghang 已提交
238 239 240 241 242

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

243 244 245 246
**系统能力:**

SystemCapability.BundleManager.BundleFramework

W
wanghang 已提交
247 248
**参数:**

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

**示例:**

X
xsz233 已提交
258
```ts
W
wanghang 已提交
259 260 261 262 263 264 265 266 267
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 已提交
268 269
```

W
wanghang 已提交
270 271 272 273
## bundle.getBundleInfo<sup>deprecated<sup>

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

S
shuaiyutao 已提交
274

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

X
xsz233 已提交
277
以异步方法根据给定的包名获取BundleInfo,使用Promise异步回调。
S
shuaiyutao 已提交
278 279 280

**需要权限:**

J
junyi233 已提交
281
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
282
获取调用方自己的信息时不需要权限。
S
shuaiyutao 已提交
283

284 285 286 287
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
288 289
**参数:**

X
xsz233 已提交
290 291 292
| 参数名         | 类型            | 必填   | 说明                                                                  |
| ----------- | ------------- | ---- |---------------------------------------------------------------------|
| bundleName  | string        | 是    | 要查询的应用程序包名称                                                         |
X
xsz233 已提交
293
| bundleFlags | number        | 是    | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
X
xsz233 已提交
294
| options     | [BundleOptions](#bundleoptions) | 否    | 包含userid的查询选项。                                                      |
S
shuaiyutao 已提交
295 296 297

**返回值:**

H
HelloCrease 已提交
298 299
| 类型                   | 说明                           |
| -------------------- | ---------------------------- |
300
| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | Promise对象,获取成功时返回包信息。 |
S
shuaiyutao 已提交
301 302 303

**示例:**

X
xsz233 已提交
304
```ts
W
wanghang 已提交
305 306 307
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
qq_41863798's avatar
qq_41863798 已提交
308
  "userId" : 100
W
wanghang 已提交
309 310 311 312 313 314
};
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 已提交
315 316 317
})
```

W
wanghang 已提交
318 319 320
## bundle.getBundleInfo<sup>deprecated<sup>

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

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

X
xsz233 已提交
324
以异步方法根据给定的包名获取BundleInfo,使用callback异步回调。
S
shuaiyutao 已提交
325 326 327

**需要权限:**

J
junyi233 已提交
328
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
329
获取调用方自己的信息时不需要权限。
S
shuaiyutao 已提交
330

331 332 333 334
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
335 336
**参数:**

X
xsz233 已提交
337 338 339
| 参数名      | 类型                                                       | 必填 | 说明                                                                  |
| ----------- | ---------------------------------------------------------- | ---- |---------------------------------------------------------------------|
| bundleName  | string                                                     | 是   | 需要查询的应用程序包名称。                                                       |
X
xsz233 已提交
340
| bundleFlags | number                                                     | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflag)中包信息相关flag。 |
X
xsz233 已提交
341
| callback    | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是   | 程序启动作为入参的回调函数,返回包信息。                                                |
S
shuaiyutao 已提交
342 343 344

**示例:**

X
xsz233 已提交
345
```ts
W
wanghang 已提交
346 347 348 349 350 351 352 353 354
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 已提交
355 356 357
```


W
wanghang 已提交
358 359 360
## bundle.getBundleInfo<sup>deprecated<sup>

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

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

X
xsz233 已提交
364
以异步方法根据给定的包名获取BundleInfo,使用callback异步回调。
W
wanghang 已提交
365 366 367

**需要权限:**

J
junyi233 已提交
368
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
369
获取调用方自己的信息时不需要权限。
W
wanghang 已提交
370

371 372 373 374
**系统能力:**

SystemCapability.BundleManager.BundleFramework

W
wanghang 已提交
375 376
**参数:**

J
junyi233 已提交
377
| 参数名      | 类型                                                       | 必填 | 说明                                                         |
S
shuaiyutao 已提交
378 379
| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ |
| bundleName  | string                                                     | 是   | 包名                                                         |
X
xsz233 已提交
380
| bundleFlags | number                                                     | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflag)中包信息相关flag |
S
shuaiyutao 已提交
381 382
| options     | [BundleOptions](#bundleoptions)                            | 是   | 包含userid。                                                 |
| callback    | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是   | 程序启动作为入参的回调函数,返回包信息。                     |
W
wanghang 已提交
383 384 385

**示例:**

X
xsz233 已提交
386
```ts
W
wanghang 已提交
387 388 389
let bundleName = "com.example.myapplication";
let bundleFlags = 1;
let options = {
qq_41863798's avatar
qq_41863798 已提交
390
  "userId" : 100
W
wanghang 已提交
391 392 393 394 395 396 397 398 399 400
};
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));
})
```

401 402


W
wanghang 已提交
403
## bundle.getBundleInstaller<sup>deprecated<sup>
404

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

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

X
xsz233 已提交
409
获取用于安装包的接口,使用Promise异步回调,返回安装接口对象。
J
junyi233 已提交
410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426

**需要权限:**

ohos.permission.INSTALL_BUNDLE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**返回值:**

| 类型                                                         | 说明                                         |
| ------------------------------------------------------------ | -------------------------------------------- |
X
xsz233 已提交
427 428 429 430 431 432 433 434 435 436 437
| 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 已提交
438

W
wanghang 已提交
439 440 441
## bundle.getBundleInstaller<sup>deprecated<sup>

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

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

X
xsz233 已提交
445
获取用于安装包的接口,使用callback异步回调。
J
junyi233 已提交
446 447 448 449 450 451 452 453 454 455 456 457 458 459 460

**需要权限:**

ohos.permission.INSTALL_BUNDLE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

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

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

X
xsz233 已提交
467 468 469 470 471 472 473 474 475
```ts
bundle.getBundleInstaller((err, data) => {
    if (err.code == 0) {
        console.error('getBundleInstaller failed.');
    } else {
        console.info('getBundleInstaller successfully');
    }
});
```
J
junyi233 已提交
476
## bundle.cleanBundleCacheFiles<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
477 478

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

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

X
xsz233 已提交
482
清除指定应用程序的缓存数据,使用callback异步回调。
J
junyi233 已提交
483 484 485 486 487 488 489 490 491 492 493 494 495 496 497

**需要权限:**

ohos.permission.REMOVE_CACHE_FILES

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

J
junyi233 已提交
498
| 参数名      | 类型                | 必填 | 说明                                  |
J
junyi233 已提交
499
| ---------- | ------------------- | ---- | ------------------------------------- |
X
xsz233 已提交
500
| bundleName | string              | 是   | 指示要清除其缓存数据的应用程序包名称。 |
X
xsz233 已提交
501 502 503 504 505 506 507 508 509 510 511 512 513 514 515
| 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 已提交
516

J
junyi233 已提交
517
## bundle.cleanBundleCacheFiles<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
518 519

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

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

X
xsz233 已提交
523
清除指定应用程序的缓存数据,使用Promise异步回调。
J
junyi233 已提交
524 525 526 527 528 529 530 531 532 533 534 535 536 537 538

**需要权限:**

ohos.permission.REMOVE_CACHE_FILES

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

J
junyi233 已提交
539
| 参数名     | 类型   | 必填 | 说明                                  |
J
junyi233 已提交
540
| ---------- | ------ | ---- | ------------------------------------- |
X
xsz233 已提交
541
| bundleName | string | 是   | 指示要清除其缓存数据的应用程序包名称。 |
J
junyi233 已提交
542 543 544 545 546

**返回值:**

| 类型          | 说明                                 |
| ------------- | ------------------------------------ |
X
xsz233 已提交
547 548 549 550 551 552 553 554 555 556 557 558 559
| 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 已提交
560

J
junyi233 已提交
561
## bundle.setApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
562 563

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

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

X
xsz233 已提交
567
设置是否启用指定的应用程序,使用callback异步回调。
J
junyi233 已提交
568 569 570 571 572 573 574 575 576 577 578 579 580 581 582

**需要权限:**

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

X
xsz233 已提交
583 584 585
| 参数名      | 类型                | 必填 | 说明                             |
| ---------- | ------------------- | ---- |--------------------------------|
| bundleName | string              | 是   | 指示需要启用或禁用的应用程序包名称。             |
X
xsz233 已提交
586
| isEnable   | boolean             | 是   | 指定是否启用应用程序。true表示启用,false表示禁用。 |
X
xsz233 已提交
587
| callback   | AsyncCallback\<void> | 是   | 回调函数。                          |
X
xsz233 已提交
588 589 590 591 592 593 594 595 596 597 598 599 600 601

**示例:**

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

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

J
junyi233 已提交
603
## bundle.setApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
604 605

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

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

X
xsz233 已提交
609
设置是否启用指定的应用程序,使用Promise异步回调。
J
junyi233 已提交
610 611 612 613 614 615 616 617 618 619 620 621 622 623 624

**需要权限:**

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

X
xsz233 已提交
625 626 627
| 参数名     | 类型    | 必填 | 说明                           |
| ---------- | ------- | ---- |------------------------------|
| bundleName | string  | 是   | 指示需要启用或禁用的应用程序包名称。           |
J
junyi233 已提交
628 629 630 631 632 633
| isEnable   | boolean | 是   | 指定是否启用应用程序。true表示启用,false禁用。 |

**返回值:**

| 类型          | 说明                                 |
| ------------- | ------------------------------------ |
X
xsz233 已提交
634 635 636 637 638 639 640 641 642 643 644 645 646
| 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 已提交
647

J
junyi233 已提交
648
## bundle.setAbilityEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
649 650

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

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

X
xsz233 已提交
654
设置是否启用指定的Ability组件,使用callback异步回调。
J
junyi233 已提交
655 656 657 658 659 660 661 662 663 664 665 666 667 668 669

**需要权限:**

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

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

J
junyi233 已提交
676
## bundle.setAbilityEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
677 678

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

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

X
xsz233 已提交
682
设置是否启用指定的Ability组件,使用Promise异步回调。
J
junyi233 已提交
683 684 685 686 687 688 689 690 691 692 693 694 695 696 697

**需要权限:**

ohos.permission.CHANGE_ABILITY_ENABLED_STATE

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

J
junyi233 已提交
698
| 参数名   | 类型                                         | 必填 | 说明                                            |
J
junyi233 已提交
699
| -------- | -------------------------------------------- | ---- | ----------------------------------------------- |
X
xsz233 已提交
700
| info     | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是   | Ability信息,指示需要设置启用状态的Ability。                                   |
J
junyi233 已提交
701 702 703 704 705 706
| isEnable | boolean                                      | 是   | 指定是否启用应用程序。true表示启用,false禁用。 |

**返回值:**

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

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

X
xsz233 已提交
711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730
```ts
let flag = bundle.BundleFlag.GET_ABILITY_INFO_WITH_PERMISSION;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};

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 已提交
731
## bundle.getPermissionDef<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
732 733

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

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

X
xsz233 已提交
737
按权限名称获取权限的详细信息,使用callback异步回调。
J
junyi233 已提交
738 739 740 741 742 743 744 745 746 747 748 749 750 751 752

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

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

X
xsz233 已提交
758 759 760 761 762 763 764 765 766 767 768 769 770
**示例:**

```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 已提交
771
## bundle.getPermissionDef<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
772 773

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

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

777
按权限名称获取权限的详细信息,使用promise异步回调。。
J
junyi233 已提交
778 779 780 781 782 783 784 785 786 787 788 789 790 791 792

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**系统API:**

此接口为系统接口,三方应用不支持调用

**参数:**

J
junyi233 已提交
793
| 参数名         | 类型   | 必填 | 说明             |
J
junyi233 已提交
794
| -------------- | ------ | ---- | ---------------- |
X
xsz233 已提交
795
| permissionName | string | 是   | 需要查询的权限的名称。 |
J
junyi233 已提交
796 797 798 799 800

**返回值:**

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

X
xsz233 已提交
803 804 805 806 807 808 809 810 811 812
**示例:**

```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 已提交
813

W
wanghang 已提交
814
## bundle.getAllApplicationInfo<sup>deprecated<sup>
S
shuaiyutao 已提交
815

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

qq_41863798's avatar
qq_41863798 已提交
818
getAllApplicationInfo(bundleFlags: number, userId?: number): Promise<Array\<ApplicationInfo>>
S
shuaiyutao 已提交
819

X
xsz233 已提交
820
获取指定用户下所有已安装的应用信息,使用promise异步回调。
S
shuaiyutao 已提交
821 822 823

**需要权限:**

W
wanghang 已提交
824
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
S
shuaiyutao 已提交
825

826 827 828 829
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
830 831
**参数:**

J
junyi233 已提交
832
| 参数名      | 类型   | 必填 | 说明                                                         |
S
shuaiyutao 已提交
833
| ----------- | ------ | ---- | ------------------------------------------------------------ |
X
xsz233 已提交
834
| bundleFlags | number | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflag)中应用信息相关flag。 |
S
shuaiyutao 已提交
835
| userId      | number | 否   | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。        |
S
shuaiyutao 已提交
836 837 838

**返回值:**

H
HelloCrease 已提交
839 840
| 类型                               | 说明                              |
| -------------------------------- | ------------------------------- |
841
| Promise<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | Promise对象,获取成功时返回应用信息列表。 |
S
shuaiyutao 已提交
842 843 844

**示例:**

X
xsz233 已提交
845
```ts
W
wanghang 已提交
846 847 848 849 850 851 852
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 已提交
853 854 855
})
```

W
wanghang 已提交
856
## bundle.getAllApplicationInfo<sup>deprecated<sup>
S
shuaiyutao 已提交
857

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

getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback<Array\<ApplicationInfo>>): void

862
获取指定用户下所有已安装的应用信息,使用callback异步回调。
S
shuaiyutao 已提交
863 864 865

**需要权限:**

W
wanghang 已提交
866
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
S
shuaiyutao 已提交
867

868 869 870 871
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
872 873
**参数:**

J
junyi233 已提交
874
| 参数名      | 类型                                                         | 必填 | 说明                                                         |
S
shuaiyutao 已提交
875
| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
X
xsz233 已提交
876
| bundleFlags | number                                                       | 是   | 用于指定返回的应用信息对象中包含信息的标记。取值范围:参考[BundleFlag说明](#bundleflag)中应用信息相关flag。 |
S
shuaiyutao 已提交
877 878
| userId      | number                                                       | 否   | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。        |
| callback    | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回应用信息列表。               |
S
shuaiyutao 已提交
879 880 881

**示例:**

X
xsz233 已提交
882
```ts
X
xsz233 已提交
883
let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
W
wanghang 已提交
884 885 886 887 888 889 890 891
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 已提交
892 893 894
```


W
wanghang 已提交
895 896 897
## bundle.getAllApplicationInfo<sup>deprecated<sup>

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

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

901
获取所有已安装的应用信息,使用callback异步回调。
qq_41863798's avatar
qq_41863798 已提交
902 903 904 905 906 907 908 909 910 911 912

**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

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

**示例:**

X
xsz233 已提交
920
```ts
X
xsz233 已提交
921
let bundleFlags = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION;
qq_41863798's avatar
qq_41863798 已提交
922 923 924 925 926 927 928 929 930
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 已提交
931 932 933
## bundle.getBundleArchiveInfo<sup>deprecated<sup>

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

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

X
xsz233 已提交
937
获取有关HAP包中包含的应用程序包的信息,使用Promise形式返回结果。
W
wanghang 已提交
938 939 940 941 942 943 944

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

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

**返回值:**
| 类型             | 说明                                     |
| -------------- | -------------------------------------- |
| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 返回值为Promise对象,Promise中包含有关hap包中包含的应用程序的信息。 |

**示例:**

X
xsz233 已提交
957
```ts
X
xsz233 已提交
958
let hapFilePath = "/data/storage/el2/base/test.hap";
W
wanghang 已提交
959 960 961 962 963 964 965 966 967
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 已提交
968 969 970
## bundle.getBundleArchiveInfo<sup>deprecated<sup>

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

972
getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback\<BundleInfo>) : void
W
wanghang 已提交
973 974 975 976 977 978 979 980 981

以异步方法获取有关HAP包中包含的应用程序包的信息,使用callback形式返回结果。

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

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

**示例:**

X
xsz233 已提交
990
```ts
X
xsz233 已提交
991
let hapFilePath = "/data/storage/el2/base/test.hap";
W
wanghang 已提交
992 993 994 995 996 997 998 999 1000 1001 1002
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 已提交
1003 1004 1005
## bundle.getAbilityInfo<sup>deprecated<sup>

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

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

X
xsz233 已提交
1009
通过包名称和组件名获取Ability组件信息,使用Promise形式异步回调。
D
dy 已提交
1010 1011 1012

**需要权限:**

J
junyi233 已提交
1013
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1014
<br>获取调用方自己的信息时不需要权限。
D
dy 已提交
1015 1016 1017 1018 1019 1020 1021

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

X
xsz233 已提交
1022 1023 1024
| 参数名         | 类型     | 必填   | 说明         |
| ----------- | ------ | ---- |------------|
| bundleName  | string | 是    | 应用程序包名称。   |
X
xsz233 已提交
1025
| abilityName | string | 是    | Ability组件名称。 |
D
dy 已提交
1026 1027 1028

**返回值:**

H
HelloCrease 已提交
1029 1030
| 类型                    | 说明                    |
| --------------------- | --------------------- |
J
junyi233 已提交
1031
| Promise\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | Promise形式返回Ability信息。 |
D
dy 已提交
1032 1033 1034

**示例:**

X
xsz233 已提交
1035
```ts
D
dy 已提交
1036 1037 1038 1039 1040 1041 1042 1043 1044 1045
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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 已提交
1046 1047 1048
## bundle.getAbilityInfo<sup>deprecated<sup>

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

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

X
xsz233 已提交
1052
通过包名称和组件名获取Ability组件信息,使用callback形式返回结果。
D
dy 已提交
1053 1054 1055

**需要权限:**

J
junyi233 已提交
1056
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1057
<br>获取调用方自己的信息时不需要权限。
D
dy 已提交
1058 1059 1060 1061 1062 1063 1064

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

X
xsz233 已提交
1065 1066 1067 1068
| 参数名        | 类型     | 必填   | 说明                         |
| ----------- | ------------ | ---- |----------------------------|
| bundleName  | string | 是    | 应用程序包名称。                   |
| abilityName | string | 是    | Ability名称。                 |
J
junyi233 已提交
1069
| callback    | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是    | 程序启动作为入参的回调函数,返回Ability信息。 |
D
dy 已提交
1070 1071 1072

**示例:**

X
xsz233 已提交
1073
```ts
D
dy 已提交
1074 1075 1076 1077 1078 1079 1080 1081 1082 1083
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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));
})
```
1084

J
junyi233 已提交
1085
## bundle.getAbilityLabel<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1086 1087 1088 1089

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

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

X
xsz233 已提交
1091
通过包名称和ability名称获取应用名称,使用Promise形式返回结果。
D
dy 已提交
1092 1093 1094

**需要权限:**

J
junyi233 已提交
1095
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1096
<br>获取调用方自己的信息时不需要权限。
D
dy 已提交
1097 1098 1099 1100 1101 1102 1103

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

X
xsz233 已提交
1104 1105 1106 1107
| 参数名         | 类型     | 必填  | 说明         |
|-------------|--------|-----|------------|
| bundleName  | string | 是   | 应用程序包名称。   |
| abilityName | string | 是   | Ability名称。 |
D
dy 已提交
1108 1109 1110

**返回值:**

H
HelloCrease 已提交
1111 1112
| 类型               | 说明                 |
| ---------------- | ------------------ |
D
dy 已提交
1113 1114 1115 1116
| Promise\<string> | Promise形式返回应用名称信息。 |

**示例:**

X
xsz233 已提交
1117
```ts
D
dy 已提交
1118 1119 1120 1121 1122 1123 1124 1125 1126 1127
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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 已提交
1128
## bundle.getAbilityLabel<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1129 1130

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

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

X
xsz233 已提交
1134
通过包名称和Ability组件名获取应用名称,使用callback形式返回结果。
D
dy 已提交
1135 1136 1137

**需要权限:**

J
junyi233 已提交
1138
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1139
<br>获取调用方自己的信息时不需要权限。
D
dy 已提交
1140 1141 1142 1143 1144 1145 1146

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

X
xsz233 已提交
1147 1148 1149 1150 1151
| 参数名         | 类型                     | 必填  | 说明                      |
|-------------|------------------------|-----|-------------------------|
| bundleName  | string                 | 是   | 应用程序包名称。                |
| abilityName | string                 | 是   | Ability名称。              |
| callback    | AsyncCallback\<string> | 是   | 程序启动作为入参的回调函数,返回应用名称信息。 |
D
dy 已提交
1152 1153 1154

**示例:**

X
xsz233 已提交
1155
```ts
D
dy 已提交
1156 1157 1158 1159 1160 1161 1162 1163 1164 1165
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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));
})
```
1166

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

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

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

1173
以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用Promise形式返回结果。
D
dy 已提交
1174 1175 1176 1177 1178 1179 1180

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
1181 1182 1183
| 参数名 | 类型                                         | 必填 | 说明              |
| ------ | -------------------------------------------- | ---- | ----------------- |
| info   | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是   | Ability的配置信息 |
D
dy 已提交
1184 1185 1186

**返回值:**

H
HelloCrease 已提交
1187 1188
| 类型                | 说明                        |
| ----------------- | ------------------------- |
D
dy 已提交
1189 1190 1191 1192
| Promise\<boolean> | Promise形式返回boolean代表是否启用。 |

**示例:**

X
xsz233 已提交
1193
```ts
W
wanghang 已提交
1194 1195 1196 1197 1198 1199 1200 1201
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
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 已提交
1202 1203 1204
})
```

J
junyi233 已提交
1205
## bundle.isAbilityEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1206 1207

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

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

1211
以异步方法根据给定的AbilityInfo查询ability是否已经启用,使用callback形式返回结果。
D
dy 已提交
1212 1213 1214 1215 1216 1217 1218

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
1219 1220 1221 1222
| 参数名   | 类型                                         | 必填 | 说明                    |
| -------- | -------------------------------------------- | ---- | ----------------------- |
| info     | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是   | Ability的配置信息       |
| callback | AsyncCallback\<boolean>                      | 是   | 返回boolean代表是否启用 |
D
dy 已提交
1223 1224 1225

**示例:**

X
xsz233 已提交
1226
```ts
W
wanghang 已提交
1227 1228 1229 1230
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo)=>{
    bundle.isAbilityEnabled(abilityInfo, (err, data) => {
D
dy 已提交
1231 1232 1233 1234 1235
    if (err) {
        console.error('Operation failed. Cause: ' + JSON.stringify(err));
        return;
    }
    console.info('Operation successful. Data:' + JSON.stringify(data));
W
wanghang 已提交
1236
    })
D
dy 已提交
1237 1238 1239
})
```

J
junyi233 已提交
1240
## bundle.isApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1241 1242

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

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

1246
以异步方法根据给定的bundleName查询指定应用程序是否已经启用,使用Promise形式返回结果。
D
dy 已提交
1247 1248 1249 1250 1251 1252 1253

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
1254 1255 1256
| 参数名     | 类型   | 必填 | 说明                     |
| ---------- | ------ | ---- | ------------------------ |
| bundleName | string | 是   | 要查询的应用程序包名称。 |
D
dy 已提交
1257 1258 1259

**返回值:**

H
HelloCrease 已提交
1260 1261
| 类型                | 说明                        |
| ----------------- | ------------------------- |
D
dy 已提交
1262 1263 1264 1265
| Promise\<boolean> | Promise形式返回boolean代表是否启用。 |

**示例:**

X
xsz233 已提交
1266
```ts
qq_41863798's avatar
api 9  
qq_41863798 已提交
1267 1268
let bundleName = "com.example.myapplication";
bundle.isApplicationEnabled(bundleName)
D
dy 已提交
1269 1270 1271 1272 1273 1274 1275
.then((data) => {
    console.info('Operation successful. Data: ' + JSON.stringify(data));
}).catch((error) => {
    console.error('Operation failed. Cause: ' + JSON.stringify(error));
})
```

J
junyi233 已提交
1276
## bundle.isApplicationEnabled<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1277 1278

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

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

1282
以异步方法根据给定的bundleName查询指定应用程序是否已经启用,使用callback形式返回结果。
D
dy 已提交
1283 1284 1285 1286 1287 1288 1289

**系统能力:**

SystemCapability.BundleManager.BundleFramework

**参数:**

J
junyi233 已提交
1290 1291 1292 1293
| 参数名     | 类型                    | 必填 | 说明                     |
| ---------- | ----------------------- | ---- | ------------------------ |
| bundleName | string                  | 是   | 要查询的应用程序包名称。 |
| callback   | AsyncCallback\<boolean> | 是   | 返回boolean代表是否启用  |
D
dy 已提交
1294 1295 1296

**示例:**

X
xsz233 已提交
1297
```ts
H
HelloCrease 已提交
1298
let bundleName = "com.example.myapplication";
D
dy 已提交
1299 1300 1301 1302 1303 1304 1305 1306
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 已提交
1307

W
wanghang 已提交
1308 1309 1310
## bundle.queryAbilityByWant<sup>deprecated<sup>

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

queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise<Array\<AbilityInfo>>

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

**需要权限:**

J
junyi233 已提交
1318
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1319
<br>获取调用方自己的信息时不需要权限。
S
shuaiyutao 已提交
1320

1321 1322 1323 1324
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1325 1326
**参数:**

J
junyi233 已提交
1327
| 参数名         | 类型     | 必填   | 说明                                    |
H
HelloCrease 已提交
1328
| ----------- | ------ | ---- | ------------------------------------- |
J
junyi233 已提交
1329
| want        | [Want](js-apis-application-Want.md)   | 是    | 包含要查询的应用程序包名称的意图。                     |
X
xsz233 已提交
1330 1331
| bundleFlags | number | 是    | 用于指定返回abilityInfo信息。取值范围:参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 |
| userId      | number | 否    | 用户ID。默认值:调用方所在用户,取值范围:大于等于0。           |
S
shuaiyutao 已提交
1332 1333 1334

**返回值:**

H
HelloCrease 已提交
1335 1336
| 类型                           | 说明                    |
| ---------------------------- | --------------------- |
J
junyi233 已提交
1337
| Promise<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | Promise形式返回Ability信息。 |
S
shuaiyutao 已提交
1338 1339 1340

**示例:**

X
xsz233 已提交
1341
```ts
W
wanghang 已提交
1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352
let bundleFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
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 已提交
1353 1354 1355 1356 1357
})
```



W
wanghang 已提交
1358 1359 1360
## bundle.queryAbilityByWant<sup>deprecated<sup>

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

queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: AsyncCallback<Array\<AbilityInfo>>): void

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

J
junyi233 已提交
1366 1367 1368
**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1369
<br>获取调用方自己的信息时不需要权限。
J
junyi233 已提交
1370

X
xuezhongzhu 已提交
1371 1372 1373 1374
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1375 1376
**参数:**

X
xsz233 已提交
1377 1378 1379 1380 1381 1382
| 参数名         | 类型                                                                  | 必填  | 说明                                                                      |
|-------------|---------------------------------------------------------------------|-----|-------------------------------------------------------------------------|
| want        | [Want](js-apis-application-Want.md)                                 | 是   | 指示包含要查询的应用程序包名称的意图。                                                     |
| bundleFlags | number                                                              | 是   | 用于指定返回abilityInfo信息。取值范围:参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 |
| userId      | number                                                              | 是   | 用户ID。取值范围:大于等于0。                                                        |
| callback    | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回Ability信息。                                              |
S
shuaiyutao 已提交
1383 1384 1385

**示例:**

X
xsz233 已提交
1386
```ts
W
wanghang 已提交
1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399
let bundleFlags = 0;
let userId = 100;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
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 已提交
1400 1401
```

W
wanghang 已提交
1402 1403 1404
## bundle.queryAbilityByWant<sup>deprecated<sup>

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

qq_41863798's avatar
qq_41863798 已提交
1406
queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback<Array\<AbilityInfo>>): void;
S
shuaiyutao 已提交
1407 1408 1409

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

J
junyi233 已提交
1410 1411 1412
**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1413
<br>获取调用方自己的信息时不需要权限。
J
junyi233 已提交
1414

X
xuezhongzhu 已提交
1415 1416 1417 1418
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1419 1420
**参数:**

X
xsz233 已提交
1421 1422 1423 1424 1425
| 参数名         | 类型                                                                  | 必填  | 说明                                                                      |
|-------------|---------------------------------------------------------------------|-----|-------------------------------------------------------------------------|
| want        | [Want](js-apis-application-Want.md)                                 | 是   | 指示包含要查询的应用程序包名称的意图。                                                     |
| bundleFlags | number                                                              | 是   | 用于指定返回abilityInfo信息。取值范围:参考[BundleFlag说明](#bundleflag)中Ability信息相关flag。 |
| callback    | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是   | 程序启动作为入参的回调函数,返回Ability信息。                                              |
S
shuaiyutao 已提交
1426 1427 1428

**示例:**

X
xsz233 已提交
1429
```ts
W
wanghang 已提交
1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441
let bundleFlags = 0;
let want = {
    bundleName : "com.example.myapplication",
    abilityName : "com.example.myapplication.MainAbility"
};
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 已提交
1442 1443 1444 1445
```



W
wanghang 已提交
1446 1447 1448
## bundle.getLaunchWantForBundle<sup>deprecated<sup>

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

W
wanghang 已提交
1450 1451 1452
getLaunchWantForBundle(bundleName: string): Promise\<Want>

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

W
wanghang 已提交
1454 1455 1456 1457
**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

1458 1459 1460 1461
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1462 1463
**参数:**

J
junyi233 已提交
1464 1465 1466
| 参数名     | 类型   | 必填 | 说明                     |
| ---------- | ------ | ---- | ------------------------ |
| bundleName | string | 是   | 要查询的应用程序包名称。 |
S
shuaiyutao 已提交
1467 1468

**返回值:**
H
HelloCrease 已提交
1469 1470
| 类型             | 说明                                     |
| -------------- | -------------------------------------- |
J
junyi233 已提交
1471
| Promise\<[Want](js-apis-application-Want.md)> | 返回值为Promise对象,Promise中包含拉起指定应用的Want对象。 |
S
shuaiyutao 已提交
1472 1473 1474

**示例:**

X
xsz233 已提交
1475
```ts
W
wanghang 已提交
1476 1477 1478 1479 1480 1481 1482
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 已提交
1483 1484
```

W
wanghang 已提交
1485 1486 1487
## bundle.getLaunchWantForBundle<sup>deprecated<sup>

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

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

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

W
wanghang 已提交
1493 1494 1495 1496
**需要权限:**

ohos.permission.GET_BUNDLE_INFO_PRIVILEGED

1497 1498 1499 1500
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1501 1502
**参数:**

J
junyi233 已提交
1503 1504 1505 1506
| 参数名     | 类型                                                | 必填 | 说明                                                     |
| ---------- | --------------------------------------------------- | ---- | -------------------------------------------------------- |
| bundleName | string                                              | 是   | 要查询的应用程序包名称。                                 |
| callback   | AsyncCallback\<[Want](js-apis-application-Want.md)> | 是   | 程序启动作为入参的回调函数,返回拉起指定应用的want对象。 |
S
shuaiyutao 已提交
1507 1508 1509

**示例:**

X
xsz233 已提交
1510
```ts
W
wanghang 已提交
1511 1512 1513 1514 1515 1516 1517 1518
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 已提交
1519 1520 1521
```


J
junyi233 已提交
1522
## bundle.getNameForUid<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1523 1524

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

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

W
wanghang 已提交
1528
以异步方法通过uid获取对应的包名,使用Promise形式返回结果。
S
shuaiyutao 已提交
1529

X
xuezhongzhu 已提交
1530 1531 1532 1533
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1534 1535
**参数:**

J
junyi233 已提交
1536 1537 1538
| 参数名 | 类型   | 必填 | 说明          |
| ------ | ------ | ---- | ------------- |
| uid    | number | 是   | 要查询的uid。 |
S
shuaiyutao 已提交
1539 1540

**返回值:**
H
HelloCrease 已提交
1541 1542
| 类型               | 说明                                |
| ---------------- | --------------------------------- |
X
xsz233 已提交
1543
| Promise\<string> | 返回值为Promise对象,Promise中包含指定uid的包名称。 |
S
shuaiyutao 已提交
1544 1545 1546

**示例:**

X
xsz233 已提交
1547
```ts
W
wanghang 已提交
1548 1549 1550 1551 1552 1553 1554
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 已提交
1555 1556
```

J
junyi233 已提交
1557
## bundle.getNameForUid<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1558 1559

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

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

W
wanghang 已提交
1563
以异步方法通过uid获取对应的包名,使用callback形式返回结果。
S
shuaiyutao 已提交
1564

X
xuezhongzhu 已提交
1565 1566 1567 1568
**系统能力:**

SystemCapability.BundleManager.BundleFramework

S
shuaiyutao 已提交
1569 1570
**参数:**

X
xsz233 已提交
1571 1572 1573 1574
| 参数名      | 类型                     | 必填  | 说明                         |
|----------|------------------------|-----|----------------------------|
| uid      | number                 | 是   | 要查询的uid。                   |
| callback | AsyncCallback\<string> | 是   | 程序启动作为入参的回调函数,返回指定uid的包名称。 |
S
shuaiyutao 已提交
1575 1576 1577

**示例:**

X
xsz233 已提交
1578
```ts
W
wanghang 已提交
1579 1580 1581 1582 1583 1584 1585 1586
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 已提交
1587 1588
```

qq_41863798's avatar
qq_41863798 已提交
1589

J
junyi233 已提交
1590
## bundle.getAbilityIcon<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1591 1592

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

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

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

qq_41863798's avatar
qq_41863798 已提交
1598 1599
**需要权限:**

J
junyi233 已提交
1600
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1601
<br>获取调用方自己的信息时不需要权限。
qq_41863798's avatar
qq_41863798 已提交
1602 1603 1604 1605 1606

**系统能力:**

SystemCapability.BundleManager.BundleFramework

qq_41863798's avatar
qq_41863798 已提交
1607 1608
**参数:**

X
xsz233 已提交
1609 1610 1611 1612
| 参数名      | 类型   | 必填 | 说明              |
| ----------- | ------ | ---- |-----------------|
| bundleName  | string | 是   | 要查询的应用包名。       |
| abilityName | string | 是   | 要查询的Ability组件名。 |
qq_41863798's avatar
qq_41863798 已提交
1613 1614 1615 1616

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

**示例:**

X
xsz233 已提交
1621
```ts
1622 1623
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
qq_41863798's avatar
qq_41863798 已提交
1624 1625 1626 1627 1628 1629 1630 1631
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 已提交
1632
## bundle.getAbilityIcon<sup>8+</sup> <sup>deprecated<sup>
W
wanghang 已提交
1633 1634

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

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

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

qq_41863798's avatar
qq_41863798 已提交
1640 1641
**需要权限:**

J
junyi233 已提交
1642
ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO
X
xsz233 已提交
1643 1644
<br>获取调用方自己的信息时不需要权限。

qq_41863798's avatar
qq_41863798 已提交
1645 1646 1647 1648 1649

**系统能力:**

SystemCapability.BundleManager.BundleFramework

qq_41863798's avatar
qq_41863798 已提交
1650 1651
**参数:**

X
xsz233 已提交
1652 1653 1654 1655
| 参数名         | 类型                                       | 必填   | 说明                                              |
| ----------- | ---------------------------------------- | ---- |-------------------------------------------------|
| bundleName  | string                                   | 是    | 要查询的应用包名称。                                      |
| abilityName | string                                   | 是    | 要查询的Ability组件名。                                 |
1656
| callback   | AsyncCallback\<image.PixelMap> | 是   | 程序启动作为入参的回调函数,返回指定[PixelMap](js-apis-image.md)。 |
qq_41863798's avatar
qq_41863798 已提交
1657 1658 1659

**示例:**

X
xsz233 已提交
1660
```ts
1661 1662
let bundleName = "com.example.myapplication";
let abilityName = "com.example.myapplication.MainAbility";
qq_41863798's avatar
qq_41863798 已提交
1663 1664 1665 1666 1667 1668 1669 1670 1671
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 已提交
1672 1673
## InstallErrorCode<sup>deprecated<sup>
> 从API version 9开始不再维护,不推荐使用。
S
shuaiyutao 已提交
1674

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

J
junyi233 已提交
1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698
| 名称                                                 | 值   | 说明                                             |
| ---------------------------------------------------- | ---- | ------------------------------------------------ |
| 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 已提交
1699

W
wanghang 已提交
1700 1701 1702
## BundleFlag<sup>deprecated<sup>

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

X
xsz233 已提交
1704
包信息标志,指示需要获取的包信息的内容。
X
xsz233 已提交
1705 1706 1707 1708

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

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

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

J
junyi233 已提交
1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725
| 名称                                            | 值         | 说明                            |
| ----------------------------------------------- | ---------- | ------------------------------- |
| 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 已提交
1726

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

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

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

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

W
wanghang 已提交
1738 1739 1740
## AbilityType<sup>deprecated<sup>

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

X
xsz233 已提交
1742
Ability组件类型。
W
wanghang 已提交
1743

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

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

W
wanghang 已提交
1753 1754 1755
## DisplayOrientation<sup>deprecated<sup>

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

X
xsz233 已提交
1757
屏幕显示方向。
W
wanghang 已提交
1758

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

J
junyi233 已提交
1761
| 名称          | 值   | 说明                     |
J
junyi233 已提交
1762 1763 1764 1765 1766
| ------------- | ---- | ------------------------ |
| UNSPECIFIED   | 无   | 屏幕方向--不指定         |
| LANDSCAPE     | 无   | 屏幕方向--横屏           |
| PORTRAIT      | 无   | 屏幕方向--竖屏           |
| FOLLOW_RECENT | 无   | 屏幕方向--紧跟上一个组件 |
W
wanghang 已提交
1767 1768 1769
## LaunchMode<sup>deprecated<sup>

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

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

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

J
junyi233 已提交
1775
| 名称      | 值   | 说明                |
J
junyi233 已提交
1776 1777 1778
| --------- | ---- | ------------------- |
| SINGLETON | 0    | Ability只有一个实例 |
| STANDARD  | 1    | Ability有多个实例   |
W
wanghang 已提交
1779

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

X
xsz233 已提交
1783
Ability组件的子类型。
W
wanghang 已提交
1784

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

J
junyi233 已提交
1787
| 名称        | 值   | 说明                          |
J
junyi233 已提交
1788 1789
| ----------- | ---- | ----------------------------- |
| UNSPECIFIED | 0    | 未定义Ability子类型           |
W
wanghang 已提交
1790
| CA          | 1    | Ability子类型是带有 UI 的服务 |
qq_41863798's avatar
api 9  
qq_41863798 已提交
1791

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

X
xsz233 已提交
1795
应用、卡片等的颜色模式。
qq_41863798's avatar
qq_41863798 已提交
1796 1797 1798

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

J
junyi233 已提交
1799
| 名称       | 值   | 说明     |
J
junyi233 已提交
1800
| ---------- | ---- | -------- |
H
HelloCrease 已提交
1801
| AUTO_MODE  | -1   | 自动模式 |
qq_41863798's avatar
qq_41863798 已提交
1802 1803
| DARK_MODE  | 0    | 黑色模式 |
| LIGHT_MODE | 1    | 亮度模式 |
qq_41863798's avatar
qq_41863798 已提交
1804 1805


W
wanghang 已提交
1806 1807 1808
## GrantStatus<sup>deprecated<sup>

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

X
xsz233 已提交
1810
权限授予状态。
qq_41863798's avatar
qq_41863798 已提交
1811 1812 1813

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

J
junyi233 已提交
1814
| 名称               | 值   | 说明         |
J
junyi233 已提交
1815 1816
| ------------------ | ---- | ------------ |
| PERMISSION_DENIED  | -1   | 拒绝授予权限 |
1817
| PERMISSION_GRANTED | 0    | 授予权限     |