From e588ea70a14ba18a2c63c09d8d20c3da2ac60a26 Mon Sep 17 00:00:00 2001 From: ouyanglihao Date: Wed, 2 Jul 2025 17:07:30 +0800 Subject: [PATCH 1/5] =?UTF-8?q?=E6=96=87=E6=A1=A3=E4=BC=98=E5=8C=96?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: ouyanglihao --- zh-cn/application-dev/form/arkts-form-overview.md | 2 +- zh-cn/application-dev/form/formkit-overview.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/form/arkts-form-overview.md b/zh-cn/application-dev/form/arkts-form-overview.md index b65519cad4c..4deb4e29071 100644 --- a/zh-cn/application-dev/form/arkts-form-overview.md +++ b/zh-cn/application-dev/form/arkts-form-overview.md @@ -69,7 +69,7 @@ ArkTS卡片相较于JS卡片具备了更加丰富的能力，但也增加了使 - 不支持使用native语言开发，不支持加载native so。 -- 仅支持[声明式范式](../ui/arkts-ui-development-overview.md)的部分组件、事件、动效、数据管理、状态管理和API能力。对于支持在ArkTS卡片中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。 +- 仅支持[声明式范式](../ui/arkts-ui-development-overview.md)的部分组件、事件、动效、数据管理、状态管理和API能力。对于支持在ArkTS卡片的UI界面中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。 - 卡片组件内容的事件处理和卡片使用方的事件处理是独立的，建议在使用方支持左右滑动的场景下卡片内容不要使用左右滑动功能的组件，以防手势冲突影响交互体验。 diff --git a/zh-cn/application-dev/form/formkit-overview.md b/zh-cn/application-dev/form/formkit-overview.md index cf62d295399..ceda7e362aa 100644 --- a/zh-cn/application-dev/form/formkit-overview.md +++ b/zh-cn/application-dev/form/formkit-overview.md @@ -8,7 +8,7 @@ Form Kit（卡片开发框架）提供了一种在桌面、锁屏等系统入口 - 卡片使用步骤： 1. 长按“桌面图标”，弹出操作菜单。 -2. 点击“服务卡片”选项，进入卡片管理页面，可以预览卡片。 +2. 点击“卡片”选项，进入卡片管理页面，可以预览卡片。 3. 点击“添加到桌面”按钮，即可在桌面上看到并操作新添加的卡片。 **图1** 卡片常见使用步骤 -- Gitee From 31798932ca0431a49bad8a9e0fcec00c973a8fdf Mon Sep 17 00:00:00 2001 From: ouyanglihao Date: Fri, 4 Jul 2025 15:12:25 +0800 Subject: [PATCH 2/5] =?UTF-8?q?=E4=BC=98=E5=8C=96=E6=96=87=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: ouyanglihao --- .../form/arkts-form-overview.md | 2 +- .../js-apis-app-form-formHost-sys.md | 16 ++++++++-------- .../js-apis-app-form-formProvider-sys.md | 4 ++-- ...-inner-application-formExtensionContext.md | 19 +++++++++++++++++++ 4 files changed, 30 insertions(+), 11 deletions(-) diff --git a/zh-cn/application-dev/form/arkts-form-overview.md b/zh-cn/application-dev/form/arkts-form-overview.md index 4deb4e29071..4bff17864b3 100644 --- a/zh-cn/application-dev/form/arkts-form-overview.md +++ b/zh-cn/application-dev/form/arkts-form-overview.md @@ -59,7 +59,7 @@ ArkTS卡片提供FormLink静态卡片交互组件，用于静态卡片内部和 请参见[FormLink](../reference/apis-arkui/arkui-ts/ts-container-formlink.md)。 ## 约束与限制 -ArkTS卡片相较于JS卡片具备了更加丰富的能力，但也增加了使用卡片进行恶意行为的风险。由于ArkTS卡片显示在卡片使用方应用中，卡片使用方应用一般为桌面应用，为确保桌面的使用体验以及功耗相关考虑，对ArkTS卡片的能力做了以下约束： +ArkTS卡片支持在UI内运行逻辑代码，相较于JS卡片具备了更加丰富的能力，但也增加了使用卡片进行恶意行为的风险。因为承载ArkTS卡片UI部分的widget.abc代码运行在系统公共的FRS进程内，并最终显示在卡片使用方应用中（一般为桌面应用），为确保系统渲染进程的稳定性、各卡片之间的隔离安全性，以及内存功耗等资源考虑，对ArkTS卡片UI可使用的能力做了以下约束： - 当前仅支持基于ArkUI开发卡片，不支持跨平台开发。 diff --git a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formHost-sys.md b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formHost-sys.md index c9463f72452..83b6eccc37e 100644 --- a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formHost-sys.md +++ b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formHost-sys.md @@ -186,7 +186,7 @@ releaseForm(formId: string, isReleaseCache: boolean, callback: AsyncCallback< | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ---- | ----------- | | formId | string | 是 | 卡片标识。 | -| isReleaseCache | boolean | 是 | 是否释放缓存。 | +| isReleaseCache | boolean | 是 | 表示是否释放缓存。
true: 表示释放缓存。
false: 表示不释放缓存。 | | callback | AsyncCallback<void> | 是 | 回调函数。当释放指定的卡片成功，error为undefined；否则为错误对象。 | **错误码：** @@ -237,7 +237,7 @@ releaseForm(formId: string, isReleaseCache?: boolean): Promise<void> | 参数名 | 类型 | 必填 | 说明 | | -------------- | ------ | ---- | ----------- | | formId | string | 是 | 卡片标识。 | -| isReleaseCache | boolean | 否 | 是否释放缓存，默认为false。 | +| isReleaseCache | boolean | 否 | 表示是否释放缓存，默认为false。
true: 表示释放缓存。
false: 表示不释放缓存。| **返回值：** @@ -1661,7 +1661,7 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean, callback: A | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array<string> | 是 | 卡片标识列表。 | -| isVisible | boolean | 是 | 是否可见。 | +| isVisible | boolean | 是 | 表示卡片是否可见。
true: 表示卡片可见。
false: 表示卡片不可见。 | | callback | AsyncCallback<void> | 是 | 回调函数。当通知卡片是否可见成功，error为undefined，否则为错误对象。 | **错误码：** @@ -1711,7 +1711,7 @@ notifyFormsVisible(formIds: Array<string>, isVisible: boolean): Promise< | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array<string> | 是 | 卡片标识列表。 | -| isVisible | boolean | 是 | 是否可见。 | +| isVisible | boolean | 是 | 表示卡片是否可见。
true: 表示卡片可见。
false: 表示卡片不可见。 | **返回值：** @@ -1766,7 +1766,7 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean, c | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array<string> | 是 | 卡片标识列表。 | -| isEnableUpdate | boolean | 是 | 是否使能更新。 | +| isEnableUpdate | boolean | 是 | 表示卡片是否使能更新状态。
true: 表示卡片使能更新状态。false: 表示卡片没有使能更新状态。| | callback | AsyncCallback<void> | 是 | 回调函数。当通知卡片是否启用更新状态成功，error为undefined，否则为错误对象。 | **错误码：** @@ -1816,7 +1816,7 @@ notifyFormsEnableUpdate(formIds: Array<string>, isEnableUpdate: boolean): | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array<string> | 是 | 卡片标识列表。 | -| isEnableUpdate | boolean | 是 | 是否使能更新。 | +| isEnableUpdate | boolean | 是 | 表示卡片是否使能更新状态。
true: 表示卡片使能更新状态。
false: 表示卡片没有使能更新状态。 | **返回值：** @@ -1977,7 +1977,7 @@ notifyFormsPrivacyProtected(formIds: Array\, isProtected: boolean, callb | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | | formIds | Array\ | 是 | 需要修改隐私保护的卡片标识列表。 | -| isProtected | boolean | 是 | 是否进行隐私保护。 | +| isProtected | boolean | 是 | 表示卡片是否进行隐私保护状态。
true: 表示卡片要进行隐私保护状态。
false: 表示卡片不需要进行隐私保护状态。 | | callback | AsyncCallback\ | 是 | 回调函数。当指定卡片设置隐私保护属性成功，error为undefined，否则为错误对象。 | **错误码：** @@ -2026,7 +2026,7 @@ notifyFormsPrivacyProtected(formIds: Array\, isProtected: boolean): Pro | 参数名 | 类型 | 必填 | 说明 | | ----------- | --------------- | ---- | -------------------------------- | | formIds | Array\ | 是 | 需要修改隐私保护的卡片标识列表。 | -| isProtected | boolean | 是 | 是否进行隐私保护。 | +| isProtected | boolean | 是 | 表示卡片是否进行隐私保护状态。
true: 表示卡片要进行隐私保护状态。
false: 表示卡片不需要进行隐私保护状态。 | **返回值：** diff --git a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md index 582deb4a46e..4bf0322df26 100644 --- a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md +++ b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md @@ -209,7 +209,7 @@ isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| callback | AsyncCallback<boolean> | 是 | 回调函数。返回是否支持发布一张卡片到使用方。| +| callback | AsyncCallback<boolean> | 是 | 返回查询结果的回调函数。
true: 表示支持发布一张卡片到使用方。
false: 表示不支持发布一张卡片到使用方。| **错误码：** @@ -276,7 +276,7 @@ isRequestPublishFormSupported(): Promise<boolean> | 类型 | 说明 | | :------------ | :---------------------------------- | -| Promise<boolean> | Promise对象。返回是否支持发布一张卡片到使用方。 | +| Promise<boolean> | Promise对象。返回是否支持发布一张卡片到使用方的结果。
true: 表示支持发布一张卡片到使用方。
false: 表示不支持发布一张卡片到使用方。| **错误码：** diff --git a/zh-cn/application-dev/reference/apis-form-kit/js-apis-inner-application-formExtensionContext.md b/zh-cn/application-dev/reference/apis-form-kit/js-apis-inner-application-formExtensionContext.md index 2877a782f2c..eac33014263 100644 --- a/zh-cn/application-dev/reference/apis-form-kit/js-apis-inner-application-formExtensionContext.md +++ b/zh-cn/application-dev/reference/apis-form-kit/js-apis-inner-application-formExtensionContext.md @@ -24,3 +24,22 @@ FormExtensionContext模块是[FormExtensionAbility](js-apis-app-form-formExtensi **模型约束：** 本模块接口仅可在Stage模型下使用。 **原子化服务API：** 从API version 11开始，该接口支持在原子化服务中使用。 + +## 使用场景 +FormExtensionContext主要用于查询所属FormExtension的信息、Module的配置信息以及HAP包的信息，开发者可根据自身业务需求使用对应的信息。 +```ts +import { FormExtensionAbility, formBindingData } from '@kit.FormKit'; +import { Want } from '@kit.AbilityKit'; + +export default class MyFormExtensionAbility extends FormExtensionAbility { + onAddForm(want: Want) { + console.info(`FormExtensionAbility onAddForm, want: ${want.abilityName}`); + let formData: Record = { + 'temperature': '11c', + 'time': '11:00' + }; + console.info("current language is：", this.context.config.language); + return formBindingData.createFormBindingData(formData); + } +}; +``` \ No newline at end of file -- Gitee From 7edc1460e49798029dc34cc77c1be3273cda43c7 Mon Sep 17 00:00:00 2001 From: ouyanglihao Date: Fri, 4 Jul 2025 15:46:36 +0800 Subject: [PATCH 3/5] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: ouyanglihao --- zh-cn/application-dev/form/formkit-overview.md | 2 +- .../apis-form-kit/js-apis-app-form-formProvider-sys.md | 8 ++++---- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/zh-cn/application-dev/form/formkit-overview.md b/zh-cn/application-dev/form/formkit-overview.md index ceda7e362aa..cf62d295399 100644 --- a/zh-cn/application-dev/form/formkit-overview.md +++ b/zh-cn/application-dev/form/formkit-overview.md @@ -8,7 +8,7 @@ Form Kit（卡片开发框架）提供了一种在桌面、锁屏等系统入口 - 卡片使用步骤： 1. 长按“桌面图标”，弹出操作菜单。 -2. 点击“卡片”选项，进入卡片管理页面，可以预览卡片。 +2. 点击“服务卡片”选项，进入卡片管理页面，可以预览卡片。 3. 点击“添加到桌面”按钮，即可在桌面上看到并操作新添加的卡片。 **图1** 卡片常见使用步骤 diff --git a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md index 4bf0322df26..e2035ec5eef 100644 --- a/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md +++ b/zh-cn/application-dev/reference/apis-form-kit/js-apis-app-form-formProvider-sys.md @@ -199,7 +199,7 @@ try { isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void -查询是否支持发布一张卡片到使用方，使用callback异步回调。 +查询是否支持静默添加卡片到使用方，使用callback异步回调。 **系统接口：** 此接口为系统接口。 @@ -209,7 +209,7 @@ isRequestPublishFormSupported(callback: AsyncCallback<boolean>): void | 参数名 | 类型 | 必填 | 说明 | | ------ | ------ | ---- | ------- | -| callback | AsyncCallback<boolean> | 是 | 返回查询结果的回调函数。
true: 表示支持发布一张卡片到使用方。
false: 表示不支持发布一张卡片到使用方。| +| callback | AsyncCallback<boolean> | 是 | 返回查询结果的回调函数。
true: 表示支持静默添加卡片到使用方。
false: 表示不支持静默添加卡片到使用方。| **错误码：** @@ -266,7 +266,7 @@ try { isRequestPublishFormSupported(): Promise<boolean> -查询是否支持发布一张卡片到使用方，使用Promise异步回调。 +查询是否支持静默添加到使用方，使用Promise异步回调。 **系统接口：** 此接口为系统接口。 @@ -276,7 +276,7 @@ isRequestPublishFormSupported(): Promise<boolean> | 类型 | 说明 | | :------------ | :---------------------------------- | -| Promise<boolean> | Promise对象。返回是否支持发布一张卡片到使用方的结果。
true: 表示支持发布一张卡片到使用方。
false: 表示不支持发布一张卡片到使用方。| +| Promise<boolean> | Promise对象。返回是否支持静默添加卡片到使用方的结果。
true: 表示支持静默添加卡片到使用方。
false: 表示不支持静默添加卡片到使用方。| **错误码：** -- Gitee From 4375e515f4f1f8ad768e5a95f480bbc120ace82a Mon Sep 17 00:00:00 2001 From: ouyanglihao Date: Fri, 4 Jul 2025 17:00:49 +0800 Subject: [PATCH 4/5] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: ouyanglihao --- zh-cn/application-dev/form/formkit-overview.md | 4 +++- .../apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md | 2 +- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/form/formkit-overview.md b/zh-cn/application-dev/form/formkit-overview.md index cf62d295399..8314049fab0 100644 --- a/zh-cn/application-dev/form/formkit-overview.md +++ b/zh-cn/application-dev/form/formkit-overview.md @@ -8,11 +8,13 @@ Form Kit（卡片开发框架）提供了一种在桌面、锁屏等系统入口 - 卡片使用步骤： 1. 长按“桌面图标”，弹出操作菜单。 -2. 点击“服务卡片”选项，进入卡片管理页面，可以预览卡片。 +2. 点击“服务卡片”选项，进入卡片管理页面，可以预览卡片。 3. 点击“添加到桌面”按钮，即可在桌面上看到并操作新添加的卡片。 **图1** 卡片常见使用步骤 + ![WidgetUse](figures/WidgetUse.png) + ## 服务卡片架构 **图2** 服务卡片架构 diff --git a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md index 47811d89b88..afb5592d98c 100644 --- a/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md +++ b/zh-cn/application-dev/reference/apis-arkui/arkui-ts/ohos-arkui-advanced-formmenu.md @@ -68,7 +68,7 @@ AddFormMenuItem( | 名称 | 类型 | 必填 | 说明 | | --------------- | ---- | ---- | ---------------------------------------------------------------- | | formBindingData | [formBindingData.FormBindingData](../../apis-form-kit/js-apis-app-form-formBindingData.md#formbindingdata) | 否 | 卡片数据。 | -| callback | AsyncCallback\ | 否 | 返回结果的回调。 | +| callback | AsyncCallback\ | 否 | 返回添加卡片是否成功的结果回调。回调中包含了卡片id和添加卡片是否成功的结果信息。如果是0表示卡片添加成功，非0参考[卡片错误码信息](../../apis-form-kit/errorcode-form.md) | | style | [FormMenuItemStyle](#formmenuitemstyle) | 否 | 菜单自定义样式信息。| -- Gitee From d27ade6db87535522d1422e47aee908c509317d4 Mon Sep 17 00:00:00 2001 From: ouyanglihao Date: Fri, 4 Jul 2025 17:08:55 +0800 Subject: [PATCH 5/5] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=A3=80=E8=A7=86?= =?UTF-8?q?=E6=84=8F=E8=A7=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: ouyanglihao --- zh-cn/application-dev/form/arkts-form-overview.md | 2 +- zh-cn/application-dev/form/arkts-ui-widget-page-overview.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/application-dev/form/arkts-form-overview.md b/zh-cn/application-dev/form/arkts-form-overview.md index 4bff17864b3..1b47314e228 100644 --- a/zh-cn/application-dev/form/arkts-form-overview.md +++ b/zh-cn/application-dev/form/arkts-form-overview.md @@ -69,7 +69,7 @@ ArkTS卡片支持在UI内运行逻辑代码，相较于JS卡片具备了更加 - 不支持使用native语言开发，不支持加载native so。 -- 仅支持[声明式范式](../ui/arkts-ui-development-overview.md)的部分组件、事件、动效、数据管理、状态管理和API能力。对于支持在ArkTS卡片的UI界面中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。 +- 针对卡片UI页面开发，ArkTS卡片仅支持[声明式范式](../ui/arkts-ui-development-overview.md)的部分组件、事件、动效、数据管理、状态管理和API能力。对于支持在ArkTS卡片UI页面中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。 - 卡片组件内容的事件处理和卡片使用方的事件处理是独立的，建议在使用方支持左右滑动的场景下卡片内容不要使用左右滑动功能的组件，以防手势冲突影响交互体验。 diff --git a/zh-cn/application-dev/form/arkts-ui-widget-page-overview.md b/zh-cn/application-dev/form/arkts-ui-widget-page-overview.md index d86803e2f42..7b3a001f564 100644 --- a/zh-cn/application-dev/form/arkts-ui-widget-page-overview.md +++ b/zh-cn/application-dev/form/arkts-ui-widget-page-overview.md @@ -10,7 +10,7 @@ ArkTS卡片开发采用通用[ArkTS语言](../quick-start/arkts-get-st ArkTS卡片具备JS卡片的全量能力，并且新增了动效能力和自定义绘制的能力，支持[声明式范式](../ui/arkts-ui-development-overview.md)的部分组件、事件、动效、数据管理、状态管理能力。 -对于支持在ArkTS卡片中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。同时请留意卡片场景下的能力差异说明。 +对于支持在ArkTS卡片UI界面中使用的接口，会添加“卡片能力”的标记：从API version x开始，该接口支持在ArkTS卡片中使用。同时请留意卡片场景下的能力差异说明。 例如：以下说明表示CircleShape可在ArkTS卡片中使用。 -- Gitee