!21914 ShareExtensionAbility文档添加

Merge pull request !21914 from xinking129/master

zh-cn/application-dev/reference/apis/js-apis-app-ability-shareExtensionAbility.md

+# @ohos.app.ability.ShareExtensionAbility (分享模板服务扩展能力)
+
+ShareExtensionAbility是为开发者提供分享操作业务模板，继承自[UIExtensionAbility](js-apis-app-ability-uiExtensionAbility.md)。ShareExtension为人们提供了一种通过应用程序、社交媒体帐户和其他服务共享当前上下文信息的便捷方式。
+
+> **说明：**
+> 
+> 本模块首批接口从API version 10 开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。  
+> 本模块接口仅可在Stage模型下使用。
+
+## 场景介绍
+
+以分享文本为例。用户选择一段文本，拉起要分享应用，此时被分享拉起的应用会根据分享信息将分享模板拉起，并将数据按分享模板内容显示。
+
+## 导入模块
+
+```ts
+import ShareExtensionAbility from '@ohos.app.ability.ShareExtensionAbility';
+```
+
+## 属性
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+| 名称 | 类型 | 可读 | 可写 | 说明 |
+| -------- | -------- | -------- | -------- | -------- |
+| context | [UIExtensionContext](js-apis-inner-application-uiExtensionContext.md) | 是 | 否 | 上下文。 |
+
+## ShareExtensionAbility.onCreate
+
+onCreate(): void
+
+ShareExtensionAbility创建时回调，执行初始化业务逻辑操作。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+## ShareExtensionAbility.onSessionCreate
+
+onSessionCreate(want: Want, session: UIExtensionContentSession): void
+
+当ShareExtensionAbility界面内容对象创建后调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| want | [Want](js-apis-app-ability-want.md) | 是 | 当前ShareExtensionAbility的Want类型信息，包括ability名称、bundle名称等。 |
+| session | [UIExtensionContentSession](js-apis-app-ability-uiExtensionContentSession.md) | 是 | ShareExtensionAbility界面内容相关信息。 |
+
+## ShareExtensionAbility.onSessionDestroy
+
+onSessionDestroy(session: UIExtensionContentSession): void
+
+当ShareExtensionAbility界面内容对象销毁后调用。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+**参数：**
+
+| 参数名 | 类型 | 必填 | 说明 |
+| -------- | -------- | -------- | -------- |
+| session | [UIExtensionContentSession](js-apis-app-ability-uiExtensionContentSession.md) | 是 | ShareExtensionAbility界面内容相关信息。 |
+
+## ShareExtensionAbility.onForeground
+
+onForeground(): void;
+
+ShareExtensionAbility生命周期回调，当ShareExtensionAbility从后台转到前台时触发。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+## ShareExtensionAbility.onBackground
+
+onBackground(): void;
+
+ShareExtensionAbility生命周期回调，当ShareExtensionAbility从前台转到后台时触发。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+## ShareExtensionAbility.onDestroy
+
+onDestroy(): void | Promise<void>;
+
+ShareExtensionAbility生命周期回调，在销毁时回调，执行资源清理等操作。
+在执行完onDestroy生命周期回调后，应用可能会退出，从而可能导致onDestroy中的异步函数未能正确执行，比如异步写入数据库。可以使用异步生命周期，以确保异步onDestroy完成后再继续后续的生命周期。
+
+**系统能力**：SystemCapability.Ability.AbilityRuntime.AbilityCore
+
+## 创建ShareExtensionAbility
+
+在DevEco Studio工程中手动新建一个ShareExtensionAbility，具体步骤如下：
+
+1. 在工程Module对应的ets目录下，右键选择“New > Directory”，新建一个目录并命名为ShareExtAbility。
+
+2. 在ShareExtAbility目录，右键选择“New > TypeScript File”，新建一个TypeScript文件并命名为ShareExtAbility.ts。
+
+    ```
+    ├── ets
+    │ ├── ShareExtAbility
+    │ │   ├── ShareExtAbility.ts
+    └
+    ```
+
+3. ShareExtAbility.ts文件中，增加导入ShareExtensionAbility的依赖包，自定义类继承ShareExtensionAbility并实现生命周期回调。
+
+   ```ts
+   import ShareExtensionAbility from '@ohos.app.ability.ShareExtensionAbility';
+   const TAG: string = "[ShareExtAbility]";
+
+   export default class ShareExtAbility extends ShareExtensionAbility {
+     onCreate() {
+       console.info(TAG, `onCreate`);
+     }
+
+     onForeground() {
+       console.info(TAG, `ononForeground`);
+     }
+   
+     onBackground() {
+       console.info(TAG, `onBackground`);
+     }
+   
+     onSessionCreate(want, session) {
+       console.info(TAG, `onSessionCreate, want: ${want.abilityName}`);
+       this.message = want.parameters.shareMessages;
+       this.storage = new LocalStorage(
+        {
+          'session': session,
+          'messages': this.message
+        });
+       session.loadContent('pages/Index', this.storage);
+     }
+
+     onSessionDestroy(session) {
+       console.info(TAG, `onSessionDestroy`);
+     }
+ 
+     onDestroy() {
+       console.info(TAG, `onDestroy`);
+     }
+   }
+   ```
+
+4. 在工程Module对应的[module.json5配置文件](../../quick-start/module-configuration-file.md)中注册ShareExtensionAbility，type标签需要设置为“share”，srcEntry标签表示当前ExtensionAbility组件所对应的代码路径。
+
+   ```json
+   {
+     "module": {
+       ...
+       "extensionAbilities": [
+         {
+           "name": "ShareExtAbility",
+           "icon": "$media:icon",
+           "description": "share",
+           "type": "share",
+           "exported": true,
+           "srcEntry": "./ets/ShareExtAbility/ShareExtAbility.ts"
+         }
+       ]
+     }
+   }
+   ```
\ No newline at end of file

zh-cn/application-dev/reference/apis/js-apis-bundleManager.md

@@ -113,6 +113,7 @@ Ability组件信息标志，指示需要获取的Ability组件信息的内容。
 | THUMBNAIL        | 13  | ThumbnailExtensionAbility：文件缩略图扩展能力，用于为文件提供图标缩略图的能力。预留能力，当前暂未支持。 |
 | PREVIEW          | 14  | PreviewExtensionAbility：文件预览扩展能力，提供文件预览的能力，其他应用可以直接在应用中嵌入显示。预留能力，当前暂未支持。 |
 | PRINT<sup>10+</sup> | 15 | PrintExtensionAbility：文件打印扩展能力，提供应用打印照片、文档等办公场景。当前支持图片打印，文档类型暂未支持。 |
+| SHARE<sup>10+</sup> | 16 | [ShareExtensionAbility](js-apis-app-ability-shareExtensionAbility.md)：提供分享业务能力，为开发者提供基于UIExtension的分享业务模板。 |
 | PUSH<sup>10+</sup> | 17 | PushExtensionAbility：推送扩展能力，提供推送场景化消息能力。预留能力，当前暂未支持。 |
 | DRIVER<sup>10+</sup> | 18 | DriverExtensionAbility：驱动扩展能力，提供外设驱动扩展能力，当前暂未支持。 |
 | ACTION<sup>10+</sup> | 19 | [ActionExtensionAbility](js-apis-app-ability-actionExtensionAbility.md)：自定义服务扩展能力，为开发者提供基于UIExtension的自定义操作业务模板。 |