1# @ohos.bundle (Bundle模块) 2 3本模块提供应用信息查询能力，支持[包信息](js-apis-bundle-BundleInfo.md)、[应用信息](js-apis-bundle-ApplicationInfo.md)、[Ability组件信息](js-apis-bundle-AbilityInfo.md)等信息的查询，以及应用禁用状态的查询、设置等。 4 5> **说明：** 6> 7> 本模块首批接口从API version 7开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。 8> 9> 从API Version 9开始，该模块不再维护，建议使用[@ohos.bundle.bundleManager](js-apis-bundleManager.md)替代。 10 11## 导入模块 12 13```ts 14import bundle from '@ohos.bundle'; 15``` 16 17## 权限列表 18 19| 权限 | 权限等级 | 描述 | 20|--------------------------------------------|--------------|---------------| 21| ohos.permission.GET_BUNDLE_INFO | normal | 查询指定应用信息。 | 22| ohos.permission.GET_BUNDLE_INFO_PRIVILEGED | system_basic | 可查询所有应用信息。 | 23 24权限等级参考[权限APL等级说明](../../security/AccessToken/app-permission-mgmt-overview.md#权限机制中的基本概念)。 25 26## bundle.getApplicationInfo<sup>deprecated<sup> 27 28> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getApplicationInfo](js-apis-bundleManager-sys.md#bundlemanagergetapplicationinfo-2)替代。<!--DelEnd--> 29 30getApplicationInfo(bundleName: string, bundleFlags: number, userId?: number): Promise\<ApplicationInfo> 31 32根据给定的Bundle名称获取ApplicationInfo。使用Promise异步回调。 33 34获取调用方自己的信息时不需要权限。 35 36**需要权限：** 37 38ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 39 40**系统能力：** 41 42SystemCapability.BundleManager.BundleFramework 43 44**参数：** 45 46| 参数名 | 类型 | 必填 | 说明 | 47| ----------- | ------ | ---- | ------------------------------------------------------------ | 48| bundleName | string | 是 | 要查询的应用Bundle名称。 | 49| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围请参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 | 50| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 51 52**返回值：** 53 54| 类型 | 说明 | 55| ------------------------- | ------------------ | 56| Promise\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | Promise形式返回应用程序信息。 | 57 58**示例：** 59 60```ts 61import bundle from '@ohos.bundle'; 62import { BusinessError } from '@ohos.base'; 63 64let bundleName: string = "com.example.myapplication"; 65let bundleFlags: number = 0; 66let userId: number = 100; 67 68bundle.getApplicationInfo(bundleName, bundleFlags, userId) 69 .then((data) => { 70 console.info('Operation successful. Data: ' + JSON.stringify(data)); 71 }).catch((error: BusinessError) => { 72 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 73 }) 74``` 75 76## bundle.getApplicationInfo<sup>deprecated<sup> 77 78> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getApplicationInfo](js-apis-bundleManager-sys.md#bundlemanagergetapplicationinfo)替代。<!--DelEnd--> 79 80getApplicationInfo(bundleName: string, bundleFlags: number, userId: number, callback: AsyncCallback\<ApplicationInfo>): void 81 82根据给定的Bundle名称获取指定用户下的ApplicationInfo，使用callback异步回调。 83 84获取调用方自己的信息时不需要权限。 85 86**需要权限：** 87 88ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 89 90**系统能力：** 91 92SystemCapability.BundleManager.BundleFramework 93 94**参数：** 95 96| 参数名 | 类型 | 必填 | 说明 | 97| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 98| bundleName | string | 是 | 要查询的应用Bundle名称。 | 99| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 | 100| userId | number | 是 | 用户ID。取值范围：大于等于0。 | 101| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 | 102 103**示例：** 104 105```ts 106import bundle from '@ohos.bundle'; 107 108let bundleName: string = "com.example.myapplication"; 109let bundleFlags: number = 0; 110let userId: number = 100; 111 112bundle.getApplicationInfo(bundleName, bundleFlags, userId, (err, data) => { 113 if (err) { 114 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 115 return; 116 } 117 console.info('Operation successful. Data:' + JSON.stringify(data)); 118}) 119``` 120 121## bundle.getApplicationInfo<sup>deprecated<sup> 122 123> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getApplicationInfo](js-apis-bundleManager-sys.md#bundlemanagergetapplicationinfo-1)替代。<!--DelEnd--> 124 125 126getApplicationInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<ApplicationInfo>): void 127 128根据给定的Bundle名称获取ApplicationInfo，使用callback异步回调。 129 130获取调用方自己的信息时不需要权限。 131 132**需要权限：** 133 134ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 135 136**系统能力：** 137 138SystemCapability.BundleManager.BundleFramework 139 140**参数：** 141 142| 参数名 | 类型 | 必填 | 说明 | 143| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 144| bundleName | string | 是 | 要查询的应用Bundle名称。 | 145| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 | 146| callback | AsyncCallback\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)> | 是 | 程序启动作为入参的回调函数，返回应用程序信息。 | 147 148**示例：** 149 150```ts 151import bundle from '@ohos.bundle'; 152 153let bundleName: string = "com.example.myapplication"; 154let bundleFlags: number = 0; 155 156bundle.getApplicationInfo(bundleName, bundleFlags, (err, data) => { 157 if (err) { 158 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 159 return; 160 } 161 console.info('Operation successful. Data:' + JSON.stringify(data)); 162}) 163``` 164 165 166## bundle.getAllBundleInfo<sup>deprecated<sup> 167 168> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getAllBundleInfo](js-apis-bundleManager-sys.md#bundlemanagergetallbundleinfo-2)替代。<!--DelEnd--> 169 170getAllBundleInfo(bundleFlag: BundleFlag, userId?: number): Promise\<Array\<BundleInfo\>\> 171 172获取指定用户所有的BundleInfo，使用Promise形式异步回调。 173 174**需要权限：** 175 176ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 177 178**系统能力：** 179 180SystemCapability.BundleManager.BundleFramework 181 182**参数：** 183 184| 参数名 | 类型 | 必填 | 说明 | 185| ---------- | ---------- | ---- | ------------------------------------------------------------ | 186| bundleFlag | BundleFlag | 是 | 用于指定返回的包信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 | 187| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 188 189**返回值：** 190 191| 类型 | 说明 | 192| --------------------------- | -------------------------- | 193| Promise<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | Promise形式返回所有可用的BundleInfo | 194 195**示例：** 196 197```ts 198import bundle from '@ohos.bundle'; 199import { BusinessError } from '@ohos.base'; 200 201let bundleFlag: number = 0; 202let userId: number = 100; 203 204bundle.getAllBundleInfo(bundleFlag, userId) 205 .then((data) => { 206 console.info('Operation successful. Data: ' + JSON.stringify(data)); 207 }).catch((error: BusinessError) => { 208 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 209 }) 210``` 211 212## bundle.getAllBundleInfo<sup>deprecated<sup> 213 214> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getAllBundleInfo](js-apis-bundleManager-sys.md#bundlemanagergetallbundleinfo-1)替代。<!--DelEnd--> 215 216 217getAllBundleInfo(bundleFlag: BundleFlag, callback: AsyncCallback\<Array\<BundleInfo\>\>): void 218 219获取当前用户所有的BundleInfo，使用callback异步回调。 220 221**需要权限：** 222 223ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 224 225**系统能力：** 226 227SystemCapability.BundleManager.BundleFramework 228 229**参数：** 230 231| 参数名 | 类型 | 必填 | 说明 | 232| ---------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 233| bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 | 234| callback | AsyncCallback<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回所有可用的BundleInfo。 | 235 236**示例：** 237 238```ts 239import bundle from '@ohos.bundle'; 240 241let bundleFlag: number = 0; 242 243bundle.getAllBundleInfo(bundleFlag, (err, data) => { 244 if (err) { 245 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 246 return; 247 } 248 console.info('Operation successful. Data:' + JSON.stringify(data)); 249}) 250``` 251 252## bundle.getAllBundleInfo<sup>deprecated<sup> 253 254> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getAllBundleInfo](js-apis-bundleManager-sys.md#bundlemanagergetallbundleinfo)替代。<!--DelEnd--> 255 256 257getAllBundleInfo(bundleFlag: BundleFlag, userId: number, callback: AsyncCallback\<Array\<BundleInfo\>\>): void 258 259获取系统中指定用户下所有的BundleInfo，使用callback异步回调。 260 261**需要权限：** 262 263ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 264 265**系统能力：** 266 267SystemCapability.BundleManager.BundleFramework 268 269**参数：** 270 271| 参数名 | 类型 | 必填 | 说明 | 272|------------|-------------------------------------------------------------------|-----|---------------------------------------------------------------------| 273| bundleFlag | BundleFlag | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 | 274| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 275| callback | AsyncCallback<Array\<[BundleInfo](js-apis-bundle-BundleInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回指定用户下所有包的BundleInfo。 | 276 277**示例：** 278 279```ts 280import bundle from '@ohos.bundle'; 281 282let bundleFlag: number = 0; 283let userId: number = 100; 284 285bundle.getAllBundleInfo(bundleFlag, userId, (err, data) => { 286 if (err) { 287 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 288 return; 289 } 290 console.info('Operation successful. Data:' + JSON.stringify(data)); 291}) 292``` 293 294## bundle.getBundleInfo<sup>deprecated<sup> 295 296> 从API version 9开始不再维护，建议使用[bundleManager.getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo14-2)替代。 297 298 299getBundleInfo(bundleName: string, bundleFlags: number, options?: BundleOptions): Promise\<BundleInfo> 300 301根据给定的Bundle名称获取BundleInfo，使用Promise异步回调。 302 303获取调用方自己的信息时不需要权限。 304 305**需要权限：** 306 307ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 308 309**系统能力：** 310 311SystemCapability.BundleManager.BundleFramework 312 313**参数：** 314 315| 参数名 | 类型 | 必填 | 说明 | 316| ----------- | ------------- | ---- |---------------------------------------------------------------------| 317| bundleName | string | 是 | 要查询的应用Bundle名称。 | 318| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 | 319| options | [BundleOptions](#bundleoptionsdeprecated) | 否 | 包含userid的查询选项。 | 320 321**返回值：** 322 323| 类型 | 说明 | 324| -------------------- | ---------------------------- | 325| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | Promise对象，获取成功时返回包信息。 | 326 327**示例：** 328 329```ts 330import bundle from '@ohos.bundle'; 331import { BusinessError } from '@ohos.base'; 332 333let bundleName: string = "com.example.myapplication"; 334let bundleFlags: number = 1; 335let options: bundle.BundleOptions = { 336 "userId": 100 337}; 338 339bundle.getBundleInfo(bundleName, bundleFlags, options) 340 .then((data) => { 341 console.info('Operation successful. Data: ' + JSON.stringify(data)); 342 }).catch((error: BusinessError) => { 343 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 344 }) 345``` 346 347## bundle.getBundleInfo<sup>deprecated<sup> 348 349> 从API version 9开始不再维护，建议使用[bundleManager.getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo14-1)替代。 350 351getBundleInfo(bundleName: string, bundleFlags: number, callback: AsyncCallback\<BundleInfo>): void 352 353根据给定的Bundle名称获取BundleInfo，使用callback异步回调。 354 355获取调用方自己的信息时不需要权限。 356 357**需要权限：** 358 359ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 360 361**系统能力：** 362 363SystemCapability.BundleManager.BundleFramework 364 365**参数：** 366 367| 参数名 | 类型 | 必填 | 说明 | 368| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ | 369| bundleName | string | 是 | 需要查询的应用Bundle名称。 | 370| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 | 371| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 | 372 373**示例：** 374 375```ts 376import bundle from '@ohos.bundle'; 377 378let bundleName: string = "com.example.myapplication"; 379let bundleFlags: number = 1; 380 381bundle.getBundleInfo(bundleName, bundleFlags, (err, data) => { 382 if (err) { 383 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 384 return; 385 } 386 console.info('Operation successful. Data:' + JSON.stringify(data)); 387}) 388``` 389 390## bundle.getBundleInfo<sup>deprecated<sup> 391 392> 从API version 9开始不再维护，建议使用[bundleManager.getBundleInfo](js-apis-bundleManager.md#bundlemanagergetbundleinfo14)替代。 393 394getBundleInfo(bundleName: string, bundleFlags: number, options: BundleOptions, callback: AsyncCallback\<BundleInfo>): void 395 396根据给定的Bundle名称获取BundleInfo，使用callback异步回调。 397 398获取调用方自己的信息时不需要权限。 399 400**需要权限：** 401 402ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 403 404**系统能力：** 405 406SystemCapability.BundleManager.BundleFramework 407 408**参数：** 409 410| 参数名 | 类型 | 必填 | 说明 | 411| ----------- | ---------------------------------------------------------- | ---- | ------------------------------------------------------------ | 412| bundleName | string | 是 | 要查询的应用Bundle名称。 | 413| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 | 414| options | [BundleOptions](#bundleoptionsdeprecated) | 是 | 包含userid。 | 415| callback | AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回包信息。 | 416 417**示例：** 418 419```ts 420import bundle from '@ohos.bundle'; 421 422let bundleName: string = "com.example.myapplication"; 423let bundleFlags: number = 1; 424let options: bundle.BundleOptions = { 425 "userId": 100 426}; 427 428bundle.getBundleInfo(bundleName, bundleFlags, options, (err, data) => { 429 if (err) { 430 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 431 return; 432 } 433 console.info('Operation successful. Data:' + JSON.stringify(data)); 434}) 435``` 436 437## bundle.getAllApplicationInfo<sup>deprecated<sup> 438 439> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getAllApplicationInfo](js-apis-bundleManager-sys.md#bundlemanagergetallapplicationinfo-2)替代。<!--DelEnd--> 440 441getAllApplicationInfo(bundleFlags: number, userId?: number): Promise\<Array\<ApplicationInfo\>\> 442 443获取指定用户下所有已安装的应用信息，使用promise异步回调。 444 445**需要权限：** 446 447ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 448 449**系统能力：** 450 451SystemCapability.BundleManager.BundleFramework 452 453**参数：** 454 455| 参数名 | 类型 | 必填 | 说明 | 456| ----------- | ------ | ---- | ------------------------------------------------------------ | 457| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 | 458| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 459 460**返回值：** 461 462| 类型 | 说明 | 463| -------------------------------- | ------------------------------- | 464| Promise<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | Promise对象，获取成功时返回应用信息列表。 | 465 466**示例：** 467 468```ts 469import bundle from '@ohos.bundle'; 470import { BusinessError } from '@ohos.base'; 471 472let bundleFlags: number = 8; 473let userId: number = 100; 474 475bundle.getAllApplicationInfo(bundleFlags, userId) 476 .then((data) => { 477 console.info('Operation successful. Data: ' + JSON.stringify(data)); 478 }).catch((error: BusinessError) => { 479 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 480 }) 481``` 482 483## bundle.getAllApplicationInfo<sup>deprecated<sup> 484 485> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getAllApplicationInfo](js-apis-bundleManager-sys.md#bundlemanagergetallapplicationinfo)替代。<!--DelEnd--> 486 487getAllApplicationInfo(bundleFlags: number, userId: number, callback: AsyncCallback\<Array\<ApplicationInfo\>\>): void 488 489获取指定用户下所有已安装的应用信息，使用callback异步回调。 490 491**需要权限：** 492 493ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 494 495**系统能力：** 496 497SystemCapability.BundleManager.BundleFramework 498 499**参数：** 500 501| 参数名 | 类型 | 必填 | 说明 | 502| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 503| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 | 504| userId | number | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 505| callback | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回应用信息列表。 | 506 507**示例：** 508 509```ts 510import bundle from '@ohos.bundle'; 511 512let bundleFlags: number = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION; 513let userId: number = 100; 514 515bundle.getAllApplicationInfo(bundleFlags, userId, (err, data) => { 516 if (err) { 517 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 518 return; 519 } 520 console.info('Operation successful. Data:' + JSON.stringify(data)); 521}) 522``` 523 524 525## bundle.getAllApplicationInfo<sup>deprecated<sup> 526 527> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getAllApplicationInfo](js-apis-bundleManager-sys.md#bundlemanagergetallapplicationinfo-1)替代。<!--DelEnd--> 528 529getAllApplicationInfo(bundleFlags: number, callback: AsyncCallback\<Array\<ApplicationInfo\>\>): void 530 531获取调用方所在用户下已安装的应用信息，使用callback异步回调。 532 533**需要权限：** 534 535ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 536 537**系统能力：** 538 539SystemCapability.BundleManager.BundleFramework 540 541**参数：** 542 543| 参数名 | 类型 | 必填 | 说明 | 544| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 545| bundleFlags | number | 是 | 用于指定返回的应用信息对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中应用信息相关flag。 | 546| callback | AsyncCallback<Array\<[ApplicationInfo](js-apis-bundle-ApplicationInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回应用信息列表。 | 547 548**示例：** 549 550```ts 551import bundle from '@ohos.bundle'; 552 553let bundleFlags: number = bundle.BundleFlag.GET_APPLICATION_INFO_WITH_PERMISSION; 554 555bundle.getAllApplicationInfo(bundleFlags, (err, data) => { 556 if (err) { 557 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 558 return; 559 } 560 console.info('Operation successful. Data:' + JSON.stringify(data)); 561}) 562``` 563 564## bundle.getBundleArchiveInfo<sup>deprecated<sup> 565 566> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getBundleArchiveInfo](js-apis-bundleManager-sys.md#bundlemanagergetbundlearchiveinfo-1)替代。<!--DelEnd--> 567 568getBundleArchiveInfo(hapFilePath: string, bundleFlags: number) : Promise\<BundleInfo> 569 570获取有关HAP中包含的应用程序包的信息，使用Promise异步回调。 571 572**系统能力：** 573 574SystemCapability.BundleManager.BundleFramework 575 576**参数：** 577 578| 参数名 | 类型 | 必填 | 说明 | 579| ---------- | ------ | ---- | ------------ | 580| hapFilePath | string | 是 | HAP存放路径。支持当前应用程序的绝对路径和数据目录沙箱路径。 | 581| bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 | 582 583**返回值：** 584| 类型 | 说明 | 585| ---------------------------------------------------- | ------------------------------------------------------------ | 586| Promise\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 返回值为Promise对象，Promise中包含有关HAP中包含的应用程序的信息。 | 587 588**示例：** 589 590```ts 591import bundle from '@ohos.bundle'; 592import { BusinessError } from '@ohos.base'; 593 594let hapFilePath: string = "/data/storage/el2/base/test.hap"; 595let bundleFlags: number = 0; 596 597bundle.getBundleArchiveInfo(hapFilePath, bundleFlags) 598 .then((data) => { 599 console.info('Operation successful. Data: ' + JSON.stringify(data)); 600 }).catch((error: BusinessError) => { 601 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 602 }) 603``` 604 605## bundle.getBundleArchiveInfo<sup>deprecated<sup> 606 607> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getBundleArchiveInfo](js-apis-bundleManager-sys.md#bundlemanagergetbundlearchiveinfo)替代。<!--DelEnd--> 608 609getBundleArchiveInfo(hapFilePath: string, bundleFlags: number, callback: AsyncCallback\<BundleInfo>) : void 610 611获取有关HAP中包含的应用程序包的信息，使用callback异步回调。 612 613**系统能力：** 614 615SystemCapability.BundleManager.BundleFramework 616 617**参数：** 618 619| 参数名 | 类型 | 必填 | 说明 | 620| ---------- | ------ | ---- | ------------ | 621| hapFilePath | string | 是 | HAP存放路径，支持当前应用程序的绝对路径和数据目录沙箱路径。 | 622| bundleFlags | number | 是 | 用于指定要返回的BundleInfo对象中包含信息的标记。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中包信息相关flag。 | 623| callback| AsyncCallback\<[BundleInfo](js-apis-bundle-BundleInfo.md)> | 是 | 程序启动作为入参的回调函数，返回HAP中包含的应用程序包的信息。 | 624 625**示例：** 626 627```ts 628import bundle from '@ohos.bundle'; 629 630let hapFilePath: string = "/data/storage/el2/base/test.hap"; 631let bundleFlags: number = 0; 632 633bundle.getBundleArchiveInfo(hapFilePath, bundleFlags, (err, data) => { 634 if (err) { 635 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 636 return; 637 } 638 console.info('Operation successful. Data:' + JSON.stringify(data)); 639}) 640``` 641 642## bundle.getAbilityInfo<sup>deprecated<sup> 643 644> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.queryAbilityInfo](js-apis-bundleManager-sys.md#bundlemanagerqueryabilityinfo-2)替代。<!--DelEnd--> 645 646getAbilityInfo(bundleName: string, abilityName: string): Promise\<AbilityInfo> 647 648通过Bundle名称和组件名获取Ability组件信息，使用Promise形式异步回调。 649 650获取调用方自己的信息时不需要权限。 651 652**需要权限：** 653 654ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 655 656**系统能力：** 657 658SystemCapability.BundleManager.BundleFramework 659 660**参数：** 661 662| 参数名 | 类型 | 必填 | 说明 | 663| ----------- | ------ | ---- |------------| 664| bundleName | string | 是 | 应用Bundle名称。 | 665| abilityName | string | 是 | Ability组件名称。 | 666 667**返回值：** 668 669| 类型 | 说明 | 670| --------------------- | --------------------- | 671| Promise\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | Promise形式返回Ability信息。 | 672 673**示例：** 674 675```ts 676import bundle from '@ohos.bundle'; 677import { BusinessError } from '@ohos.base'; 678 679let bundleName: string = "com.example.myapplication"; 680let abilityName: string = "EntryAbility"; 681 682bundle.getAbilityInfo(bundleName, abilityName) 683 .then((data) => { 684 console.info('Operation successful. Data: ' + JSON.stringify(data)); 685 }).catch((error: BusinessError) => { 686 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 687 }) 688``` 689 690## bundle.getAbilityInfo<sup>deprecated<sup> 691 692> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.queryAbilityInfo](js-apis-bundleManager-sys.md#bundlemanagerqueryabilityinfo)替代。<!--DelEnd--> 693 694getAbilityInfo(bundleName: string, abilityName: string, callback: AsyncCallback\<AbilityInfo>): void 695 696通过Bundle名称和组件名获取Ability组件信息，使用callback异步回调。 697 698获取调用方自己的信息时不需要权限。 699 700**需要权限：** 701 702ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 703 704**系统能力：** 705 706SystemCapability.BundleManager.BundleFramework 707 708**参数：** 709 710| 参数名 | 类型 | 必填 | 说明 | 711| ----------- | ------------ | ---- |----------------------------| 712| bundleName | string | 是 | 应用Bundle名称。 | 713| abilityName | string | 是 | Ability名称。 | 714| callback | AsyncCallback\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | 715 716**示例：** 717 718```ts 719import bundle from '@ohos.bundle'; 720 721let bundleName: string = "com.example.myapplication"; 722let abilityName: string = "EntryAbility"; 723 724bundle.getAbilityInfo(bundleName, abilityName, (err, data) => { 725 if (err) { 726 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 727 return; 728 } 729 console.info('Operation successful. Data:' + JSON.stringify(data)); 730}) 731``` 732 733## bundle.getAbilityLabel<sup>8+</sup> <sup>deprecated<sup> 734 735> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getAbilityLabel](js-apis-bundleManager-sys.md#bundlemanagergetabilitylabel-1)替代。<!--DelEnd--> 736 737getAbilityLabel(bundleName: string, abilityName: string): Promise\<string> 738 739通过Bundle名称和ability名称获取应用名称，使用Promise异步回调。 740 741获取调用方自己的信息时不需要权限。 742 743**需要权限：** 744 745ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 746 747**系统能力：** 748 749SystemCapability.BundleManager.BundleFramework 750 751**参数：** 752 753| 参数名 | 类型 | 必填 | 说明 | 754| ----------- | ------ | ---- | ---------------- | 755| bundleName | string | 是 | 应用Bundle名称。 | 756| abilityName | string | 是 | Ability名称。 | 757 758**返回值：** 759 760| 类型 | 说明 | 761| ---------------- | ------------------ | 762| Promise\<string> | Promise形式返回应用名称信息。 | 763 764**示例：** 765 766```ts 767import bundle from '@ohos.bundle'; 768import { BusinessError } from '@ohos.base'; 769 770let bundleName: string = "com.example.myapplication"; 771let abilityName: string = "EntryAbility"; 772 773bundle.getAbilityLabel(bundleName, abilityName) 774 .then((data) => { 775 console.info('Operation successful. Data: ' + JSON.stringify(data)); 776 }).catch((error: BusinessError) => { 777 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 778 }) 779``` 780 781## bundle.getAbilityLabel<sup>8+</sup> <sup>deprecated<sup> 782 783> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getAbilityLabel](js-apis-bundleManager-sys.md#bundlemanagergetabilitylabel)替代。<!--DelEnd--> 784 785getAbilityLabel(bundleName: string, abilityName: string, callback : AsyncCallback\<string>): void 786 787通过Bundle名称和Ability组件名获取应用名称，使用callback异步回调。 788 789获取调用方自己的信息时不需要权限。 790 791**需要权限：** 792 793ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 794 795**系统能力：** 796 797SystemCapability.BundleManager.BundleFramework 798 799**参数：** 800 801| 参数名 | 类型 | 必填 | 说明 | 802| ----------- | ---------------------- | ---- | ---------------------------------------------- | 803| bundleName | string | 是 | 应用Bundle名称。 | 804| abilityName | string | 是 | Ability名称。 | 805| callback | AsyncCallback\<string> | 是 | 程序启动作为入参的回调函数，返回应用名称信息。 | 806 807**示例：** 808 809```ts 810import bundle from '@ohos.bundle'; 811 812let bundleName: string = "com.example.myapplication"; 813let abilityName: string = "EntryAbility"; 814 815bundle.getAbilityLabel(bundleName, abilityName, (err, data) => { 816 if (err) { 817 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 818 return; 819 } 820 console.info('Operation successful. Data:' + JSON.stringify(data)); 821}) 822``` 823 824## bundle.isAbilityEnabled<sup>8+</sup> <sup>deprecated<sup> 825 826> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.isAbilityEnabled](js-apis-bundleManager-sys.md#bundlemanagerisabilityenabled-1)替代。<!--DelEnd--> 827 828isAbilityEnabled(info: AbilityInfo): Promise\<boolean> 829 830根据给定的AbilityInfo查询ability是否已经启用，使用Promise异步回调。 831 832**系统能力：** 833 834SystemCapability.BundleManager.BundleFramework 835 836**参数：** 837 838| 参数名 | 类型 | 必填 | 说明 | 839| ------ | -------------------------------------------- | ---- | ----------------- | 840| info | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是 | Ability的配置信息。 | 841 842**返回值：** 843 844| 类型 | 说明 | 845| ----------------- | ------------------------- | 846| Promise\<boolean> | Promise形式返回boolean代表是否启用。 | 847 848**示例：** 849 850```ts 851import bundle from '@ohos.bundle'; 852import { BusinessError } from '@ohos.base'; 853 854let bundleName: string = "com.example.myapplication"; 855let abilityName: string = "EntryAbility"; 856 857bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo) => { 858 bundle.isAbilityEnabled(abilityInfo).then((data) => { 859 console.info('Operation successful. Data: ' + JSON.stringify(data)); 860 }).catch((error: BusinessError) => { 861 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 862 }) 863}) 864``` 865 866## bundle.isAbilityEnabled<sup>8+</sup> <sup>deprecated<sup> 867 868> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.isAbilityEnabled](js-apis-bundleManager-sys.md#bundlemanagerisabilityenabled)替代。<!--DelEnd--> 869 870isAbilityEnabled(info : AbilityInfo, callback : AsyncCallback\<boolean>): void 871 872根据给定的AbilityInfo查询ability是否已经启用，使用callback异步回调。 873 874**系统能力：** 875 876SystemCapability.BundleManager.BundleFramework 877 878**参数：** 879 880| 参数名 | 类型 | 必填 | 说明 | 881| -------- | -------------------------------------------- | ---- | ----------------------- | 882| info | [AbilityInfo](js-apis-bundle-AbilityInfo.md) | 是 | Ability的配置信息。 | 883| callback | AsyncCallback\<boolean> | 是 | 回调函数，返回boolean代表是否启用。 | 884 885**示例：** 886 887```ts 888import bundle from '@ohos.bundle'; 889 890let bundleName: string = "com.example.myapplication"; 891let abilityName: string = "EntryAbility"; 892 893bundle.getAbilityInfo(bundleName, abilityName).then((abilityInfo) => { 894 bundle.isAbilityEnabled(abilityInfo, (err, data) => { 895 if (err) { 896 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 897 return; 898 } 899 console.info('Operation successful. Data:' + JSON.stringify(data)); 900 }) 901}) 902``` 903 904## bundle.isApplicationEnabled<sup>8+</sup> <sup>deprecated<sup> 905 906> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.isApplicationEnabled](js-apis-bundleManager-sys.md#bundlemanagerisapplicationenabled-1)替代。<!--DelEnd--> 907 908isApplicationEnabled(bundleName: string): Promise\<boolean> 909 910根据给定的bundleName查询指定应用程序是否已经启用，使用Promise异步回调。 911 912**系统能力：** 913 914SystemCapability.BundleManager.BundleFramework 915 916**参数：** 917 918| 参数名 | 类型 | 必填 | 说明 | 919| ---------- | ------ | ---- | ------------------------ | 920| bundleName | string | 是 | 要查询的应用Bundle名称。 | 921 922**返回值：** 923 924| 类型 | 说明 | 925| ----------------- | ------------------------- | 926| Promise\<boolean> | Promise形式返回boolean代表是否启用。 | 927 928**示例：** 929 930```ts 931import bundle from '@ohos.bundle'; 932import { BusinessError } from '@ohos.base'; 933 934let bundleName: string = "com.example.myapplication"; 935 936bundle.isApplicationEnabled(bundleName) 937 .then((data) => { 938 console.info('Operation successful. Data: ' + JSON.stringify(data)); 939 }).catch((error: BusinessError) => { 940 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 941 }) 942``` 943 944## bundle.isApplicationEnabled<sup>8+</sup> <sup>deprecated<sup> 945 946> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.isApplicationEnabled](js-apis-bundleManager-sys.md#bundlemanagerisapplicationenabled)替代。<!--DelEnd--> 947 948isApplicationEnabled(bundleName: string, callback : AsyncCallback\<boolean>): void 949 950根据给定的bundleName查询指定应用程序是否已经启用，使用callback异步回调。 951 952**系统能力：** 953 954SystemCapability.BundleManager.BundleFramework 955 956**参数：** 957 958| 参数名 | 类型 | 必填 | 说明 | 959| ---------- | ----------------------- | ---- | ------------------------ | 960| bundleName | string | 是 | 要查询的应用Bundle名称。 | 961| callback | AsyncCallback\<boolean> | 是 | 回调函数，返回boolean代表是否启用。 | 962 963**示例：** 964 965```ts 966import bundle from '@ohos.bundle'; 967 968let bundleName: string = "com.example.myapplication"; 969 970bundle.isApplicationEnabled(bundleName, (err, data) => { 971 if (err) { 972 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 973 return; 974 } 975 console.info('Operation successful. Data:' + JSON.stringify(data)); 976}) 977``` 978 979## bundle.queryAbilityByWant<sup>deprecated<sup> 980 981> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.queryAbilityInfo](js-apis-bundleManager-sys.md#bundlemanagerqueryabilityinfo12)替代。<!--DelEnd--> 982 983queryAbilityByWant(want: Want, bundleFlags: number, userId?: number): Promise\<Array\<AbilityInfo\>\> 984 985根据给定的意图获取Ability组件信息，使用Promise异步回调。 986 987获取调用方自己的信息时不需要权限。 988 989**需要权限：** 990 991ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 992 993**系统能力：** 994 995SystemCapability.BundleManager.BundleFramework 996 997**参数：** 998 999| 参数名 | 类型 | 必填 | 说明 | 1000| ----------- | ------ | ---- | ------------------------------------- | 1001| want | [Want](js-apis-application-want.md) | 是 | 包含要查询的应用Bundle名称的意图。 | 1002| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中Ability信息相关flag。 | 1003| userId | number | 否 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 1004 1005**返回值：** 1006 1007| 类型 | 说明 | 1008| ---------------------------- | --------------------- | 1009| Promise<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | Promise形式返回Ability信息。 | 1010 1011**示例：** 1012 1013```ts 1014import bundle from '@ohos.bundle'; 1015import { BusinessError } from '@ohos.base'; 1016import Want from '@ohos.app.ability.Want'; 1017 1018let bundleFlags: number = 0; 1019let userId: number = 100; 1020let want: Want = { 1021 bundleName: "com.example.myapplication", 1022 abilityName: "EntryAbility" 1023}; 1024 1025bundle.queryAbilityByWant(want, bundleFlags, userId) 1026 .then((data) => { 1027 console.info('Operation successful. Data: ' + JSON.stringify(data)); 1028 }).catch((error: BusinessError) => { 1029 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 1030 }) 1031``` 1032 1033 1034 1035## bundle.queryAbilityByWant<sup>deprecated<sup> 1036 1037> 从API version 9开始不再维护。 1038 1039queryAbilityByWant(want: Want, bundleFlags: number, userId: number, callback: AsyncCallback\<Array\<AbilityInfo\>\>): void 1040 1041根据给定的意图获取指定用户下Ability信息，使用callback异步回调。 1042 1043获取调用方自己的信息时不需要权限。 1044 1045**需要权限：** 1046 1047ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 1048 1049**系统能力：** 1050 1051SystemCapability.BundleManager.BundleFramework 1052 1053**参数：** 1054 1055| 参数名 | 类型 | 必填 | 说明 | 1056| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1057| want | [Want](js-apis-application-want.md) | 是 | 指示包含要查询的应用Bundle名称的意图。 | 1058| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中Ability信息相关flag。 | 1059| userId | number | 是 | 用户ID。取值范围：大于等于0。 | 1060| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | 1061 1062**示例：** 1063 1064```ts 1065import bundle from '@ohos.bundle'; 1066import Want from '@ohos.app.ability.Want'; 1067 1068let bundleFlags: number = 0; 1069let userId: number = 100; 1070let want: Want = { 1071 bundleName: "com.example.myapplication", 1072 abilityName: "EntryAbility" 1073}; 1074 1075bundle.queryAbilityByWant(want, bundleFlags, userId, (err, data) => { 1076 if (err) { 1077 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 1078 return; 1079 } 1080 console.info('Operation successful. Data:' + JSON.stringify(data)); 1081}) 1082``` 1083 1084## bundle.queryAbilityByWant<sup>deprecated<sup> 1085 1086> 从API version 9开始不再维护。 1087 1088queryAbilityByWant(want: Want, bundleFlags: number, callback: AsyncCallback\<Array\<AbilityInfo\>\>): void 1089 1090根据给定的意图获取Ability信息，使用callback异步回调。 1091 1092获取调用方自己的信息时不需要权限。 1093 1094**需要权限：** 1095 1096ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 1097 1098**系统能力：** 1099 1100SystemCapability.BundleManager.BundleFramework 1101 1102**参数：** 1103 1104| 参数名 | 类型 | 必填 | 说明 | 1105| ----------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ | 1106| want | [Want](js-apis-application-want.md) | 是 | 指示包含要查询的应用Bundle名称的意图。 | 1107| bundleFlags | number | 是 | 用于指定返回abilityInfo信息。取值范围：参考[BundleFlag说明](#bundleflagdeprecated)中Ability信息相关flag。 | 1108| callback | AsyncCallback<Array\<[AbilityInfo](js-apis-bundle-AbilityInfo.md)>> | 是 | 程序启动作为入参的回调函数，返回Ability信息。 | 1109 1110**示例：** 1111 1112```ts 1113import bundle from '@ohos.bundle'; 1114import Want from '@ohos.app.ability.Want'; 1115 1116let bundleFlags: number = 0; 1117let want: Want = { 1118 bundleName: "com.example.myapplication", 1119 abilityName: "EntryAbility" 1120}; 1121 1122bundle.queryAbilityByWant(want, bundleFlags, (err, data) => { 1123 if (err) { 1124 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 1125 return; 1126 } 1127 console.info('Operation successful. Data:' + JSON.stringify(data)); 1128}) 1129``` 1130 1131 1132 1133## bundle.getLaunchWantForBundle<sup>deprecated<sup> 1134 1135> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getLaunchWantForBundle](js-apis-bundleManager-sys.md#bundlemanagergetlaunchwantforbundle-2)替代。<!--DelEnd--> 1136 1137getLaunchWantForBundle(bundleName: string): Promise\<Want> 1138 1139查询拉起指定应用的want对象，使用Promise异步回调。 1140 1141**需要权限：** 1142 1143ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 1144 1145**系统能力：** 1146 1147SystemCapability.BundleManager.BundleFramework 1148 1149**参数：** 1150 1151| 参数名 | 类型 | 必填 | 说明 | 1152| ---------- | ------ | ---- | ------------------------ | 1153| bundleName | string | 是 | 要查询的应用Bundle名称。 | 1154 1155**返回值：** 1156| 类型 | 说明 | 1157| -------------- | -------------------------------------- | 1158| Promise\<[Want](js-apis-application-want.md)> | 返回值为Promise对象，Promise中包含拉起指定应用的Want对象。 | 1159 1160**示例：** 1161 1162```ts 1163import bundle from '@ohos.bundle'; 1164import { BusinessError } from '@ohos.base'; 1165 1166let bundleName: string = "com.example.myapplication"; 1167 1168bundle.getLaunchWantForBundle(bundleName) 1169 .then((data) => { 1170 console.info('Operation successful. Data: ' + JSON.stringify(data)); 1171 }).catch((error: BusinessError) => { 1172 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 1173 }) 1174``` 1175 1176## bundle.getLaunchWantForBundle<sup>deprecated<sup> 1177 1178> 从API version 9开始不再维护，替代接口仅向系统应用开放。<!--Del-->建议使用[bundleManager.getLaunchWantForBundle](js-apis-bundleManager-sys.md#bundlemanagergetlaunchwantforbundle-1)替代。<!--DelEnd--> 1179 1180getLaunchWantForBundle(bundleName: string, callback: AsyncCallback\<Want>): void 1181 1182查询拉起指定应用的want对象，使用callback异步回调。 1183 1184**需要权限：** 1185 1186ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 1187 1188**系统能力：** 1189 1190SystemCapability.BundleManager.BundleFramework 1191 1192**参数：** 1193 1194| 参数名 | 类型 | 必填 | 说明 | 1195| ---------- | --------------------------------------------------- | ---- | -------------------------------------------------------- | 1196| bundleName | string | 是 | 要查询的应用Bundle名称。 | 1197| callback | AsyncCallback\<[Want](js-apis-application-want.md)> | 是 | 程序启动作为入参的回调函数，返回拉起指定应用的want对象。 | 1198 1199**示例：** 1200 1201```ts 1202import bundle from '@ohos.bundle'; 1203 1204let bundleName: string = "com.example.myapplication"; 1205 1206bundle.getLaunchWantForBundle(bundleName, (err, data) => { 1207 if (err) { 1208 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 1209 return; 1210 } 1211 console.info('Operation successful. Data:' + JSON.stringify(data)); 1212}) 1213``` 1214 1215 1216## bundle.getNameForUid<sup>8+</sup> <sup>deprecated<sup> 1217 1218> 从API version 9开始不再维护，建议使用[bundleManager.getBundleNameByUid](js-apis-bundleManager.md#bundlemanagergetbundlenamebyuid14-1)替代。 1219 1220getNameForUid(uid: number): Promise\<string> 1221 1222通过uid获取对应的Bundle名称，使用Promise异步回调。 1223 1224**系统能力：** 1225 1226SystemCapability.BundleManager.BundleFramework 1227 1228**参数：** 1229 1230| 参数名 | 类型 | 必填 | 说明 | 1231| ------ | ------ | ---- | ------------- | 1232| uid | number | 是 | 要查询的uid。 | 1233 1234**返回值：** 1235| 类型 | 说明 | 1236| ---------------- | --------------------------------- | 1237| Promise\<string> | 返回值为Promise对象，Promise中包含指定uid的Bundle名称。 | 1238 1239**示例：** 1240 1241```ts 1242import bundle from '@ohos.bundle'; 1243import { BusinessError } from '@ohos.base'; 1244 1245let uid: number = 20010005; 1246 1247bundle.getNameForUid(uid) 1248 .then((data) => { 1249 console.info('Operation successful. Data: ' + JSON.stringify(data)); 1250 }).catch((error: BusinessError) => { 1251 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 1252 }) 1253``` 1254 1255## bundle.getNameForUid<sup>8+</sup> <sup>deprecated<sup> 1256 1257> 从API version 9开始不再维护，建议使用[bundleManager.getBundleNameByUid](js-apis-bundleManager.md#bundlemanagergetbundlenamebyuid14)替代。 1258 1259getNameForUid(uid: number, callback: AsyncCallback\<string>) : void 1260 1261通过uid获取对应的Bundle名称，使用callback异步回调。 1262 1263**系统能力：** 1264 1265SystemCapability.BundleManager.BundleFramework 1266 1267**参数：** 1268 1269| 参数名 | 类型 | 必填 | 说明 | 1270| -------- | ---------------------- | ---- | ----------------------------------------------------- | 1271| uid | number | 是 | 要查询的uid。 | 1272| callback | AsyncCallback\<string> | 是 | 程序启动作为入参的回调函数，返回指定uid的Bundle名称。 | 1273 1274**示例：** 1275 1276```ts 1277import bundle from '@ohos.bundle'; 1278 1279let uid: number = 20010005; 1280 1281bundle.getNameForUid(uid, (err, data) => { 1282 if (err) { 1283 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 1284 return; 1285 } 1286 console.info('Operation successful. Data:' + JSON.stringify(data)); 1287}) 1288``` 1289 1290 1291## bundle.getAbilityIcon<sup>8+</sup> <sup>deprecated<sup> 1292 1293> 从API version 9开始不再维护，建议使用[resourceManager.getMediaContent](../apis-localization-kit/js-apis-resource-manager.md#getmediacontent9)替代。 1294 1295getAbilityIcon(bundleName: string, abilityName: string): Promise\<image.PixelMap> 1296 1297通过bundleName和abilityName获取对应Icon的[PixelMap](../apis-image-kit/js-apis-image.md)，使用Promise异步回调。 1298 1299获取调用方自己的信息时不需要权限。 1300 1301**需要权限：** 1302 1303ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 1304 1305**系统能力：** 1306 1307SystemCapability.BundleManager.BundleFramework 1308 1309**参数：** 1310 1311| 参数名 | 类型 | 必填 | 说明 | 1312| ----------- | ------ | ---- | ------------------------ | 1313| bundleName | string | 是 | 要查询的应用Bundle名称。 | 1314| abilityName | string | 是 | 要查询的Ability组件名。 | 1315 1316**返回值：** 1317| 类型 | 说明 | 1318| --------------------- | ------------------------------------------------------------ | 1319| Promise\<image.PixelMap> | 返回值为[PixelMap](../apis-image-kit/js-apis-image.md)。 | 1320 1321**示例：** 1322 1323```ts 1324import bundle from '@ohos.bundle'; 1325import { BusinessError } from '@ohos.base'; 1326 1327let bundleName: string = "com.example.myapplication"; 1328let abilityName: string = "EntryAbility"; 1329 1330bundle.getAbilityIcon(bundleName, abilityName) 1331 .then((data) => { 1332 console.info('Operation successful. Data: ' + JSON.stringify(data)); 1333 }).catch((error: BusinessError) => { 1334 console.error('Operation failed. Cause: ' + JSON.stringify(error)); 1335 }) 1336``` 1337 1338## bundle.getAbilityIcon<sup>8+</sup> <sup>deprecated<sup> 1339 1340> 从API version 9开始不再维护，建议使用[resourceManager.getMediaContent](../apis-localization-kit/js-apis-resource-manager.md#getmediacontent9)替代。 1341 1342getAbilityIcon(bundleName: string, abilityName: string, callback: AsyncCallback\<image.PixelMap>): void 1343 1344通过bundleName和abilityName获取对应Icon的[PixelMap](../apis-image-kit/js-apis-image.md)，使用callback异步回调。 1345 1346获取调用方自己的信息时不需要权限。 1347 1348**需要权限：** 1349 1350ohos.permission.GET_BUNDLE_INFO_PRIVILEGED 或 ohos.permission.GET_BUNDLE_INFO 1351 1352 1353**系统能力：** 1354 1355SystemCapability.BundleManager.BundleFramework 1356 1357**参数：** 1358 1359| 参数名 | 类型 | 必填 | 说明 | 1360| ----------- | ---------------------------------------- | ---- |-------------------------------------------------| 1361| bundleName | string | 是 | 要查询的应用Bundle名称。 | 1362| abilityName | string | 是 | 要查询的Ability组件名。 | 1363| callback | AsyncCallback\<image.PixelMap> | 是 | 程序启动作为入参的回调函数，返回指定[PixelMap](../apis-image-kit/js-apis-image.md)。 | 1364 1365**示例：** 1366 1367```ts 1368import bundle from '@ohos.bundle'; 1369 1370let bundleName: string = "com.example.myapplication"; 1371let abilityName: string = "EntryAbility"; 1372 1373bundle.getAbilityIcon(bundleName, abilityName, (err, data) => { 1374 if (err) { 1375 console.error('Operation failed. Cause: ' + JSON.stringify(err)); 1376 return; 1377 } 1378 console.info('Operation successful. Data:' + JSON.stringify(data)); 1379}) 1380``` 1381 1382## InstallErrorCode<sup>deprecated<sup> 1383> 从API version 9开始不再维护，建议使用[errorcode-bundle](errorcode-bundle.md)替代。 1384 1385 **系统能力：** SystemCapability.BundleManager.BundleFramework 1386 1387| 名称 | 值 | 说明 | 1388| ---------------------------------------------------- | ---- | ------------------------------------------------ | 1389| SUCCESS | 0 | 安装成功。 | 1390| STATUS_INSTALL_FAILURE | 1 | 安装失败（不存在安装的应用）。 | 1391| STATUS_INSTALL_FAILURE_ABORTED | 2 | 安装中止。 | 1392| STATUS_INSTALL_FAILURE_INVALID | 3 | 安装参数无效。 | 1393| STATUS_INSTALL_FAILURE_CONFLICT | 4 | 安装冲突 （常见于升级和已有应用基本信息不一致）。 | 1394| STATUS_INSTALL_FAILURE_STORAGE | 5 | 存储包信息失败。 | 1395| STATUS_INSTALL_FAILURE_INCOMPATIBLE | 6 | 安装不兼容（常见于版本降级安装或者签名信息错误）。 | 1396| STATUS_UNINSTALL_FAILURE | 7 | 卸载失败 （不存在卸载的应用）。 | 1397| STATUS_UNINSTALL_FAILURE_BLOCKED | 8 | 卸载中止 （没有使用）。 | 1398| STATUS_UNINSTALL_FAILURE_ABORTED | 9 | 卸载中止 （参数无效导致）。 | 1399| STATUS_UNINSTALL_FAILURE_CONFLICT | 10 | 卸载冲突 （卸载系统应用失败， 结束应用进程失败）。 | 1400| STATUS_INSTALL_FAILURE_DOWNLOAD_TIMEOUT | 0x0B | 安装失败 （下载超时）。 | 1401| STATUS_INSTALL_FAILURE_DOWNLOAD_FAILED | 0x0C | 安装失败 （下载失败）。 | 1402| STATUS_RECOVER_FAILURE_INVALID<sup>8+</sup> | 0x0D | 恢复预置应用失败。 | 1403| STATUS_ABILITY_NOT_FOUND | 0x40 | Ability未找到。 | 1404| STATUS_BMS_SERVICE_ERROR | 0x41 | BMS服务错误。 | 1405| STATUS_FAILED_NO_SPACE_LEFT<sup>8+</sup> | 0x42 | 设备空间不足。 | 1406| STATUS_GRANT_REQUEST_PERMISSIONS_FAILED<sup>8+</sup> | 0x43 | 应用授权失败。 | 1407| STATUS_INSTALL_PERMISSION_DENIED<sup>8+</sup> | 0x44 | 缺少安装权限。 | 1408| STATUS_UNINSTALL_PERMISSION_DENIED<sup>8+</sup> | 0x45 | 缺少卸载权限。 | 1409 1410## BundleFlag<sup>deprecated<sup> 1411 1412> 从API version 9开始不再维护，建议使用[bundleManager.BundleFlag](js-apis-bundleManager.md#bundleflag)替代。 1413 1414包信息标志，指示需要获取的包信息的内容。 1415 1416当接口与标志不匹配时，该标志会被忽略，例如获取application时使用GET_ABILITY_INFO_WITH_PERMISSION对结果不会产生影响。 1417 1418标志可以叠加使用，例如使用GET_APPLICATION_INFO_WITH_PERMISSION + GET_APPLICATION_INFO_WITH_DISABLE可以使结果同时包含应用权限信息和被禁用的应用信息。 1419 1420 **系统能力：** SystemCapability.BundleManager.BundleFramework 1421 1422| 名称 | 值 | 说明 | 1423| ----------------------------------------------- | ---------- | ------------------------------- | 1424| GET_BUNDLE_DEFAULT | 0x00000000 | 获取默认的应用信息。 | 1425| GET_BUNDLE_WITH_ABILITIES | 0x00000001 | 获取包括Ability信息的包信息。 | 1426| GET_ABILITY_INFO_WITH_PERMISSION | 0x00000002 | 获取包括权限的Ability信息。 | 1427| GET_ABILITY_INFO_WITH_APPLICATION | 0x00000004 | 获取包括Application的ability信息。 | 1428| GET_APPLICATION_INFO_WITH_PERMISSION | 0x00000008 | 获取包括权限的应用信息。 | 1429| GET_BUNDLE_WITH_REQUESTED_PERMISSION | 0x00000010 | 获取包括所需权限的包信息。 | 1430| GET_ABILITY_INFO_WITH_METADATA<sup>8+</sup> | 0x00000020 | 获取ability的元数据信息。 | 1431| GET_APPLICATION_INFO_WITH_METADATA<sup>8+</sup> | 0x00000040 | 获取应用的元数据信息。 | 1432| GET_ABILITY_INFO_SYSTEMAPP_ONLY<sup>8+</sup> | 0x00000080 | 获取仅包括系统应用的ability信息。 | 1433| GET_ABILITY_INFO_WITH_DISABLE<sup>8+</sup> | 0x00000100 | 获取包括被禁用的ability信息。 | 1434| GET_APPLICATION_INFO_WITH_DISABLE<sup>8+</sup> | 0x00000200 | 获取包括被禁用的应用信息。 | 1435| GET_ALL_APPLICATION_INFO | 0xFFFF0000 | 获取应用所有的信息。 | 1436 1437## BundleOptions<sup>deprecated<sup> 1438> 从API version 9开始不再维护，不推荐使用。 1439 1440查询选项，包含userId。 1441 1442 **系统能力：** SystemCapability.BundleManager.BundleFramework 1443 1444| 名称 | 类型 | 只读 | 可选 | 说明 | 1445| ------ | ------ | ---- | ---- | ----------------------------------------------------- | 1446| userId | number | 否 | 是 | 用户ID。默认值：调用方所在用户，取值范围：大于等于0。 | 1447 1448## AbilityType<sup>deprecated<sup> 1449 1450> 从API version 9开始不再维护，建议使用[bundleManager.AbilityType](js-apis-bundleManager.md#abilitytype)替代。 1451 1452Ability组件类型。 1453 1454 **系统能力：** SystemCapability.BundleManager.BundleFramework 1455 1456| 名称 | 值 | 说明 | 1457| ------- | ---- | --------------------------- | 1458| UNKNOWN | 无 | 未知Ability类型。 | 1459| PAGE | 无 | 表示基于Page模板开发的FA，用于提供与用户交互的能力。 | 1460| SERVICE | 无 | 表示基于Service模板开发的PA，用于提供后台运行任务的能力。 | 1461| DATA | 无 | 表示基于Data模板开发的PA，用于对外部提供统一的数据访问对象。 | 1462 1463## DisplayOrientation<sup>deprecated<sup> 1464 1465> 从API version 9开始不再维护，建议使用[bundleManager.DisplayOrientation](js-apis-bundleManager.md#displayorientation)替代。 1466 1467屏幕显示方向。 1468 1469 **系统能力：** SystemCapability.BundleManager.BundleFramework 1470 1471| 名称 | 值 | 说明 | 1472| ------------- | ---- | ------------------------ | 1473| UNSPECIFIED | 无 | 屏幕方向--不指定。 | 1474| LANDSCAPE | 无 | 屏幕方向--横屏。 | 1475| PORTRAIT | 无 | 屏幕方向--竖屏。 | 1476| FOLLOW_RECENT | 无 | 屏幕方向--紧跟上一个组件。 | 1477## LaunchMode<sup>deprecated<sup> 1478 1479> 从API version 9开始不再维护，建议使用[bundleManager.LaunchType](js-apis-bundleManager.md#launchtype)替代。 1480 1481Ability组件的启动模式。 1482 1483 **系统能力：** SystemCapability.BundleManager.BundleFramework 1484 1485| 名称 | 值 | 说明 | 1486| --------- | ---- | ------------------- | 1487| SINGLETON | 0 | Ability只有一个实例。 | 1488| STANDARD | 1 | Ability有多个实例。 | 1489 1490## AbilitySubType<sup>deprecated<sup> 1491> 从API version 9开始不再维护，不推荐使用。 1492 1493Ability组件的子类型。 1494 1495 **系统能力：** SystemCapability.BundleManager.BundleFramework 1496 1497| 名称 | 值 | 说明 | 1498| ----------- | ---- | ----------------------------- | 1499| UNSPECIFIED | 0 | 未定义Ability子类型。 | 1500| CA | 1 | Ability子类型是带有 UI 的服务。 | 1501 1502## ColorMode<sup>deprecated<sup> 1503> 从API version 9开始不再维护，不推荐使用。 1504 1505应用、卡片等的颜色模式。 1506 1507 **系统能力：** SystemCapability.BundleManager.BundleFramework 1508 1509| 名称 | 值 | 说明 | 1510| ---------- | ---- | -------- | 1511| AUTO_MODE | -1 | 自动模式。 | 1512| DARK_MODE | 0 | 黑色模式。 | 1513| LIGHT_MODE | 1 | 亮度模式。 | 1514 1515 1516## GrantStatus<sup>deprecated<sup> 1517 1518> 从API version 9开始不再维护，建议使用[bundleManager.PermissionGrantState](js-apis-bundleManager.md#permissiongrantstate)替代。 1519 1520权限授予状态。 1521 1522 **系统能力：** SystemCapability.BundleManager.BundleFramework 1523 1524| 名称 | 值 | 说明 | 1525| ------------------ | ---- | ------------ | 1526| PERMISSION_DENIED | -1 | 拒绝授予权限。 | 1527| PERMISSION_GRANTED | 0 | 授予权限。 | 1528