!7847 [新增特性]卡片分享doc

Merge pull request !7847 from xinking129/master

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

@@ -102,4 +102,6 @@ import formInfo from '@ohos.application.formInfo';
 | MODULE_NAME_KEY        | "ohos.extra.param.key.module_name"   | 卡片所属模块名称。   |
 | WIDTH_KEY        | "ohos.extra.param.key.form_width"   | 卡片宽度。   |
 | HEIGHT_KEY         | "ohos.extra.param.key.form_height"   | 卡片高度。   |
-| TEMPORARY_KEY          | "ohos.extra.param.key.form_temporary"   | 临时卡片。   |
\ No newline at end of file
+| TEMPORARY_KEY          | "ohos.extra.param.key.form_temporary"   | 临时卡片。   |
+| ABILITY_NAME_KEY<sup>9+</sup>   | "ohos.extra.param.key.ability_name"   | ability名称   |
+| DEVICE_ID_KEY<sup>9+</sup>      | "ohos.extra.param.key.device_id"   | 设备标识。<br/>此接口为系统接口。   |
\ No newline at end of file

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

@@ -48,4 +48,5 @@ SystemCapability.Ability.Form
 | ERR_SYSTEM_RESPONSES_FAILED        | 30    | 系统服务响应失败   |
 | ERR_FORM_DUPLICATE_ADDED        | 31    | 重复添加卡片   |
 | ERR_IN_RECOVERY    | 36    | 卡片数据覆盖失败   |
+| ERR_DISTRIBUTED_SCHEDULE_FAILED<sup>9+</sup> | 37 | 分布式调度失败。<br/>此接口为系统接口。  |
 

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

@@ -249,4 +249,41 @@ onAcquireFormState?(want: Want): formInfo.FormState;
           return formInfo.FormState.UNKNOWN;
       }
   }
+  ```
+
+## FormExtension.onShare
+
+onShare?(formId: string): {[key: string]: any};
+
+卡片提供方接收卡片分享的通知接口。
+
+此接口为系统接口。
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+  | 参数名 | 类型 | 必填 | 说明 | 
+  | -------- | -------- | -------- | -------- |
+  | formId | string | 是   | 卡片标识 |
+
+**返回值：**
+
+  | 类型                                                         | 说明                                                        |
+  | ------------------------------------------------------------ | ----------------------------------------------------------- |
+  | {[key: string]: any} | 卡片要分享的数据，由开发者自行决定传入的键值对。 |
+
+**示例：**
+    
+  ```js
+  class MyFormExtension extends FormExtension {
+      onShare(formId) {
+          console.log('FormExtension onShare, formId:' + formId);
+          let wantParams = {
+            "temperature":"20",
+            "time":"2022-8-8 09:59",
+          };
+          return wantParams;
+      }
+  }
   ```
\ No newline at end of file

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

@@ -1120,4 +1120,72 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean):
   }).catch((error) => {
       console.log('formHost notifyFormsEnableUpdate, error:' + JSON.stringify(error));
   });
+  ```
+## shareForm<sup>9+</sup>
+
+shareForm(formId: string, deviceId: string, callback: AsyncCallback&lt;void&gt;): void;
+
+指定formId和远程设备Id进行卡片分享。
+
+此接口为系统接口。
+
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+| 参数名 | 类型    | 必填 | 说明    |
+| ------ | ------ | ---- | ------- |
+| formId | string | 是   | 卡片标识 |
+| deviceId | string | 是   | 远程设备标识 |
+| callback | AsyncCallback&lt;void&gt; | 是 | callback形式返回结果 |
+
+**示例：**
+
+  ```js
+  var formId = "12400633174999288";
+  var deviceId = "EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2";
+  formHost.shareForm(formId, deviceId, (error, data) => {
+      if (error.code) {
+          console.log('formHost shareForm, error:' + JSON.stringify(error));
+      }
+  });
+  ```
+
+## shareForm<sup>9+</sup>
+
+shareForm(formId: string, deviceId: string): Promise&lt;void&gt;;
+
+指定formId和远程设备Id进行卡片分享。
+
+此接口为系统接口。
+
+**需要权限**：ohos.permission.REQUIRE_FORM
+
+**系统能力**：SystemCapability.Ability.Form
+
+**参数：**
+
+  | 参数名 | 类型    | 必填 | 说明    |
+  | ------ | ------ | ---- | ------- |
+  | formId | string | 是   | 卡片标识 |
+  | deviceId | string | 是   | 远程设备标识 |
+
+**返回值：**
+
+  | 类型 | 说明 |
+  | -------- | -------- |
+  | Promise&lt;void&gt; | 返回一个Promise，包含接口的结果 |
+
+**参数：**
+
+  ```js
+  var formId = "12400633174999288";
+  var deviceId = "EFC11C0C53628D8CC2F8CB5052477E130D075917034613B9884C55CD22B3DEF2";
+  formHost.shareForm(formId, deviceId).then(() => {
+      console.log('formHost shareForm success');
+  }).catch((error) => {
+      console.log('formHost shareForm, error:' + JSON.stringify(error));
+  });
   ```
\ No newline at end of file