• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AbilityInfo
2<!--Kit: Ability Kit-->
3<!--Subsystem: BundleManager-->
4<!--Owner: @wanghang904-->
5<!--Designer: @hanfeng6-->
6<!--Tester: @kongjing2-->
7<!--Adviser: @Brilliantry_Rui-->
8
9Ability信息,未做特殊说明的属性,均通过[bundle.getAbilityInfo](js-apis-Bundle.md#bundlegetabilityinfodeprecated)获取。
10
11> **说明:**
12>
13> 本模块首批接口从API version 7 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
14>
15> 从API Version 9开始,该模块不再维护,建议使用[bundleManager-AbilityInfo](js-apis-bundleManager-abilityInfo.md)替代。
16
17## AbilityInfo<sup>(deprecated)<sup>
18
19> 从API version 9开始不再维护,建议使用[bundleManager-AbilityInfo](js-apis-bundleManager-abilityInfo.md#abilityinfo-1)替代。
20
21**系统能力:** SystemCapability.BundleManager.BundleFramework
22
23| 名称                  | 类型                                                         | 只读 | 可选 | 说明                                                         |
24| --------------------- | ------------------------------------------------------------ | ---- | ---- | ------------------------------------------------------------ |
25| bundleName            | string                                                       | 是   | 否   | 应用Bundle名称。                                             |
26| name                  | string                                                       | 是   | 否   | Ability名称。                                                |
27| label                 | string                                                       | 是   | 否   | Ability对用户显示的名称。                                    |
28| description           | string                                                       | 是   | 否   | Ability的描述。                                              |
29| icon                  | string                                                       | 是   | 否   | Ability的图标资源文件索引。                                  |
30| descriptionId         | number                                                       | 是   | 否   | Ability的描述的资源id值。                                            |
31| iconId                | number                                                       | 是   | 否   | Ability的图标的资源id值。                                            |
32| moduleName            | string                                                       | 是   | 否   | Ability所属的HAP的名称。                                     |
33| process               | string                                                       | 是   | 否   | Ability的进程名称。                  |
34| targetAbility         | string                                                       | 是   | 否   | 当前Ability重用的目标Ability。<br />**模型约束:** 此接口仅可在FA模型下使用。 |
35| backgroundModes       | number                                                       | 是   | 否   | 表示后台服务的类型。<br />**模型约束:** 此接口仅可在FA模型下使用。         |
36| isVisible             | boolean                                                      | 是   | 否   | 判断Ability是否可以被其他应用调用,取值为true表示Ability可以被其他应用调用,取值为false表示Ability不可以被其他应用调用。                          |
37| formEnabled           | boolean                                                      | 是   | 否   | 判断Ability是否提供卡片能力,取值为true表示Ability提供卡片能力,取值为false表示Ability不提供卡片能力。<br />**模型约束:** 此接口仅可在FA模型下使用。 |
38| type                  | bundle.AbilityType                                                  | 是   | 否   | Ability类型。<br />**模型约束:** 此接口仅可在FA模型下使用。                |
39| orientation           | [bundle.DisplayOrientation](js-apis-Bundle.md#displayorientationdeprecated) | 是   | 否   | Ability的显示模式。                                          |
40| launchMode            | [bundle.LaunchMode](js-apis-Bundle.md#launchmodedeprecated)         | 是   | 否   | Ability的启动模式。                                          |
41| permissions           | Array\<string>                                               | 是   | 否   | 被其他应用Ability调用时需要申请的权限集合。<br />通过调用[bundle.getAbilityInfo](js-apis-Bundle.md#bundlegetabilityinfodeprecated)接口时,传入GET_ABILITY_INFO_WITH_PERMISSION获取。 |
42| deviceTypes           | Array\<string>                                               | 是   | 否   | Ability支持的设备类型。                                      |
43| deviceCapabilities    | Array\<string>                                               | 是   | 否   | Ability需要的设备能力。                                      |
44| readPermission        | string                                                       | 是   | 否   | 读取Ability数据所需的权限。<br />**模型约束:** 此接口仅可在FA模型下使用。  |
45| writePermission       | string                                                       | 是   | 否   | 向Ability写数据所需的权限。<br />**模型约束:** 此接口仅可在FA模型下使用。  |
46| applicationInfo       | [ApplicationInfo](js-apis-bundle-ApplicationInfo.md)         | 是   | 否   | 应用程序的配置信息。<br />通过调用[bundle.getAbilityInfo](js-apis-Bundle.md#bundlegetabilityinfodeprecated)接口时,传入GET_ABILITY_INFO_WITH_APPLICATION获取。 |
47| uri                   | string                                                       | 是   | 否   | 获取Ability的统一资源标识符(URI)。<br />**模型约束:** 此接口仅可在FA模型下使用。 |
48| labelId               | number                                                       | 是   | 否   | Ability的标签的资源id值。                                            |
49| subType               | bundle.AbilitySubType                                               | 是   | 否   | Ability中枚举使用的模板的子类型。<br />**模型约束:** 此接口仅可在FA模型下使用。 |
50| metaData<sup>8+</sup> | Array\<[CustomizeData](js-apis-bundle-CustomizeData.md)>     | 是   | 否   | ability的元信息。<br />通过调用[bundle.getAbilityInfo](js-apis-Bundle.md#bundlegetabilityinfodeprecated)接口时,传入GET_ABILITY_INFO_WITH_METADATA获取。 |
51| enabled<sup>8+</sup>  | boolean                                                      | 是   | 否   | ability是否可用,取值为true表示Ability可用,取值为false表示Ability不可用。                                            |
52