• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# AbilityInfo
2
3> **说明:**
4> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
5
6Ability信息,系统应用可以通过[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)获取Ability信息,其中入参[abilityFlags](js-apis-bundleManager.md#abilityflag)指定返回的[AbilityInfo](js-apis-bundleManager-abilityInfo.md)中所包含的信息。
7
8## AbilityInfo
9
10 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core11
12| 名称                  | 类型                                                     | 可读 | 可写 | 说明                                      |
13| --------------------- | -------------------------------------------------------- | ---- | ---- | ------------------------------------------ |
14| bundleName            | string                                                   | 是   | 否   | 应用Bundle名称。                            |
15| moduleName            | string                                                   | 是   | 否   | Ability所属的HAP的名称。                    |
16| name                  | string                                                   | 是   | 否   | Ability名称。                               |
17| label                 | string                                                   | 是   | 否   | Ability对用户显示的名称的资源描述符,如:"label": "$string: mainability_description"。                   |
18| labelId               | number                                                   | 是   | 否   | Ability的标签资源id。                       |
19| description           | string                                                   | 是   | 否   | Ability的描述。                             |
20| descriptionId         | number                                                   | 是   | 否   | Ability的描述资源id。                       |
21| icon                  | string                                                   | 是   | 否   | Ability的图标资源描述符,如"icon": "$media:icon"。                 |
22| iconId                | number                                                   | 是   | 否   | Ability的图标资源id。                       |
23| process               | string                                                   | 是   | 否   | Ability的进程,如果不设置,默认为包的名称。 |
24| exported             | boolean                                                  | 是   | 否   | 判断Ability是否可以被其他应用调用。         |
25| type                  | [AbilityType](js-apis-bundleManager.md#abilitytype)      | 是   | 否   | Ability类型<br />此属性仅可在FA模型下使用。 |
26| orientation           | [DisplayOrientation](js-apis-bundleManager.md#displayorientation)  | 是   | 否   | Ability的显示模式。                         |
27| launchType            | [LaunchType](js-apis-bundleManager.md#launchtype)        | 是   | 否   | Ability的启动模式。                         |
28| permissions           | Array\<string>                                           | 是   | 否   | 被其他应用Ability调用时需要申请的权限集合,通过调用[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)接口,abilityFlags参数传入GET_ABILITY_INFO_WITH_PERMISSION获取。 |
29| readPermission        | string                                                   | 是   | 否   | 读取Ability数据所需的权限<br />此属性仅可在FA模型下使用。 |
30| writePermission       | string                                                   | 是   | 否   | 向Ability写数据所需的权限<br />此属性仅可在FA模型下使用。 |
31| uri                   | string                                                   | 是   | 否   | 获取Ability的统一资源标识符(URI)<br />此属性仅可在FA模型下使用。 |
32| deviceTypes           | Array\<string>                                           | 是   | 否   | Ability支持的设备类型。                     |
33| applicationInfo       | [ApplicationInfo](js-apis-bundleManager-applicationInfo.md)     | 是   | 否   | 应用程序的配置信息,通过调用[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)接口,abilityFlags参数传入GET_ABILITY_INFO_WITH_APPLICATION获取。 |
34| metadata              | Array\<[Metadata](js-apis-bundleManager-metadata.md)>           | 是   | 否   | Ability的元信息,通过调用[bundleManager.queryAbilityInfo](js-apis-bundleManager.md#bundlemanagerqueryabilityinfo)接口,abilityFlags参数传入GET_ABILITY_INFO_WITH_METADATA获取。 |
35| enabled               | boolean                                                  | 是   | 否   | Ability是否可用。                           |
36| supportWindowModes    | Array\<[SupportWindowMode](js-apis-bundleManager.md#supportwindowmode)> | 是   | 否   | Ability支持的窗口模式。                      |
37| windowSize|[WindowSize](#windowsize)                                            |    是   | 否   | Ability窗口尺寸。|
38
39## WindowSize
40
41描述窗口尺寸。
42
43 **系统能力:** 以下各项对应的系统能力均为SystemCapability.BundleManager.BundleFramework.Core44
45| 名称               | 类型    | 可读 | 可写 | 说明                               |
46| -------------------| ------- | ---- | ---- | ---------------------------------- |
47| maxWindowRatio     | number  | 是   | 否   | 表示自由窗口状态下窗口的最大宽高比;取值范围0-1。 |
48| minWindowRatio     | number  | 是   | 否   | 表示自由窗口状态下窗口的最小宽高比;取值范围0-1。 |
49| maxWindowWidth     | number  | 是   | 否   | 表示自由窗口状态下窗口的最大宽度,宽度单位为vp。 |
50| minWindowWidth     | number  | 是   | 否   | 表示自由窗口状态下窗口的最小宽度,宽度单位为vp。 |
51| maxWindowHeight    | number  | 是   | 否   | 表示自由窗口状态下窗口的最大高度,宽度单位为vp。 |
52| minWindowHeight    | number  | 是   | 否   | 表示自由窗口状态下窗口的最小高度,宽度单位为vp。 |