!6299 翻译完成：4972 新增requestPublishForm接口描述

Merge pull request !6299 from wusongqing/TR4972

en/application-dev/reference/apis/js-apis-formprovider.md

 # FormProvider
 
-> **NOTE**<br>
-> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
+The **FormProvider** module provides APIs related to the widget provider. You can use the APIs to update a widget, set the next refresh time for a widget, obtain widget information, and release a widget release.
 
-Provides APIs related to the widget provider.
+> **NOTE**
+> 
+> The initial APIs of this module are supported since API version 8. Newly added APIs will be marked with a superscript to indicate their earliest API version.
 
 ## Modules to Import
 
@@ -27,11 +28,11 @@ SystemCapability.Ability.Form
 
 **Parameters**
 
-  | Name| Type   | Mandatory| Description                                  |
-  | ------ | ------ | ---- | ------------------------------------- |
-  | formId | string | Yes  | ID of a widget.                              |
-  | minute | number | Yes  | Refresh interval, in minutes. The value must be greater than or equal to 5.    |
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type   | Mandatory| Description                                  |
+| ------ | ------ | ---- | ------------------------------------- |
+| formId | string | Yes  | ID of a widget.                              |
+| minute | number | Yes  | Refresh interval, in minutes. The value must be greater than or equal to 5.    |
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
 
 **Example**
 
@@ -56,16 +57,16 @@ SystemCapability.Ability.Form
 
 **Parameters**
 
-  | Name| Type   | Mandatory| Description                                  |
-  | ------ | ------ | ---- | ------------------------------------- |
-  | formId | string | Yes  | ID of a widget.                              |
-  | minute | number | Yes  | Refresh interval, in minutes. The value must be greater than or equal to 5.    |
+| Name| Type   | Mandatory| Description                                  |
+| ------ | ------ | ---- | ------------------------------------- |
+| formId | string | Yes  | ID of a widget.                              |
+| minute | number | Yes  | Refresh interval, in minutes. The value must be greater than or equal to 5.    |
 
 **Return value**
 
-  | Type         | Description                             |
-  | ------------- | ---------------------------------- |
-  | Promise\<void> |Promise used to return the result.     |
+| Type         | Description                             |
+| ------------- | ---------------------------------- |
+| Promise\<void> |Promise used to return the result.     |
 
 **Example**
 
@@ -90,11 +91,11 @@ SystemCapability.Ability.Form
 
 **Parameters**
 
-  | Name| Type                                                                   | Mandatory| Description            |
-  | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
-  | formId | string                                                                 | Yes  | ID of the widget to update.|
-  | formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data to be used for the update.   |
-  | callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
+| Name| Type                                                                   | Mandatory| Description            |
+| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
+| formId | string                                                                 | Yes  | ID of the widget to update.|
+| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data to be used for the update.   |
+| callback | AsyncCallback&lt;void&gt; | Yes| Callback used to return the result.|
 
 **Example**
 
@@ -121,10 +122,10 @@ SystemCapability.Ability.Form
 
 **Parameters**
 
-  | Name| Type                                                                   | Mandatory| Description            |
-  | ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
-  | formId | string                                                                 | Yes  | ID of the widget to update.|
-  | formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data to be used for the update.   |
+| Name| Type                                                                   | Mandatory| Description            |
+| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
+| formId | string                                                                 | Yes  | ID of the widget to update.|
+| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data to be used for the update.   |
 
 **Return value**
 
