From 3593716d958af98e959e323938d4ab25aaa076e9 Mon Sep 17 00:00:00 2001
From: yangzk <yangzhongkai@huawei.com>
Date: Tue, 11 Oct 2022 11:12:26 +0800
Subject: [PATCH 1/2] 
 https://gitee.com/openharmony/interface_sdk-js/issues/I5V12A Signed-off-by:
 yangzk <yangzhongkai@huawei.com>

Change-Id: Ia45851e51eb5527d221971ddf97448180dde8758
---
 api/@ohos.app.form.formBindingData.d.ts    |  45 ++
 api/@ohos.app.form.formHost.d.ts           | 502 +++++++++++++++++++++
 api/@ohos.app.form.formProvider.d.ts       | 161 +++++++
 api/@ohos.application.FormExtension.d.ts   |   2 +-
 api/@ohos.application.formBindingData.d.ts |   2 +
 api/@ohos.application.formHost.d.ts        |   2 +
 api/@ohos.application.formProvider.d.ts    |   2 +
 api/application/FormExtensionContext.d.ts  |  20 +-
 8 files changed, 724 insertions(+), 12 deletions(-)
 create mode 100644 api/@ohos.app.form.formBindingData.d.ts
 create mode 100644 api/@ohos.app.form.formHost.d.ts
 create mode 100644 api/@ohos.app.form.formProvider.d.ts

