应用包信息,可以通过bundleManager.getBundleInfoForSelf获取自身的应用包信息,其中参数bundleFlags指定所返回的BundleInfo中所包含的信息。
本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
系统能力: SystemCapability.BundleManager.BundleFramework.Core
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| name | string | 是 | 否 | 应用包的名称,对应app.json5中配置的bundleName字段。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| vendor | string | 是 | 否 | 应用包的供应商,对应app.json5中配置的vendor字段。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| versionCode | number | 是 | 否 | 应用包的版本号,对应app.json5中配置的versionCode字段。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| versionName | string | 是 | 否 | 应用包的版本文本描述信息,对应app.json5中配置的versionName字段。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本,对应app.json5中配置的minCompatibleVersionCode字段。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| targetVersion | number | 是 | 否 | 应用运行目标版本,对应app.json5中配置的targetAPIVersion字段。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| appInfo | ApplicationInfo | 是 | 否 | 应用程序的配置信息,通过调用getBundleInfoForSelf接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_APPLICATION获取。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| hapModulesInfo | Array<HapModuleInfo> | 是 | 否 | 模块的配置信息,通过调用getBundleInfoForSelf接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE获取。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| reqPermissionDetails | Array<ReqPermissionDetail> | 是 | 否 | 应用运行时需向系统申请的权限集合的详细信息,通过调用getBundleInfoForSelf接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取。reqPermissionDetails数组和permissionGrantStates数组的索引顺序一一对应,即reqPermissionDetails[2]的授权状态为permissionGrantStates[2]。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| permissionGrantStates | Array<bundleManager.PermissionGrantState> | 是 | 否 | 申请权限的授予状态,通过调用getBundleInfoForSelf接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取。reqPermissionDetails数组和permissionGrantStates数组的索引顺序一一对应,即reqPermissionDetails[2]的授权状态为permissionGrantStates[2]。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| signatureInfo | SignatureInfo | 是 | 否 | 应用包的签名信息,通过调用getBundleInfoForSelf接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_SIGNATURE_INFO获取。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| installTime | number | 是 | 否 | 应用包安装时间戳,表示从1970-01-01 08:00:00 UTC+8逝去的毫秒数,单位毫秒。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 说明: 设备出厂首次开机时,如果未获取到当前时间,会以Unix时间戳基准(1970-01-01 08:00:00 UTC+8)作为当前系统的起始时间。例如,开机后未获取到时间,等待32s之后安装成功,则应用包安装时间戳为32000。 |
| updateTime | number | 是 | 否 | 应用包更新时间戳,表示从1970-01-01 08:00:00 UTC+8逝去的毫秒数,单位毫秒。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| routerMap12+ | Array<RouterItem> | 是 | 否 | 应用的路由表配置,由hapModulesInfo下的routerMap信息,根据RouterItem中的name字段进行去重后合并得到。通过调用getBundleInfoForSelf接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE和GET_BUNDLE_INFO_WITH_ROUTER_MAP获取。 元服务API: 从API version 12开始,该接口支持在元服务中使用。 |
| appIndex12+ | number | 是 | 否 | 应用包的分身索引标识,仅在分身应用中生效。 |
| firstInstallTime18+ | number | 是 | 是 | 应用在当前设备的首次安装时间戳,表示从1970-01-01 08:00:00 UTC+8逝去的毫秒数,单位毫秒,预置应用的首次安装时间戳为1533657660000。 元服务API: 从API version 18开始,该接口支持在元服务中使用。 |
| buildVersion23+ | string | 是 | 是 | 应用包的构建版本号,用于标识相同发布版本下的不同构建版本包,对应app.json5中配置的buildVersion字段。 元服务API: 从API version 23开始,该接口支持在元服务中使用。 模型约束: 此接口仅可在Stage模型下使用。 |
应用运行时需向系统申请的权限集合的详细信息。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.BundleManager.BundleFramework.Core
描述权限的使用场景和时机,帮助开发者合理申请和使用权限。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.BundleManager.BundleFramework.Core
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| abilities | Array<string> | 否 | 否 | 使用到该权限的Ability集合。 |
| when | string | 否 | 否 | 使用该权限的时机。支持的取值有inuse(使用时)、always(始终)。 |
描述应用包的签名信息,可标识应用来源、确保应用完整性,并用于应用安全校验与识别。
元服务API: 从API version 11开始,该接口支持在元服务中使用。
系统能力: SystemCapability.BundleManager.BundleFramework.Core
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| appId | string | 是 | 否 | 应用的appId,表示应用的唯一标识,详情信息可参考什么是appId。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| fingerprint | string | 是 | 否 | 应用包的指纹信息,由签名证书通过SHA-256算法计算哈希值生成。使用的签名证书发生变化时,该字段也会发生变化。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| appIdentifier11+ | string | 是 | 否 | 应用的唯一标识。详情信息可参考什么是appIdentifier。 元服务API: 从API version 11开始,该接口支持在元服务中使用。 |
| certificate14+ | string | 是 | 是 | 应用的证书公钥。 元服务API: 从API version 14开始,该接口支持在元服务中使用。 |
描述应用包的身份信息。
系统能力: SystemCapability.BundleManager.BundleFramework.Core
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| bundleName | string | 是 | 否 | 应用的bundleName。 |
| appIndex | number | 是 | 否 | 应用包的分身索引信息。取值为整数,范围:[0-5],0表示主应用,1-5等表示分身应用。 |
描述应用备用图标信息。
起始版本: 26.0.0
模型约束: 此接口仅可在Stage模型下使用。
系统能力: SystemCapability.BundleManager.BundleFramework.Core
| 名称 | 类型 | 只读 | 可选 | 说明 |
|---|---|---|---|---|
| iconName | string | 是 | 否 | 备用图标的名称。 |
| iconId | number | 是 | 否 | 备用图标的资源id,是编译构建时根据应用配置的icon自动生成的资源id。 |
| enabled | boolean | 是 | 否 | 备用图标是否启用。 true:表示当前备用图标启用。 false:表示当前备用图标未启用。 说明: 应用最多只能启用一个备用图标。 |