extensionability-overview.md 5.3 KB
Newer Older
Z
zengyawen 已提交
1 2 3 4 5 6 7 8 9
# ExtensionAbility组件概述


ExtensionAbility组件是基于特定场景(例如服务卡片、输入法等)提供的应用组件,以便满足更多的使用场景。


每一个具体场景对应一个[ExtensionAbilityType](../reference/apis/js-apis-bundleManager.md#extensionabilitytype),各类型的ExtensionAbility组件均由相应的系统服务统一管理,例如InputMethodExtensionAbility组件由输入法管理服务统一管理。当前支持的ExtensionAbility类型有:


10
- [FormExtensionAbility](../reference/apis/js-apis-app-form-formExtensionAbility.md):FORM类型的ExtensionAbility组件,用于提供服务卡片场景相关能力。
Z
zengyawen 已提交
11

M
mingxihua 已提交
12
- [WorkSchedulerExtensionAbility](../reference/apis/js-apis-WorkSchedulerExtensionAbility.md):WORK_SCHEDULER类型的ExtensionAbility组件,用于提供延迟任务注册、取消、查询的能力。
Z
zengyawen 已提交
13 14 15

- [InputMethodExtensionAbility](../reference/apis/js-apis-inputmethod.md):INPUT_METHOD类型的ExtensionAbility组件,提供对输入法框架的管理,包括隐藏输入法、查询已安装的输入法列表和显示输入法选择对话框。

Z
zhongjianfei 已提交
16
- [ServiceExtensionAbility](../reference/apis/js-apis-app-ability-serviceExtensionAbility.md):SERVICE类型的ExtensionAbility组件,用于提供后台服务场景相关能力。
Z
zengyawen 已提交
17

Z
zhongjianfei 已提交
18
- [AccessibilityExtensionAbility](../reference/apis/js-apis-application-accessibilityExtensionAbility.md):ACCESSIBILITY类型的ExtensionAbility组件,用于提供辅助功能业务的能力。
Z
zengyawen 已提交
19

Z
zhongjianfei 已提交
20
- [DataShareExtensionAbility](../reference/apis/js-apis-application-dataShareExtensionAbility.md):DATA_SHARE类型的ExtensionAbility组件,用于提供支持数据共享业务的能力。
Z
zengyawen 已提交
21 22 23

- [StaticSubscriberExtensionAbility](../reference/apis/js-apis-application-staticSubscriberExtensionAbility.md):STATIC_SUBSCRIBER类型的ExtensionAbility组件,用于提供静态广播的能力。

Z
zhongjianfei 已提交
24
- [WindowExtensionAbility](../reference/apis/js-apis-application-windowExtensionAbility.md):WINDOW类型的ExtensionAbility组件,用于提供界面组合扩展能力,允许系统应用进行跨应用的界面拉起和嵌入。
Z
zengyawen 已提交
25 26 27

- [EnterpriseAdminExtensionAbility](../reference/apis/js-apis-EnterpriseAdminExtensionAbility.md):ENTERPRISE_ADMIN类型的ExtensionAbility组件,用于提供企业管理时处理管理事件的能力,比如设备上应用安装事件、锁屏密码输入错误次数过多事件等。

C
caochunlei 已提交
28 29 30 31 32 33
> **说明:**
> 1. OpenHarmony不支持三方应用实现ServiceExtensionAbility、DataShareExtensionAbility、StaticSubscriberExtensionAbility和WindowExtensionAbility。
>
> 2. 如果三方开发者想要实现后台处理相关事务的功能,无法使用ServiceExtensionAbility,可以使用后台任务,具体请参见[后台任务](../task-management/background-task-overview.md)。
>
> 3. 三方应用只能使用当前系统已定义的上述类型的ExtensionAbility。
Z
zengyawen 已提交
34 35 36 37 38 39

## 使用指定类型的ExtensionAbility组件

所有类型的ExtensionAbility组件均不能被应用直接启动,而是由相应的系统管理服务拉起,以确保其生命周期受系统管控,使用时拉起,使用完销毁。ExtensionAbility组件的调用方无需关心目标ExtensionAbility组件的生命周期。

[InputMethodExtensionAbility](../reference/apis/js-apis-inputmethod.md)组件为例进行说明,如下图所示,调用方应用发起对InputMethodExtensionAbility组件的调用,此时将先调用输入法管理服务,由输入法管理服务拉起[InputMethodExtensionAbility](../reference/apis/js-apis-inputmethod.md)组件,返回给调用方,同时开始管理其生命周期。
40

Z
zengyawen 已提交
41
  **图1** 使用InputMethodExtensionAbility组件
42

Z
zengyawen 已提交
43 44 45 46 47
![ExtensionAbility-start](figures/ExtensionAbility-start.png)


## 实现指定类型的ExtensionAbility组件

48
以实现卡片[FormExtensionAbility](../reference/apis/js-apis-app-form-formExtensionAbility.md)为例进行说明。卡片框架提供了[FormExtensionAbility](../reference/apis/js-apis-app-form-formExtensionAbility.md)基类,开发者通过派生此基类(如MyFormExtensionAbility),实现回调(如创建卡片的onCreate()回调、更新卡片的onUpdateForm()回调等)来实现具体卡片功能,具体见开发指导见[服务卡片FormExtensionAbility](widget-development-stage.md)
Z
zengyawen 已提交
49 50 51 52 53 54 55 56

卡片FormExtensionAbility实现方不用关心使用方何时去请求添加、删除卡片,FormExtensionAbility实例及其所在的ExtensionAbility进程的整个生命周期,都是由卡片管理系统服务FormManagerService进行调度管理。

![form_extension](figures/form_extension.png)


> ![icon-note.gif](public_sys-resources/icon-note.gif) **说明:**
> 同一应用内的所有同类型的ExtensionAbility运行在同一独立进程(除ServiceExtensionAbility、DataShareExtensionAbility外),跟UIAbility组件不在同一进程,Stage模型的进程模型请参见[进程模型](process-model-stage.md)。
C
caochunlei 已提交
57
>
Z
zengyawen 已提交
58
> 例如一个应用有1个UIAbility组件、1个ServiceExtensionAbility、1个DataShareExtensionAbility、2个FormExtensionAbility、1个ImeExtensionAbility。则该应用在运行时,有三个进程:
C
caochunlei 已提交
59
>
Z
zengyawen 已提交
60
> - UIAbility、ServiceExtensionAbility、DataShareExtensionAbility运行在同一个进程。
C
caochunlei 已提交
61
>
Z
zengyawen 已提交
62
> - FormExtensionAbility运行在一个独立进程。
C
caochunlei 已提交
63
>
Z
zengyawen 已提交
64
> - ImeExtensionAbility运行在一个独立进程。