• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# ExtensionAbilityInfo
2<!--Kit: Ability Kit-->
3<!--Subsystem: BundleManager-->
4<!--Owner: @wanghang904-->
5<!--Designer: @hanfeng6-->
6<!--Tester: @kongjing2-->
7<!--Adviser: @Brilliantry_Rui-->
8
9ExtensionAbility信息,可以通过[bundleManager.getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)获取自身的ExtensionAbility信息,其中参数[bundleFlags](js-apis-bundleManager.md#bundleflag)至少包含GET_BUNDLE_INFO_WITH_HAP_MODULE和GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY。
10
11> **说明:**
12> 本模块首批接口从API version 9 开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。
13
14## 导入模块
15
16```ts
17import { bundleManager } from '@kit.AbilityKit';
18```
19
20## ExtensionAbilityInfo
21
22**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
23
24**系统能力**: SystemCapability.BundleManager.BundleFramework.Core
25
26| 名称                 | 类型                                                         | 只读 | 可选 | 说明                                                 |
27| -------------------- | ------------------------------------------------------------ | ---- | ---- | ---------------------------------------------------- |
28| bundleName           | string                                                       | 是   | 否   | 应用Bundle名称。                                     |
29| moduleName           | string                                                       | 是   | 否   | ExtensionAbility所属的HAP的名称。                    |
30| name                 | string                                                       | 是   | 否   | ExtensionAbility名称。                               |
31| labelId              | number                                                       | 是   | 否   | ExtensionAbility的标签资源ID。                       |
32| descriptionId        | number                                                       | 是   | 否   | ExtensionAbility的描述资源ID。                       |
33| iconId               | number                                                       | 是   | 否   | ExtensionAbility的图标资源ID。                       |
34| exported            | boolean                                                      | 是   | 否   | 判断ExtensionAbility是否可以被其他应用调用,取值为true表示ExtensionAbility可以被其他应用调用,取值为false表示ExtensionAbility不可以被其他应用调用。         |
35| extensionAbilityType | [ExtensionAbilityType](js-apis-bundleManager.md#extensionabilitytype) | 是   | 否   | ExtensionAbility类型。                               |
36| permissions          | Array\<string>                                               | 是   | 否   | 被其他应用ExtensionAbility调用时需要申请的权限集合。 |
37| applicationInfo      | [ApplicationInfo](js-apis-bundleManager-applicationInfo.md)  | 是   | 否   | 应用程序的配置信息。通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY和GET_BUNDLE_INFO_WITH_APPLICATION获取。 |
38| metadata             | Array\<[Metadata](js-apis-bundleManager-metadata.md)>        | 是   | 否   | ExtensionAbility的元信息。通过调用[getBundleInfoForSelf](js-apis-bundleManager.md#bundlemanagergetbundleinfoforself)接口,bundleFlags参数传入GET_BUNDLE_INFO_WITH_HAP_MODULE、GET_BUNDLE_INFO_WITH_EXTENSION_ABILITY和GET_BUNDLE_INFO_WITH_METADATA获取。 |
39| enabled              | boolean                                                      | 是   | 否   | ExtensionAbility是否可用,取值为true表示ExtensionAbility可用,取值为false表示ExtensionAbility不可用。                           |
40| readPermission       | string                                                       | 是   | 否   | 读取ExtensionAbility数据所需的权限。                 |
41| writePermission      | string                                                       | 是   | 否   | 向ExtensionAbility写数据所需的权限。                 |
42| extensionAbilityTypeName<sup>11+</sup>      | string                                 | 是   | 否   | ExtensionAbility的类型名称,取值请参考[extensionabilities标签下的type字段](../../quick-start/module-configuration-file.md#extensionabilities标签)。                 |
43| skills<sup>12+</sup>             | Array\<[Skill](js-apis-bundleManager-skill.md)>                                                 | 是   | 否   | ExtensionAbility的Skills信息。        |
44| appIndex<sup>12+</sup>    | number    | 是   | 否   | 应用包的分身索引标识,仅在分身应用中生效。 |