harmony 鸿蒙AbilityInfo

2022-08-09
浏览 (763)

AbilityInfo

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

Ability信息，未做特殊说明的属性，均通过bundle.getAbilityInfo获取。

AbilityInfo^(deprecated)

从API version 9开始不再维护，建议使用bundleManager-AbilityInfo替代。

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

名称	类型	可读	可写	说明
bundleName	string	是	否	应用Bundle名称。
name	string	是	否	Ability名称。
label	string	是	否	Ability对用户显示的名称。
description	string	是	否	Ability的描述。
icon	string	是	否	Ability的图标资源文件索引。
descriptionId	number	是	否	Ability的描述的资源id值。
iconId	number	是	否	Ability的图标的资源id值。
moduleName	string	是	否	Ability所属的HAP的名称。
process	string	是	否	Ability的进程，如果不设置，默认为包的名称。
targetAbility	string	是	否	当前Ability重用的目标Ability。此属性仅可在FA模型下使用。
backgroundModes	number	是	否	表示后台服务的类型。此属性仅可在FA模型下使用。
isVisible	boolean	是	否	判断Ability是否可以被其他应用调用。
formEnabled	boolean	是	否	判断Ability是否提供卡片能力。此属性仅可在FA模型下使用。
type	AbilityType	是	否	Ability类型。此属性仅可在FA模型下使用。
orientation	DisplayOrientation	是	否	Ability的显示模式。
launchMode	LaunchMode	是	否	Ability的启动模式。
permissions	Array<string>	是	否	被其他应用Ability调用时需要申请的权限集合。通过调用bundle.getAbilityInfo接口时，传入GET_ABILITY_INFO_WITH_PERMISSION获取。
deviceTypes	Array<string>	是	否	Ability支持的设备类型。
deviceCapabilities	Array<string>	是	否	Ability需要的设备能力。
readPermission	string	是	否	读取Ability数据所需的权限。此属性仅可在FA模型下使用。
writePermission	string	是	否	向Ability写数据所需的权限。此属性仅可在FA模型下使用。
applicationInfo	ApplicationInfo	是	否	应用程序的配置信息。通过调用bundle.getAbilityInfo接口时，传入GET_ABILITY_INFO_WITH_APPLICATION获取。
uri	string	是	否	获取Ability的统一资源标识符（URI）。此属性仅可在FA模型下使用。
labelId	number	是	否	Ability的标签的资源id值。
subType	AbilitySubType	是	否	Ability中枚举使用的模板的子类型。此属性仅可在FA模型下使用。
metadata⁸⁺	Array<CustomizeData>	是	否	ability的元信息。通过调用bundle.getAbilityInfo接口时，传入GET_ABILITY_INFO_WITH_METADATA获取。
enabled⁸⁺	boolean	是	否	ability是否可用。