harmony 鸿蒙AbilityInfo

2022-12-05
浏览 (650)

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调用时需要申请的权限集合，通过调用bundleManager.queryAbilityInfo接口，abilityFlags参数传入GET_ABILITY_INFO_WITH_PERMISSION获取。
readPermission	string	是	否	读取Ability数据所需的权限此属性仅可在FA模型下使用。
writePermission	string	是	否	向Ability写数据所需的权限此属性仅可在FA模型下使用。
uri	string	是	否	获取Ability的统一资源标识符（URI）此属性仅可在FA模型下使用。
deviceTypes	Array<string>	是	否	Ability支持的设备类型。
applicationInfo	ApplicationInfo	是	否	应用程序的配置信息，通过调用bundleManager.queryAbilityInfo接口，abilityFlags参数传入GET_ABILITY_INFO_WITH_APPLICATION获取。
metadata	Array<Metadata>	是	否	Ability的元信息，通过调用bundleManager.queryAbilityInfo接口，abilityFlags参数传入GET_ABILITY_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。