AbilityInfo

说明： 本模块首批接口从API version 9 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。

Ability信息，系统应用可以通过bundleManager.queryAbilityInfo获取Ability信息，其中入参abilityFlags指定返回的AbilityInfo中所包含的信息。

AbilityInfo

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

名称 类型 可读 可写 说明
bundleName string 是 否 应用Bundle名称。
moduleName string 是 否 Ability所属的HAP的名称。
name string 是 否 Ability名称。
label string 是 否 Ability对用户显示的名称的资源描述符，如："label": "$string: mainability_description"。
labelId number 是 否 Ability的标签资源id。
description string 是 否 Ability的描述。
descriptionId number 是 否 Ability的描述资源id。
icon string 是 否 Ability的图标资源描述符，如"icon": "$media:icon"。
iconId number 是 否 Ability的图标资源id。
process string 是 否 Ability的进程，如果不设置，默认为包的名称。
exported boolean 是 否 判断Ability是否可以被其他应用调用。
type AbilityType 是 否 Ability类型
此属性仅可在FA模型下使用。
orientation DisplayOrientation 是 否 Ability的显示模式。
launchType LaunchType 是 否 Ability的启动模式。
permissions Array<string> 是 否 被其他应用Ability调用时需要申请的权限集合，通过调用getBundleInfoForSelf接口，bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY和GET_BUNDLE_INFO_WITH_REQUESTED_PERMISSION获取。
readPermission string 是 否 读取Ability数据所需的权限
此属性仅可在FA模型下使用。
writePermission string 是 否 向Ability写数据所需的权限
此属性仅可在FA模型下使用。
uri string 是 否 获取Ability的统一资源标识符（URI）
此属性仅可在FA模型下使用。
deviceTypes Array<string> 是 否 Ability支持的设备类型。
applicationInfo ApplicationInfo 是 否 应用程序的配置信息，通过调用getBundleInfoForSelf接口，bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY和GET_BUNDLE_INFO_WITH_APPLICATION获取。
metadata Array<Metadata> 是 否 Ability的元信息，通过调用getBundleInfoForSelf接口，bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_ABILITY和GET_BUNDLE_INFO_WITH_METADATA获取。
enabled boolean 是 否 Ability是否可用。
supportWindowModes Array<SupportWindowMode> 是 否 Ability支持的窗口模式。
windowSize WindowSize 是 否 Ability窗口尺寸。

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。