HarmonyOS API:bundleManager
版本:v3.1 Beta
AbilityInfo
更新时间: 2023-02-17 09:19
说明
本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
Ability信息,未做特殊说明的属性,均通过GET_ABILITY_INFO_DEFAULT获取
AbilityInfo
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
名称 | 类型 | 可读 | 可写 | 说明 |
bundleName | string | 是 | 否 | 应用包名 |
moduleName | string | 是 | 否 | Ability所属的HAP包的名称 |
name | string | 是 | 否 | Ability名称 |
label | string | 是 | 否 | Ability对用户显示的名称 |
labelId | number | 是 | 否 | Ability的标签资源id |
description | string | 是 | 否 | Ability的描述 |
descriptionId | number | 是 | 否 | Ability的描述资源id |
icon | string | 是 | 否 | Ability的图标资源文件索引 |
iconId | number | 是 | 否 | Ability的图标资源id |
process | string | 是 | 否 | Ability的进程,如果不设置,默认为包的名称 |
isVisible | boolean | 是 | 否 | 判断Ability是否可以被其他应用调用 |
type | 是 | 否 | Ability类型 此属性仅可在FA模型下使用 | |
orientation | 是 | 否 | Ability的显示模式 | |
launchType | 是 | 否 | Ability的启动模式 | |
permissions | Array<string> | 是 | 否 | 被其他应用Ability调用时需要申请的权限集合,通过传入GET_ABILITY_INFO_WITH_PERMISSION获取 |
readPermission | string | 是 | 否 | 读取Ability数据所需的权限 此属性仅可在FA模型下使用 |
writePermission | string | 是 | 否 | 向Ability写数据所需的权限 此属性仅可在FA模型下使用 |
uri | string | 是 | 否 | 获取Ability的统一资源标识符(URI) 此属性仅可在FA模型下使用 |
deviceTypes | Array<string> | 是 | 否 | Ability支持的设备类型 |
applicationInfo | 是 | 否 | 应用程序的配置信息,通过传入GET_ABILITY_INFO_WITH_APPLICATION获取 | |
metadata | Array<Metadata> | 是 | 否 | ability的元信息,通过传入GET_ABILITY_INFO_WITH_METADATA获取 |
enabled | boolean | 是 | 否 | ability是否可用 |
supportWindowModes | Array<SupportWindowMode> | 是 | 否 | ability支持的窗口模式 |
windowSize | 是 | 否 | 表示窗口尺寸 |
WindowSize
描述窗口尺寸。
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
名称 | 类型 | 可读 | 可写 | 说明 |
maxWindowRatio | number | 是 | 否 | 表示自由窗口状态下窗口的最大宽高比;取值范围0-1 |
minWindowRatio | number | 是 | 否 | 表示自由窗口状态下窗口的最小宽高比;取值范围0-1 |
maxWindowWidth | number | 是 | 否 | 表示自由窗口状态下窗口的最大宽度,宽度单位为vp |
minWindowWidth | number | 是 | 否 | 表示自由窗口状态下窗口的最小宽度,宽度单位为vp |
maxWindowHeight | number | 是 | 否 | 表示自由窗口状态下窗口的最大高度,宽度单位为vp |
minWindowHeight | number | 是 | 否 | 表示自由窗口状态下窗口的最小高度,宽度单位为vp |
ApplicationInfo
更新时间: 2023-02-17 09:19
说明
本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
应用程序信息,未做特殊说明的属性,均通过GET_APPLICATION_INFO_DEFAULT获取
ApplicationInfo
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core
名称 | 类型 | 可读 | 可写 | 说明 |
name | string | 是 | 否 | 应用程序的名称 |
description | string | 是 | 否 | 标识应用的描述信息 |
descriptionId | number | 是 | 否 | 标识应用的描述信息的资源id |
enabled | boolean | 是 | 否 | 判断应用程序是否可以使用,默认为true |
label | string | 是 | 否 | 标识应用的名称 |
labelId | number | 是 | 否 | 标识应用名称的资源id |
icon | string | 是 | 否 | 应用程序的图标 |
iconId | number | 是 | 否 | 应用程序图标的资源id |
process | string | 是 | 否 | 应用程序的进程,如果不设置,默认为包的名称。 |
permissions | Array<string> | 是 | 否 | 访问应用程序所需的权限,通过传入GET_APPLICATION_INFO_WITH_PERMISSION获取 |
codePath | string | 是 | 否 | 应用程序的安装目录 |
metadata | Map<string, Array<Metadata>> | 是 | 否 | 应用程序的元信息,通过传入GET_APPLICATION_INFO_WITH_METADATA获取 |
removable | boolean | 是 | 否 | 应用程序是否可以被移除 |
accessTokenId | number | 是 | 否 | 应用程序的accessTokenId |
uid | number | 是 | 否 | 应用程序的uid |
iconResource | 是 | 否 | 应用程序的图标资源信息 | |
labelResource | 是 | 否 | 应用程序的标签资源信息 | |
descriptionResource | 是 | 否 | 应用程序的描述资源信息 | |
appDistributionType | string | 是 | 否 | 应用程序签名证书的分发类型,分为:app_gallery、enterprise、os_integration和crowdtesting |
appProvisionType | string | 是 | 否 | 应用程序签名证书文件的类型,分为debug和release两种类型 |
systemApp | boolean | 是 | 否 | 标识应用是否为系统应用。 |
BundleInfo
更新时间: 2023-02-17 09:19
说明
本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
应用包信息,应用可以通过getBundleInfoForSelf获取自身的应用包信息,其中入参bundleFlags指定所返回的BundleInfo中所包含的信息。
BundleInfo
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
名称 | 类型 | 可读 | 可写 | 说明 |
name | string | 是 | 否 | 应用包的名称 |
vendor | string | 是 | 否 | 应用包的供应商 |
versionCode | number | 是 | 否 | 应用包的版本号 |
versionName | string | 是 | 否 | 应用包的版本文本描述信息 |
minCompatibleVersionCode | number | 是 | 否 | 分布式场景下的应用包兼容的最低版本 |
targetVersion | number | 是 | 否 | 该标签标识应用运行目标版本 |
appInfo | 是 | 否 | 应用程序的配置信息,通过传入GET_BUNDLE_INFO_WITH_APPLICATION获取 | |
hapModulesInfo | Array<HapModuleInfo> | 是 | 否 | 模块的配置信息,通过传入GET_BUNDLE_INFO_WITH_HAP_MODULE获取 |
reqPermissionDetails | Array<ReqPermissionDetail> | 是 | 否 | 应用运行时需向系统申请的权限集合的详细信息,通过传入GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取 |
permissionGrantStates | Array<PermissionGrantState> | 是 | 否 | 申请权限的授予状态,通过传入GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取 |
signatureInfo | 是 | 否 | 应用包的签名信息,通过传入GET_BUNDLE_INFO_WITH_SIGNATURE_INFO获取 | |
installTime | number | 是 | 否 | 应用包安装时间 |
updateTime | number | 是 | 否 | 应用包更新时间 |
ReqPermissionDetail
应用运行时需向系统申请的权限集合的详细信息。
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
名称 | 类型 | 可读 | 可写 | 说明 |
name | string | 是 | 是 | 需要使用的权限名称 |
reason | string | 是 | 是 | 描述申请权限的原因 |
reasonId | number | 是 | 是 | 描述申请权限的原因ID |
usedScene | 是 | 是 | 权限使用的场景和时机 |
UsedScene
描述权限使用的场景和时机。
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
名称 | 类型 | 可读 | 可写 | 说明 |
abilities | Array<string> | 是 | 是 | 使用到该权限的Ability集合 |
when | string | 是 | 是 | 使用该权限的时机。 |
SignatureInfo
描述应用包的签名信息。
系统能力: 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core。
名称 | 类型 | 可读 | 可写 | 说明 |
appId | string | 是 | 否 | 应用的appId |
fingerprint | string | 是 | 否 | 应用包的指纹信息 |