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。