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模型下使用。
metadata8+ Array<CustomizeData> ability的元信息。
通过调用bundle.getAbilityInfo接口时,传入GET_ABILITY_INFO_WITH_METADATA获取。
enabled8+ boolean ability是否可用。