@@ -144,3 +145,289 @@ SystemCapability.Ability.Form
       console.log('formProvider updateForm, error:' + JSON.stringify(error));
   });
   ```
+
+## getFormsInfo<sup>9+</sup>
+
+getFormsInfo(callback: AsyncCallback&lt;Array&lt;formInfo.FormInfo&gt;&gt;): void;
+
+Obtains the application's widget information on the device. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type   | Mandatory| Description   |
+| ------ | ------ | ---- | ------- |
+| callback | AsyncCallback&lt;Array&lt;[FormInfo](./js-apis-formInfo.md#forminfo-1)&gt;&gt; | Yes| Callback used to return the widget information.|
+
+**Example**
+
+```js
+formProvider.getFormsInfo((error, data) => {
+    if (error.code) {
+        console.log('formProvider getFormsInfo, error:' + JSON.stringify(error));
+    } else {
+        console.log('formProvider getFormsInfo, data:' + JSON.stringify(data));
+    }
+});
+```
+## getFormsInfo<sup>9+</sup>
+
+getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback&lt;Array&lt;formInfo.FormInfo&gt;&gt;): void;
+
+Obtains the application's widget information that meets a filter criterion on the device. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type   | Mandatory| Description   |
+| ------ | ------ | ---- | ------- |
+| filter | formInfo.FormInfoFilter | Yes| Filter criterion.|
+| callback | AsyncCallback&lt;Array&lt;[FormInfo](./js-apis-formInfo.md#forminfo-1)&gt;&gt; | Yes| Callback used to return the widget information.|
+
+**Example**
+
+```js
+const filter : formInfo.FormInfoFilter = {
+    moduleName : "entry"
+};
+formProvider.getFormsInfo(filter, (error, data) => {
+    if (error.code) {
+        console.log('formProvider getFormsInfo, error:' + JSON.stringify(error));
+    } else {
+        console.log('formProvider getFormsInfo, data:' + JSON.stringify(data));
+    }
+});
+```
+
+## getFormsInfo<sup>9+</sup>
+
+getFormsInfo(filter?: formInfo.FormInfoFilter): Promise&lt;Array&lt;formInfo.FormInfo&gt;&gt;;
+
+Obtains the application's widget information on the device. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type   | Mandatory| Description   |
+| ------ | ------ | ---- | ------- |
+| filter | formInfo.FormInfoFilter | No| Filter criterion.|
+
+**Return value**
+
+| Type         | Description                               |
+| :------------ | :---------------------------------- |
+| Promise&lt;Array&lt;[FormInfo](./js-apis-formInfo.md#forminfo-1)&gt;&gt; | Promise used to return the widget information.|
+
+**Example**
+
+```js
+const filter : formInfo.FormInfoFilter = {
+    moduleName : "entry"
+};
+formProvider.getFormsInfo(filter).then((data) => {
+    console.log('formProvider getFormsInfo, data:' + JSON.stringify(data));
+}).catch((error) => {
+    console.log('formProvider getFormsInfo, error:' + JSON.stringify(error));
+});
+```
+
+## requestPublishForm<sup>9+</sup>
+
+requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback&lt;string&gt;): &lt;void&gt;;
+
+Requests to publish a widget carrying data to the widget host. This API uses an asynchronous callback to return the result.
+
+**System capability**
+
+SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type                                                                   | Mandatory| Description            |
+| ------ | ---------------------------------------------------------------------- | ---- | ---------------- |
+| want | [Want](js-apis-application-Want.md)                           | Yes  | Information about the target widget.<br>**abilityName**: ability of the target widget.<br>**parameters**:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
+| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | Yes  | Data used for creating the widget.|
+| callback | AsyncCallback&lt;string&gt; | Yes| Callback used to return the widget ID.|
+
+**Example**
+
+  ```js
+  import formBindingData from '@ohos.application.formBindingData';
+  var want = {
+      abilityName: "FormAbility",
+      parameters: {
+          "ohos.extra.param.key.form_dimension": 2,
+          "ohos.extra.param.key.form_name": "widget",
+          "ohos.extra.param.key.module_name": "entry"
+      }
+  };
+  let obj = formBindingData.createFormBindingData({temperature:"22c", time:"22:00"});
+  formProvider.requestPublishForm(want, obj, (error, data) => {
+      if (error.code) {
+          console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+      } else {
+          console.log('formProvider requestPublishForm, form ID is: ' + JSON.stringify(data));
+      }
+  });
+  ```
+
+## requestPublishForm<sup>9+</sup>
+
+requestPublishForm(want: Want, callback: AsyncCallback&lt;string&gt;): &lt;void&gt;;
+
+Requests to publish a widget to the widget host. This API uses an asynchronous callback to return the result.
+
+**System capability**
+
+SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name  | Type                               | Mandatory| Description                                                        |
+| -------- | ----------------------------------- | ---- | ------------------------------------------------------------ |
+| want     | [Want](js-apis-application-Want.md) | Yes  | Information about the target widget.<br>**abilityName**: ability of the target widget.<br>**parameters**:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
+| callback | AsyncCallback&lt;string&gt;         | Yes  | Callback used to return the widget ID.                                    |
+
+**Example**
+
+  ```js
+  var want = {
+      abilityName: "FormAbility",
+      parameters: {
+          "ohos.extra.param.key.form_dimension": 2,
+          "ohos.extra.param.key.form_name": "widget",
+          "ohos.extra.param.key.module_name": "entry"
+      }
+  };
+  formProvider.requestPublishForm(want, (error, data) => {
+      if (error.code) {
+          console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+      } else {
+          console.log('formProvider requestPublishForm, form ID is: ' + JSON.stringify(data));
+      }
+  });
+  ```
+
+## requestPublishForm<sup>9+</sup>
+
+requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData): Promise&lt;string&gt;;
+
+Requests to publish a widget to the widget host. This API uses a promise to return the result.
+
+**System capability**
+
+SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name         | Type                                                        | Mandatory| Description                                                        |
+| --------------- | ------------------------------------------------------------ | ---- | ------------------------------------------------------------ |
+| want            | [Want](js-apis-application-Want.md)                          | Yes  | Information about the target widget.<br>**abilityName**: ability of the target widget.<br>**parameters**:<br>"ohos.extra.param.key.form_dimension"<br>"ohos.extra.param.key.form_name"<br>"ohos.extra.param.key.module_name" |
+| formBindingData | [FormBindingData](js-apis-formbindingdata.md#formbindingdata) | No  | Data used for creating the widget.                                          |
+
+**Return value**
+
+| Type         | Description                               |
+| :------------ | :---------------------------------- |
+| Promise&lt;string&gt; | Promise used to return the widget ID.|
+
+**Example**
+
+  ```js
+  var want = {
+      abilityName: "FormAbility",
+      parameters: {
+          "ohos.extra.param.key.form_dimension": 2,
+          "ohos.extra.param.key.form_name": "widget",
+          "ohos.extra.param.key.module_name": "entry"
+      }
+  };
+  formProvider.requestPublishForm(want).then((data) => {
+      console.log('formProvider requestPublishForm success, form ID is :' + JSON.stringify(data));
+  }).catch((error) => {
+      console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+  });
+  ```
+
+## isRequestPublishFormSupported<sup>9+<sup>
+
+isRequestPublishFormSupported(callback: AsyncCallback&lt;boolean&gt;): void;
+
+Checks whether a widget can be published to the widget host. This API uses an asynchronous callback to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Parameters**
+
+| Name| Type   | Mandatory| Description   |
+| ------ | ------ | ---- | ------- |
+| callback | AsyncCallback&lt;boolean&gt; | Yes| Callback used to return the result.|
+
+**Example**
+
+```js
+formProvider.isRequestPublishFormSupported((error, isSupported) => {
+  if (error.code) {
+    console.log('formProvider isRequestPublishFormSupported, error:' + JSON.stringify(error));
+  } else {
+    if (isSupported) {
+      var want = {
+      abilityName: "FormAbility",
+      parameters: {
+        "ohos.extra.param.key.form_dimension": 2,
+        "ohos.extra.param.key.form_name": "widget",
+        "ohos.extra.param.key.module_name": "entry"
+      }
+      };
+      formProvider.requestPublishForm(want, (error, data) => {
+        if (error.code) {
+          console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+        } else {
+          console.log('formProvider requestPublishForm, form ID is: ' + JSON.stringify(data));
+        }
+      });
+    }
+  }
+});
+```
+
+## isRequestPublishFormSupported<sup>9+</sup>
+
+isRequestPublishFormSupported(): Promise&lt;boolean&gt;;
+
+Checks whether a widget can be published to the widget host. This API uses a promise to return the result.
+
+**System capability**: SystemCapability.Ability.Form
+
+**Return value**
+
+| Type         | Description                               |
+| :------------ | :---------------------------------- |
+| Promise&lt;boolean&gt; | Promise used to return the result.|
+
+**Example**
+
+```js
+formProvider.isRequestPublishFormSupported().then((isSupported) => {
+  if (isSupported) {
+    var want = {
+    abilityName: "FormAbility",
+    parameters: {
+        "ohos.extra.param.key.form_dimension": 2,
+        "ohos.extra.param.key.form_name": "widget",
+        "ohos.extra.param.key.module_name": "entry"
+    }
+    };
+    formProvider.requestPublishForm(want).then((data) => {
+      console.log('formProvider requestPublishForm success, form ID is :' + JSON.stringify(data));
+    }).catch((error) => {
+      console.log('formProvider requestPublishForm, error: ' + JSON.stringify(error));
+    });
+  }
+}).catch((error) => {
+  console.log('formProvider isRequestPublishFormSupported, error:' + JSON.stringify(error));
+});
+```