diff --git a/api/@ohos.app.form.formBindingData.d.ts b/api/@ohos.app.form.formBindingData.d.ts
new file mode 100644
index 0000000000..ca2f215d47
--- /dev/null
+++ b/api/@ohos.app.form.formBindingData.d.ts
@@ -0,0 +1,45 @@
+/*
+ * Copyright (c) 2022 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { BusinessError } from './basic';
+
+/**
+ * interface of formBindingData.
+ * @namespace formBindingData
+ * @syscap SystemCapability.Ability.Form
+ * @since 9
+ */
+declare namespace formBindingData {
+    /**
+     * Create an FormBindingData instance.
+     * @param { Object | string } obj - Indicates the FormBindingData instance data.
+     * @returns { FormBindingData } Returns the FormBindingData.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    function createFormBindingData(obj?: Object | string): FormBindingData;
+
+    /**
+     * Defines the createFormBindingData result interface.
+     * @typedef FormBindingData
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    interface FormBindingData {
+        data: Object
+    }
+}
+export default formBindingData;
\ No newline at end of file
diff --git a/api/@ohos.app.form.formHost.d.ts b/api/@ohos.app.form.formHost.d.ts
new file mode 100644
index 0000000000..da71eab1e4
--- /dev/null
+++ b/api/@ohos.app.form.formHost.d.ts
@@ -0,0 +1,502 @@
+/*
+ * Copyright (c) 2022 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { AsyncCallback } from "./basic";
+import { Callback } from "./basic";
+import Want from './@ohos.application.Want';
+import formInfo from './@ohos.application.formInfo'
+
+/**
+ * interface of formHost.
+ * @namespace formHost
+ * @syscap SystemCapability.Ability.Form
+ * @systemapi
+ * @since 9
+ */
+declare namespace formHost {
+    /**
+     * Deletes an obtained form by its ID.
+     * <p>After this method is called, the form won't be available for use by the application and the Form Manager
+     * Service no longer keeps the cache information about the form.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the form ID.
+     * @param { AsyncCallback<void> } callback - The callback of deleteForm.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function deleteForm(formId: string, callback: AsyncCallback<void>): void;
+
+    /**
+     * Deletes an obtained form by its ID.
+     * <p>After this method is called, the form won't be available for use by the application and the Form Manager
+     * Service no longer keeps the cache information about the form.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the form ID.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function deleteForm(formId: string): Promise<void>;
+
+    /**
+     * Releases an obtained form by its ID.
+     * <p>After this method is called, the form won't be available for use by the application, but the Form Manager
+     * Service still keeps the cache information about the form, so that the application can quickly obtain it based on
+     * the {@code formId}.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the form ID
+     * @param { AsyncCallback<void> } callback - The callback of releaseForm.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function releaseForm(formId: string, callback: AsyncCallback<void>): void;
+
+    /**
+     * Releases an obtained form by its ID.
+     * <p>After this method is called, the form won't be available for use by the application, but the Form Manager
+     * Service still keeps the cache information about the form, so that the application can quickly obtain it based on
+     * the {@code formId}.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the form ID
+     * @param { boolean } isReleaseCache - Indicates whether release cache or not.
+     * @param { AsyncCallback<void> } callback - The callback of releaseForm.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback<void>): void;
+
+    /**
+     * Releases an obtained form by its ID.
+     * <p>After this method is called, the form won't be available for use by the application, but the Form Manager
+     * Service still keeps the cache information about the form, so that the application can quickly obtain it based on
+     * the {@code formId}.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the form ID
+     * @param { boolean } isReleaseCache - Indicates whether release cache or not.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function releaseForm(formId: string, isReleaseCache?: boolean): Promise<void>;
+
+    /**
+     * Requests for form update.
+     * <p>This method must be called when the application has detected that a system setting item (such as the language,
+     * resolution, or screen orientation) being listened for has changed. Upon receiving the update request, the form
+     * provider automatically updates the form data (if there is any update) through the form framework, with the update
+     * process being unperceivable by the application.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the ID of the form to update.
+     * @param { AsyncCallback<void> } callback - The callback of requestForm.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function requestForm(formId: string, callback: AsyncCallback<void>): void;
+
+    /**
+     * Requests for form update.
+     * <p>This method must be called when the application has detected that a system setting item (such as the language,
+     * resolution, or screen orientation) being listened for has changed. Upon receiving the update request, the form
+     * provider automatically updates the form data (if there is any update) through the form framework, with the update
+     * process being unperceivable by the application.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the ID of the form to update.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function requestForm(formId: string): Promise<void>;
+
+    /**
+     * Converts a specified temporary form that has been obtained by the application into a normal form.
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the ID of the temporary form to convert.
+     * @param { AsyncCallback<void> } callback - The callback of castTempForm.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function castTempForm(formId: string, callback: AsyncCallback<void>): void;
+
+    /**
+     * Converts a specified temporary form that has been obtained by the application into a normal form.
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { string } formId - Indicates the ID of the temporary form to convert.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function castTempForm(formId: string): Promise<void>;
+
+    /**
+     * Sends a notification to the form framework to make the specified forms visible.
+     * <p>After this method is successfully called, onVisibilityChange will be called to notify the form provider of
+     * the form visibility change event.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the IDs of the forms to be made visible.
+     * @param { AsyncCallback<void> } callback - The callback of notifyVisibleForms.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function notifyVisibleForms(formIds: Array<string>, callback: AsyncCallback<void>): void;
+
+    /**
+     * Sends a notification to the form framework to make the specified forms visible.
+     * <p>After this method is successfully called, onVisibilityChange will be called to notify the form provider of
+     * the form visibility change event.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the IDs of the forms to be made visible.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function notifyVisibleForms(formIds: Array<string>): Promise<void>;
+
+    /**
+     * Sends a notification to the form framework to make the specified forms invisible.
+     * <p>After this method is successfully called, onVisibilityChange will be called to notify the form provider of
+     * the form visibility change event.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the IDs of the forms to be made invisible.
+     * @param { AsyncCallback<void> } callback - The callback of notifyInvisibleForms.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function notifyInvisibleForms(formIds: Array<string>, callback: AsyncCallback<void>): void;
+
+    /**
+     * Sends a notification to the form framework to make the specified forms invisible.
+     * <p>After this method is successfully called, onVisibilityChange will be called to notify the form provider of
+     * the form visibility change event.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the IDs of the forms to be made invisible.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function notifyInvisibleForms(formIds: Array<string>): Promise<void>;
+
+    /**
+     * Notify the form framework to make the specified forms updatable.
+     * <p>You can use this method to set form refresh state to true, the form can receive new
+     * update from service.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the IDs of the forms to be made invisible.
+     * @param { AsyncCallback<void> } callback - The callback of enableFormsUpdate.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function enableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void;
+
+    /**
+     * Notify the form framework to make the specified forms updatable.
+     * <p>You can use this method to set form refresh state to true, the form can receive new
+     * update from service.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the IDs of the forms to be made invisible.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function enableFormsUpdate(formIds: Array<string>): Promise<void>;
+
+    /**
+     * Notifys the form framework to make the specified forms non updatable.
+     * <p>You can use this method to set form refresh state to false, the form do not receive
+     * new update from service.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the IDs of the forms to be made invisible.
+     * @param { AsyncCallback<void> } callback - The callback of disableFormsUpdate.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void;
+
+    /**
+     * Notifys the form framework to make the specified forms non updatable.
+     * <p>You can use this method to set form refresh state to false, the form do not receive
+     * new update from service.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the IDs of the forms to be made invisible.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function disableFormsUpdate(formIds: Array<string>): Promise<void>;
+
+    /**
+     * Checks whether the system is ready.
+     * <p>You can use this method to obtain the system is ready.</p>
+     * @param { AsyncCallback<void> } callback - The callback of isSystemReady.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function isSystemReady(callback: AsyncCallback<void>): void;
+
+    /**
+     * Checks whether the system is ready.
+     * <p>You can use this method to obtain the system is ready.</p>
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function isSystemReady(): Promise<void>;
+
+    /**
+     * Obtains the FormInfo objects provided by all applications on the device.
+     * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+     * @param { AsyncCallback<Array<formInfo.FormInfo>> } callback - The callback is used to return the FormInfo.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function getAllFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): void;
+
+    /**
+     * Obtains the FormInfo objects provided by all applications on the device.
+     * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+     * @returns { Promise<Array<formInfo.FormInfo>> } Returns the FormInfo.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function getAllFormsInfo(): Promise<Array<formInfo.FormInfo>>;
+
+    /**
+     * Obtains the FormInfo objects provided by a specified application on the device.
+     * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+     * @param { string } bundleName - Indicates the bundle name of the application.
+     * @param { AsyncCallback<Array<formInfo.FormInfo>> } callback - The callback is used to return the FormInfo.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function getFormsInfo(bundleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void;
+
+    /**
+     * Obtains the FormInfo objects provided by a specified application on the device.
+     * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+     * @param { string } bundleName - Indicates the bundle name of the application.
+     * @param { string } moduleName - Indicates the module name of the application.
+     * @param { AsyncCallback<Array<formInfo.FormInfo>> } callback - The callback is used to return the FormInfo.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function getFormsInfo(bundleName: string, moduleName: string, callback: AsyncCallback<Array<formInfo.FormInfo>>): void;
+
+    /**
+     * Obtains the FormInfo objects provided by a specified application on the device.
+     * @permission ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+     * @param { string } bundleName - Indicates the bundle name of the application.
+     * @param { string } moduleName - Indicates the module name of the application.
+     * @returns { Promise<Array<formInfo.FormInfo>> } Returns the FormInfo.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function getFormsInfo(bundleName: string, moduleName?: string): Promise<Array<formInfo.FormInfo>>;
+
+    /**
+     * Deletes invalid forms of the application in the Form Manager Service based on the list of.
+     * <p>You can use this method to delete invalid forms of the application.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the specified form id.
+     * @param { AsyncCallback<number> } callback - The callback is used to return the number of invalid forms deleted
+     *                                             by the Form Manager Service.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function deleteInvalidForms(formIds: Array<string>, callback: AsyncCallback<number>): void;
+
+    /**
+     * Deletes invalid forms of the application in the Form Manager Service based on the list of.
+     * <p>You can use this method to delete invalid forms of the application.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the specified form id.
+     * @returns { Promise<number> } Returns the number of invalid forms deleted by the Form Manager Service.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function deleteInvalidForms(formIds: Array<string>): Promise<number>;
+
+    /**
+     * Obtains the Form state.
+     * <p>You can use this method to obtains the form state.</p>
+     * @permission ohos.permission.REQUIRE_FORM and ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+     * @param { Want } want - Indicates want of the form.
+     * @param { AsyncCallback<formInfo.FormStateInfo> } callback - The callback is used to return the form state.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function acquireFormState(want: Want, callback: AsyncCallback<formInfo.FormStateInfo>): void;
+
+    /**
+     * Obtains the Form state.
+     * <p>You can use this method to obtains the form state.</p>
+     * @permission ohos.permission.REQUIRE_FORM and ohos.permission.GET_BUNDLE_INFO_PRIVILEGED
+     * @param { Want } want - Indicates want of the form.
+     * @returns { Promise<formInfo.FormStateInfo> } Returns the form state.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function acquireFormState(want: Want): Promise<formInfo.FormStateInfo>;
+
+    /**
+     * Listens to the event of uninstall form.
+     * <p>You can use this method to listen to the event of uninstall form.</p>
+     * @param { string } type - Indicates event type.
+     * @param { Callback<string> } callback - The callback of formUninstall.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function on(type: "formUninstall", callback: Callback<string>): void;
+
+    /**
+     * Cancels listening to the event of uninstall form.
+     * <p>You can use this method to cancel listening to the event of uninstall form.</p>
+     * @param { string } type - Indicates event type.
+     * @param { Callback<string> } callback - The callback of formUninstall.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function off(type: "formUninstall", callback?: Callback<string>): void;
+
+    /**
+     * notify form is Visible
+     * <p>You can use this method to notify form visible state.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the specified form id.
+     * @param { boolean } isVisible - Indicates whether visible.
+     * @param { AsyncCallback<void> } callback - The callback of notifyFormsVisible.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: AsyncCallback<void>): void;
+
+    /**
+     * notify form is Visible
+     * <p>You can use this method to notify form visible state.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the specified form id.
+     * @param { boolean } isVisible - Indicates whether visible.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<void>;
+
+    /**
+     * notify form enable update state.
+     * <p>You can use this method to notify form enable update state.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the specified form id.
+     * @param { boolean } isEnableUpdate - Indicates whether enable update.
+     * @param { AsyncCallback<void> } callback - The callback of notifyFormsEnableUpdate.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, callback: AsyncCallback<void>): void;
+
+    /**
+     * notify form enable update state.
+     * <p>You can use this method to notify form enable update state.</p>
+     * @permission ohos.permission.REQUIRE_FORM
+     * @param { Array<string> } formIds - Indicates the specified form id.
+     * @param { boolean } isEnableUpdate - Indicates whether enable update.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean): Promise<void>;
+
+    /**
+     * Share form by formId and deviceId.
+     * @permission ohos.permission.REQUIRE_FORM and ohos.permission.DISTRIBUTED_DATASYNC
+     * @param { string } formId - Indicates the form ID.
+     * @param { string } deviceId - Indicates the remote device ID.
+     * @param { AsyncCallback<void> } callback - The callback of shareForm.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>): void;
+    function shareForm(formId: string, deviceId: string): Promise<void>;
+}
+export default formHost;
\ No newline at end of file
diff --git a/api/@ohos.app.form.formProvider.d.ts b/api/@ohos.app.form.formProvider.d.ts
new file mode 100644
index 0000000000..61096b377d
--- /dev/null
+++ b/api/@ohos.app.form.formProvider.d.ts
@@ -0,0 +1,161 @@
+/*
+ * Copyright (c) 2022 Huawei Device Co., Ltd.
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import { AsyncCallback } from "./basic";
+import formBindingData from "./@ohos.app.form.formBindingData";
+import formInfo from "./@ohos.application.formInfo";
+import Want from "./@ohos.application.Want"
+
+/**
+ * interface of formProvider.
+ * @namespace formProvider
+ * @syscap SystemCapability.Ability.Form
+ * @since 9
+ */
+declare namespace formProvider {
+    /**
+     * Set next update time for a specified form.
+     * @param { string } formId - Indicates the form ID.
+     * @param { number } minute - Indicates duration minute before next update.
+     * @param { AsyncCallback<void> } callback - The callback of setFormNextRefreshTime.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    function setFormNextRefreshTime(formId: string, minute: number, callback: AsyncCallback<void>): void;
+
+    /**
+     * Set next update time for a specified form.
+     * @param { string } formId - Indicates the form ID.
+     * @param { number } minute - Indicates duration minute before next update.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    function setFormNextRefreshTime(formId: string, minute: number): Promise<void>;
+
+    /**
+     * Update a specified form.
+     * Client to communication with FormManagerService.
+     * @param { string } formId - Indicates the form ID.
+     * @param { formBindingData.FormBindingData } formBindingData - Indicates the form data.
+     * @param { AsyncCallback<void> } callback - The callback of updateForm.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    function updateForm(formId: string, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback<void>): void;
+
+    /**
+     * Update a specified form.
+     * Client to communication with FormManagerService.
+     * @param { string } formId - Indicates the form ID.
+     * @param { formBindingData.FormBindingData } formBindingData - Indicates the form data.
+     * @returns { Promise<void> } The promise returned by the function.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    function updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Promise<void>;
+
+    /**
+     * Get infos of all forms belonging to current bundle.
+     * Client to communication with FormManagerService.
+     * @param { formInfo.FormInfoFilter } filter - Indicates the requirements the forms that the formInfos belong to have to meet.
+     * @param { AsyncCallback<Array<formInfo.FormInfo>> } callback - The callback is used to return the formInfo.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    function getFormsInfo(filter: formInfo.FormInfoFilter, callback: AsyncCallback<Array<formInfo.FormInfo>>): void;
+
+    /**
+     * Get infos of all forms belonging to current bundle.
+     * Client to communication with FormManagerService.
+     * @param { AsyncCallback<Array<formInfo.FormInfo>> } callback - The callback is used to return the formInfo.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    function getFormsInfo(callback: AsyncCallback<Array<formInfo.FormInfo>>): void;
+
+    /**
+     * Get infos of all forms belonging to current bundle.
+     * Client to communication with FormManagerService.
+     * @param { formInfo.FormInfoFilter } filter - Indicates the requirements the forms that the formInfos belong to have to meet.
+     * @returns { Promise<Array<formInfo.FormInfo>> } Returns the formInfo.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @since 9
+     */
+    function getFormsInfo(filter?: formInfo.FormInfoFilter): Promise<Array<formInfo.FormInfo>>;
+
+    /**
+     * Request to publish a form to the form host.
+     * @param { Want } want - The want of the form to publish.
+     * @param { formBindingData.FormBindingData } formBindingData - Indicates the form data.
+     * @param { AsyncCallback<string> } callback - The callback is used to return the form id.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function requestPublishForm(want: Want, formBindingData: formBindingData.FormBindingData, callback: AsyncCallback<string>): void;
+
+    /**
+     * Request to publish a form to the form host.
+     * @param { Want } want - The want of the form to publish.
+     * @param { AsyncCallback<string> } callback - The callback is used to return the form id.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function requestPublishForm(want: Want, callback: AsyncCallback<string>): void;
+
+    /**
+     * Request to publish a form to the form host.
+     * @param { Want } want - The want of the form to publish.
+     * @param { formBindingData.FormBindingData } formBindingData - Indicates the form data.
+     * @returns { Promise<string> } Returns the form id.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function requestPublishForm(want: Want, formBindingData?: formBindingData.FormBindingData): Promise<string>;
+
+    /**
+     * Check if the request of publishing a form is supported by the host
+     * @param { AsyncCallback<boolean> } callback - The callback is used to return true if the request is supported.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void;
+
+    /**
+     * Check if the request of publishing a form is supported by the host
+     * @returns { Promise<boolean> } Returns true if the request is supported.
+     * @throws { BusinessError } 401 - If the input parameter is not valid parameter.
+     * @syscap SystemCapability.Ability.Form
+     * @systemapi
+     * @since 9
+     */
+    function isRequestPublishFormSupported(): Promise<boolean>;
+}
+export default formProvider;
\ No newline at end of file
diff --git a/api/@ohos.application.FormExtension.d.ts b/api/@ohos.application.FormExtension.d.ts
index c24bf532c5..4c52a8387e 100644
--- a/api/@ohos.application.FormExtension.d.ts
+++ b/api/@ohos.application.FormExtension.d.ts
@@ -13,7 +13,7 @@
  * limitations under the License.
  */
 
-import formBindingData from './@ohos.application.formBindingData';
+import formBindingData from './@ohos.app.form.formBindingData';
 import formInfo from "./@ohos.application.formInfo";
 import FormExtensionContext from "./application/FormExtensionContext";
 import Want from './@ohos.application.Want';
diff --git a/api/@ohos.application.formBindingData.d.ts b/api/@ohos.application.formBindingData.d.ts
index f961244748..502fc6d5cf 100644
--- a/api/@ohos.application.formBindingData.d.ts
+++ b/api/@ohos.application.formBindingData.d.ts
@@ -19,6 +19,8 @@
  * @name formBindingData
  * @since 8
  * @syscap SystemCapability.Ability.Form
+ * @deprecated since 9
+ * @useinstead @ohos.app.form.formBindingData
  */
 declare namespace formBindingData {
     /**
diff --git a/api/@ohos.application.formHost.d.ts b/api/@ohos.application.formHost.d.ts
index c410a898e3..127a9a8eff 100644
--- a/api/@ohos.application.formHost.d.ts
+++ b/api/@ohos.application.formHost.d.ts
@@ -25,6 +25,8 @@ import formInfo from './@ohos.application.formInfo'
  * @since 8
  * @syscap SystemCapability.Ability.Form
  * @systemapi hide for inner use.
+ * @deprecated since 9
+ * @useinstead @ohos.app.form.formHost
  */
 declare namespace formHost {
     /**
diff --git a/api/@ohos.application.formProvider.d.ts b/api/@ohos.application.formProvider.d.ts
index 8cf49dc98a..250323da7a 100644
--- a/api/@ohos.application.formProvider.d.ts
+++ b/api/@ohos.application.formProvider.d.ts
@@ -24,6 +24,8 @@ import Want from './@ohos.application.Want';
  * @name formProvider
  * @since 8
  * @syscap SystemCapability.Ability.Form
+ * @deprecated since 9
+ * @useinstead @ohos.app.form.formProvider
  */
 declare namespace formProvider {
     /**
diff --git a/api/application/FormExtensionContext.d.ts b/api/application/FormExtensionContext.d.ts
index 2f43e55ca8..95952a3bb0 100644
--- a/api/application/FormExtensionContext.d.ts
+++ b/api/application/FormExtensionContext.d.ts
@@ -15,28 +15,26 @@
 
 import { AsyncCallback } from "../basic";
 import ExtensionContext from "./ExtensionContext";
-import formBindingData from '../@ohos.application.formBindingData';
+import formBindingData from '../@ohos.app.form.formBindingData';
 import Want from '../@ohos.application.Want';
 
 /**
  * The context of form extension. It allows access to
  * formExtension-specific resources.
- *
- * @since 9
  * @syscap SystemCapability.Ability.Form
- * @permission N/A
- * @StageModelOnly
+ * @stagemodelonly
+ * @since 9
  */
 export default class FormExtensionContext extends ExtensionContext {
     /**
      * start an ability within the same bundle.
-     *
-     * @since 9
+     * @param { Want } want - includes ability name, parameters and relative info sending to an ability.
+     * @param { AsyncCallback<void> } callback - The callback of startAbility.
+     * @returns { Promise<void> } The promise returned by the function.
      * @syscap SystemCapability.Ability.Form
-     * @systemapi hide for inner use
-     * @param want includes ability name, parameters and relative info sending to an ability.
-     * @return -
-     * @StageModelOnly
+     * @systemapi
+     * @stagemodelonly
+     * @since 9
      */
     startAbility(want: Want, callback: AsyncCallback<void>): void;
     startAbility(want: Want): Promise<void>;
-- 
Gitee


From b653071b5783c5d08d0ae295845ec80b18610b93 Mon Sep 17 00:00:00 2001
From: yangzk <yangzhongkai@huawei.com>
Date: Tue, 11 Oct 2022 17:24:27 +0800
Subject: [PATCH 2/2] 
 https://gitee.com/openharmony/interface_sdk-js/issues/I5V12A

Signed-off-by: yangzk <yangzhongkai@huawei.com>
Change-Id: Ia45851e51eb5527d221971ddf97448180dde8758
---
 api/@ohos.app.form.formBindingData.d.ts    |  2 +-
 api/@ohos.app.form.formHost.d.ts           | 14 +++++++-------
 api/@ohos.app.form.formProvider.d.ts       |  4 ++--
 api/@ohos.application.formBindingData.d.ts |  2 +-
 api/@ohos.application.formHost.d.ts        | 16 +++++++++++++++-
 api/@ohos.application.formProvider.d.ts    |  2 +-
 6 files changed, 27 insertions(+), 13 deletions(-)

diff --git a/api/@ohos.app.form.formBindingData.d.ts b/api/@ohos.app.form.formBindingData.d.ts
index ca2f215d47..ebfa0528dc 100644
--- a/api/@ohos.app.form.formBindingData.d.ts
+++ b/api/@ohos.app.form.formBindingData.d.ts
@@ -16,7 +16,7 @@
 import { BusinessError } from './basic';
 
 /**
- * interface of formBindingData.
+ * Interface of formBindingData.
  * @namespace formBindingData
  * @syscap SystemCapability.Ability.Form
  * @since 9
diff --git a/api/@ohos.app.form.formHost.d.ts b/api/@ohos.app.form.formHost.d.ts
index da71eab1e4..4e066920eb 100644
--- a/api/@ohos.app.form.formHost.d.ts
+++ b/api/@ohos.app.form.formHost.d.ts
@@ -19,7 +19,7 @@ import Want from './@ohos.application.Want';
 import formInfo from './@ohos.application.formInfo'
 
 /**
- * interface of formHost.
+ * Interface of formHost.
  * @namespace formHost
  * @syscap SystemCapability.Ability.Form
  * @systemapi
@@ -242,7 +242,7 @@ declare namespace formHost {
     function enableFormsUpdate(formIds: Array<string>): Promise<void>;
 
     /**
-     * Notifys the form framework to make the specified forms non updatable.
+     * Notify the form framework to make the specified forms non-updatable.
      * <p>You can use this method to set form refresh state to false, the form do not receive
      * new update from service.</p>
      * @permission ohos.permission.REQUIRE_FORM
@@ -256,7 +256,7 @@ declare namespace formHost {
     function disableFormsUpdate(formIds: Array<string>, callback: AsyncCallback<void>): void;
 
     /**
-     * Notifys the form framework to make the specified forms non updatable.
+     * Notify the form framework to make the specified forms non updatable.
      * <p>You can use this method to set form refresh state to false, the form do not receive
      * new update from service.</p>
      * @permission ohos.permission.REQUIRE_FORM
@@ -429,7 +429,7 @@ declare namespace formHost {
     function off(type: "formUninstall", callback?: Callback<string>): void;
 
     /**
-     * notify form is Visible
+     * Notify form is Visible
      * <p>You can use this method to notify form visible state.</p>
      * @permission ohos.permission.REQUIRE_FORM
      * @param { Array<string> } formIds - Indicates the specified form id.
@@ -443,7 +443,7 @@ declare namespace formHost {
     function notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: AsyncCallback<void>): void;
 
     /**
-     * notify form is Visible
+     * Notify form is Visible
      * <p>You can use this method to notify form visible state.</p>
      * @permission ohos.permission.REQUIRE_FORM
      * @param { Array<string> } formIds - Indicates the specified form id.
@@ -457,7 +457,7 @@ declare namespace formHost {
     function notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise<void>;
 
     /**
-     * notify form enable update state.
+     * Notify form enable update state.
      * <p>You can use this method to notify form enable update state.</p>
      * @permission ohos.permission.REQUIRE_FORM
      * @param { Array<string> } formIds - Indicates the specified form id.
@@ -471,7 +471,7 @@ declare namespace formHost {
     function notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, callback: AsyncCallback<void>): void;
 
     /**
-     * notify form enable update state.
+     * Notify form enable update state.
      * <p>You can use this method to notify form enable update state.</p>
      * @permission ohos.permission.REQUIRE_FORM
      * @param { Array<string> } formIds - Indicates the specified form id.
diff --git a/api/@ohos.app.form.formProvider.d.ts b/api/@ohos.app.form.formProvider.d.ts
index 61096b377d..f2a87e039e 100644
--- a/api/@ohos.app.form.formProvider.d.ts
+++ b/api/@ohos.app.form.formProvider.d.ts
@@ -19,7 +19,7 @@ import formInfo from "./@ohos.application.formInfo";
 import Want from "./@ohos.application.Want"
 
 /**
- * interface of formProvider.
+ * Interface of formProvider.
  * @namespace formProvider
  * @syscap SystemCapability.Ability.Form
  * @since 9
@@ -72,7 +72,7 @@ declare namespace formProvider {
     function updateForm(formId: string, formBindingData: formBindingData.FormBindingData): Promise<void>;
 
     /**
-     * Get infos of all forms belonging to current bundle.
+     * Get info of all forms belonging to current bundle.
      * Client to communication with FormManagerService.
      * @param { formInfo.FormInfoFilter } filter - Indicates the requirements the forms that the formInfos belong to have to meet.
      * @param { AsyncCallback<Array<formInfo.FormInfo>> } callback - The callback is used to return the formInfo.
diff --git a/api/@ohos.application.formBindingData.d.ts b/api/@ohos.application.formBindingData.d.ts
index 502fc6d5cf..8da9f4fa83 100644
--- a/api/@ohos.application.formBindingData.d.ts
+++ b/api/@ohos.application.formBindingData.d.ts
@@ -20,7 +20,7 @@
  * @since 8
  * @syscap SystemCapability.Ability.Form
  * @deprecated since 9
- * @useinstead @ohos.app.form.formBindingData
+ * @useinstead ohos.app.form.formBindingData
  */
 declare namespace formBindingData {
     /**
diff --git a/api/@ohos.application.formHost.d.ts b/api/@ohos.application.formHost.d.ts
index 127a9a8eff..7f38585eda 100644
--- a/api/@ohos.application.formHost.d.ts
+++ b/api/@ohos.application.formHost.d.ts
@@ -26,7 +26,7 @@ import formInfo from './@ohos.application.formInfo'
  * @syscap SystemCapability.Ability.Form
  * @systemapi hide for inner use.
  * @deprecated since 9
- * @useinstead @ohos.app.form.formHost
+ * @useinstead ohos.app.form.formHost
  */
 declare namespace formHost {
     /**
@@ -283,5 +283,19 @@ declare namespace formHost {
      */
     function shareForm(formId: string, deviceId: string, callback: AsyncCallback<void>): void;
     function shareForm(formId: string, deviceId: string): Promise<void>;
+
+    /**
+     * notify form that privacy wether need to be protected.
+     *
+     * @since 9
+     * @syscap SystemCapability.Ability.Form
+     * @param formIds Indicates the specified form id.
+     * @param isProtected Indicates whether enable update.
+     * @systemapi hide for inner use.
+     * @return -
+     * @permission ohos.permission.REQUIRE_FORM.
+     */
+    function notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean, callback: AsyncCallback<void>): void;
+    function notifyFormsPrivacyProtected(formIds: Array<string>, isProtected: boolean): Promise<void>;
 }
 export default formHost;
\ No newline at end of file
diff --git a/api/@ohos.application.formProvider.d.ts b/api/@ohos.application.formProvider.d.ts
index 250323da7a..8c9c721645 100644
--- a/api/@ohos.application.formProvider.d.ts
+++ b/api/@ohos.application.formProvider.d.ts
@@ -25,7 +25,7 @@ import Want from './@ohos.application.Want';
  * @since 8
  * @syscap SystemCapability.Ability.Form
  * @deprecated since 9
- * @useinstead @ohos.app.form.formProvider
+ * @useinstead ohos.app.form.formProvider
  */
 declare namespace formProvider {
     /**
-- 
Gitee