• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# BundleInfo
2
3应用包信息,三方应用可以通过[bundleManager.getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)获取自身的应用包信息,其中入参[bundleFlags](js-apis-bundleManager.md#bundleflag)指定所返回的[BundleInfo](js-apis-bundleManager-bundleInfo.md)中所包含的信息。
4
5> **说明:**
6> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
7
8## BundleInfo
9
10 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core11
12| 名称                              | 类型                                                         | 只读 | 可选 | 说明                                                         |
13| --------------------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ |
14| name                              | string                                                       | 是   | 否   | 应用包的名称。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
15| vendor                            | string                                                       | 是   | 否   | 应用包的供应商。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
16| versionCode                       | number                                                       | 是   | 否   | 应用包的版本号。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
17| versionName                       | string                                                       | 是   | 否   | 应用包的版本文本描述信息。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
18| minCompatibleVersionCode          | number                                                       | 是   | 否   | 分布式场景下的应用包兼容的最低版本。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
19| targetVersion                     | number                                                       | 是   | 否   | 该标签标识应用运行目标版本。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
20| appInfo                           | [ApplicationInfo](js-apis-bundleManager-applicationInfo.md)         | 是   | 否   | 应用程序的配置信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_APPLICATION获取。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
21| hapModulesInfo                    | Array\<[HapModuleInfo](js-apis-bundleManager-hapModuleInfo.md)>     | 是   | 否   | 模块的配置信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE获取。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
22| reqPermissionDetails     | Array\<[ReqPermissionDetail](#reqpermissiondetail)>   | 是   | 否   | 应用运行时需向系统申请的权限集合的详细信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
23| permissionGrantStates        | Array\<[bundleManager.PermissionGrantState](js-apis-bundleManager.md#permissiongrantstate)> | 是   | 否   | 申请权限的授予状态,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
24| signatureInfo          | [SignatureInfo](#signatureinfo)                                          | 是   | 否   | 应用包的签名信息,通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_SIGNATURE_INFO获取。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
25| installTime                       | number                                                       | 是   | 否   | 应用包安装时间。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
26| updateTime                        | number                                                       | 是   | 否   | 应用包更新时间。<br/>**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。 |
27| routerMap<sup>12+</sup>           | Array\<[RouterItem](js-apis-bundleManager-hapModuleInfo.md#routeritem12)>           | 是   | 否   | 应用的路由表配置,由hapModulesInfo下的routerMap信息,根据RouterItem中的name字段进行去重后合并得到。通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE和GET_BUNDLE_INFO_WITH_ROUTER_MAP获取。<br/>**原子化服务API:** 从API version 12开始,该接口支持在原子化服务中使用。 |
28| appIndex<sup>12+</sup>    | number    | 是   | 否   | 应用包的分身索引标识,仅在分身应用中生效。 |
29
30
31## ReqPermissionDetail
32
33应用运行时需向系统申请的权限集合的详细信息。
34
35 **原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
36
37 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core38
39| 名称                  | 类型                    | 只读 | 可选 | 说明                 |
40| --------------------- | ----------------------- | ---- | ---- | ---------------------|
41| name                  | string                  | 否   | 否   | 需要使用的权限名称。   |
42| moduleName<sup>10+</sup>            | string                  | 否   | 否   | 申请该权限的module名称。   |
43| reason                | string                  | 否   | 否   | 描述申请权限的原因。  |
44| reasonId              | number                  | 否   | 否  | 描述申请权限的原因ID。 |
45| usedScene             | [UsedScene](#usedscene) | 否   | 否   | 权限使用的场景和时机。 |
46
47
48
49## UsedScene
50
51描述权限使用的场景和时机。
52
53 **原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
54
55 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core56
57| 名称      | 类型           | 只读 | 可选 | 说明                        |
58| --------- | -------------- | ---- | ---- | --------------------------- |
59| abilities | Array\<string> | 否   | 否   | 使用到该权限的Ability集合。   |
60| when      | string         | 否   | 否   | 使用该权限的时机。          |
61
62## SignatureInfo
63
64描述应用包的签名信息。
65
66 **原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
67
68 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core69
70| 名称      | 类型           | 只读 | 可选 | 说明                        |
71| --------- | -------------- | ---- | ---- | --------------------------- |
72| appId     | string         | 是   | 否   | 应用的appId。                 |
73|fingerprint| string         | 是   | 否   | 应用包的指纹信息。使用的签名证书发生变化,该字段会发生变化。            |
74|appIdentifier<sup>11+</sup>| string         | 是   | 否   | 应用的唯一标识,由云端统一分配。该ID在应用全生命周期中不会发生变化,包括版本升级、证书变更、开发者公私钥变更、应用转移等。            |
75
76