From 6f16f99d113695ba290adc6b329bf51489e4f4ff Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Sun, 29 Jun 2025 14:20:03 +0800 Subject: [PATCH 01/15] =?UTF-8?q?form=E5=AD=90=E7=B3=BB=E7=BB=9F=E5=8F=98?= =?UTF-8?q?=E6=9B=B4=E8=AF=B4=E6=98=8E=20changelog?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../OpenHarmony_6.0.0.39/changelogs-form.md | 117 ++++++++++++++++++ 1 file changed, 117 insertions(+) create mode 100644 zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md new file mode 100644 index 00000000000..6e83f1e779c --- /dev/null +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -0,0 +1,117 @@ +# 卡片框架子系统变更说明 + +## cl.form.1 配置文件form_config禁用手势配置项disabledDesktopBehaviors类型变更。 + +**访问级别** + +公开接口。 + +**变更原因** + +disabledDesktopBehaviors修改为字符串枚举方式配置，提升开发者使用效率。 + +**变更影响** + +此变更涉及自研系统应用适配，开发者需要修改禁用手势配置方式。 +变更前：自研系统应用配置互动卡片禁用手势时，需使用|分割的字符串进行配置。 +变更后：自研系统应用配置互动卡片禁用手势时，使用枚举字符串类型进行配置。 + +**起始 API Level** + +API 20。 + +**变更发生版本** + +从OpenHarmony SDK 6.0.0.39开始。 + +**变更的接口/组件** + +变更涉及[配置ArkTS卡片的配置文件](../../../application-dev/form/arkts-ui-widget-configuration.md)中的disabledDesktopBehaviors配置项。 +变更前：自研系统应用配置互动卡片禁用手势时，需使用|分割的字符串进行配置，形如"disabledDesktopBehaviors":"LONG_CLICK|DRAG" 。 +变更后：自研系统应用配置互动卡片禁用手势时，使用枚举字符串类型进行配置，IDE 支持联想，形如"disabledDesktopBehaviors":\["LONG_CLICK","DRAG"\]。 + +**适配指导** + +开发者需要修改禁用手势配置方式，否则代码工程编译失败。 +变更前：自研系统应用配置互动卡片禁用手势时，需使用|分割的字符串进行配置，形如"disabledDesktopBehaviors":"LONG_CLICK|DRAG" 。 + +```ts +"sceneAnimationParams": { + "abilityName": "UiExtAbility", + "disabledDesktopBehaviors": "LONG_CLICK|DRAG|SWIPE_DESKTOP|PULL_DOWN_SEARCH" +} +``` + +变更后：自研系统应用配置互动卡片禁用手势时，使用枚举字符串类型进行配置，IDE 支持联想，形如"disabledDesktopBehaviors":\["LONG_CLICK","DRAG"\]。 + +```ts +"sceneAnimationParams": { + "abilityName": "UiExtAbility", + "disabledDesktopBehaviors": [ + "LONG_CLICK", "DRAG", "SWIPE_DESKTOP", "PULL_DOWN_SEARCH" + ] +} +``` + +## cl.form.2 互动卡片加桌时触发内容动效机制变更 + +**访问级别** + +公共能力 + +**变更原因** + +互动卡片生命周期管理整改，不再支持互动卡片加桌时触发内容动效。 + +**变更影响** + +此变更不涉及应用适配。 +变更前：互动卡片加桌时系统侧主动额外触发卡片生命周期 unUpdateForm，进而支持开发者在此生命周期中触发内容动效。 +变更后：互动卡片加桌时系统侧不再主动额外触发卡片生命周期 unUpdateForm。 + +**起始 API Level** + +API 20。 + +**变更发生版本** + +从OpenHarmony SDK 6.0.0.39开始。 + +**变更的接口/组件** + +变更涉及[@ohos.app.form.FormExtensionAbility (FormExtensionAbility)](../../../application-dev/reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md)中的onUpdateForm接口默认行为。 + +**适配指导** + +默认行为变更，无需适配。 + +## cl.form.3 LiveFormExtensionContext.setBackgroundImage接口删除 + +**访问级别** + +公开接口。 + +**删除原因** + +setBackgroundImage 接口限制开发者图片资源大小，且涉及图片资源跨进程传输，联调中开发者可在应用进程中绘制背景，该接口未实际使用。 + +**删除影响** + +该变更为不兼容变更。接口删除后，开发者需在应用进程中自行绘制背景组件。 + +**删除发生版本** + +从OpenHarmony SDK 6.0.0.39开始。 + +**删除的接口/组件** + +```ts +LiveFormExtensionContext.setBackgroundImage +``` +**替代接口** + +无，开发者可在应用进程中直接自行绘制背景组件。 + +**适配指导** + +开发者可在应用进程中直接自行绘制背景组件。 \ No newline at end of file -- Gitee From eb2972b0689582f702cda6bb9b96f9b42267d8fc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Sun, 29 Jun 2025 15:21:15 +0800 Subject: [PATCH 02/15] =?UTF-8?q?form=E5=AD=90=E7=B3=BB=E7=BB=9FchangeLog?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../OpenHarmony_6.0.0.39/changelogs-form.md | 31 ++++++++++--------- 1 file changed, 16 insertions(+), 15 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index 6e83f1e779c..dcfed28eb2c 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -1,6 +1,6 @@ # 卡片框架子系统变更说明 -## cl.form.1 配置文件form_config禁用手势配置项disabledDesktopBehaviors类型变更。 +## cl.form.1 配置文件 `form_config` 禁用手势配置项 `disabledDesktopBehaviors` 类型变更 **访问级别** @@ -8,13 +8,13 @@ **变更原因** -disabledDesktopBehaviors修改为字符串枚举方式配置，提升开发者使用效率。 +变更disabledDesktopBehaviors为字符串枚举配置，以提升使用效率。 **变更影响** -此变更涉及自研系统应用适配，开发者需要修改禁用手势配置方式。 -变更前：自研系统应用配置互动卡片禁用手势时，需使用|分割的字符串进行配置。 -变更后：自研系统应用配置互动卡片禁用手势时，使用枚举字符串类型进行配置。 +涉及自研系统应用，应用需变更禁用手势的配置方式。 +变更前：配置互动卡片时，禁用手势需使用|分割的字符串。 +变更后：配置互动卡片时，禁用手势需使用枚举类型。 **起始 API Level** @@ -32,7 +32,7 @@ API 20。 **适配指导** -开发者需要修改禁用手势配置方式，否则代码工程编译失败。 +开发者需要修改禁用手势配置方式，否则将导致代码工程编译失败。 变更前：自研系统应用配置互动卡片禁用手势时，需使用|分割的字符串进行配置，形如"disabledDesktopBehaviors":"LONG_CLICK|DRAG" 。 ```ts @@ -57,17 +57,17 @@ API 20。 **访问级别** -公共能力 +公开接口。 **变更原因** -互动卡片生命周期管理整改，不再支持互动卡片加桌时触发内容动效。 +互动卡片生命周期管理整改，不再支持加桌时触发内容动效。 **变更影响** 此变更不涉及应用适配。 -变更前：互动卡片加桌时系统侧主动额外触发卡片生命周期 unUpdateForm，进而支持开发者在此生命周期中触发内容动效。 -变更后：互动卡片加桌时系统侧不再主动额外触发卡片生命周期 unUpdateForm。 +变更前：添加互动卡片到桌面时，系统会主动触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。 +变更后：添加互动卡片到桌面时，系统不再主动触发卡片生命周期中的unUpdateForm事件。 **起始 API Level** @@ -83,7 +83,7 @@ API 20。 **适配指导** -默认行为变更，无需适配。 +接口默认行为变更，无需适配。 ## cl.form.3 LiveFormExtensionContext.setBackgroundImage接口删除 @@ -93,11 +93,11 @@ API 20。 **删除原因** -setBackgroundImage 接口限制开发者图片资源大小，且涉及图片资源跨进程传输，联调中开发者可在应用进程中绘制背景，该接口未实际使用。 +`setBackgroundImage` 接口限制图片资源大小，并涉及跨进程传输。开发时可在应用进程中绘制背景，不依赖此接口。 **删除影响** -该变更为不兼容变更。接口删除后，开发者需在应用进程中自行绘制背景组件。 +该变更为不兼容变更。接口删除后，需在应用进程中自行绘制背景组件。 **删除发生版本** @@ -108,10 +108,11 @@ setBackgroundImage 接口限制开发者图片资源大小，且涉及图片资 ```ts LiveFormExtensionContext.setBackgroundImage ``` + **替代接口** -无，开发者可在应用进程中直接自行绘制背景组件。 +无替代接口。开发者可在应用进程中直接绘制背景组件。 **适配指导** -开发者可在应用进程中直接自行绘制背景组件。 \ No newline at end of file +开发者可在应用进程中直接自行绘制背景组件。 -- Gitee From 1bd21f9b293694a42dac30363f360b35df40946b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Sun, 29 Jun 2025 15:25:39 +0800 Subject: [PATCH 03/15] =?UTF-8?q?form=20=E5=AD=90=E7=B3=BB=E7=BB=9F?= =?UTF-8?q?=E5=8F=98=E6=9B=B4=20changelog?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index dcfed28eb2c..b3a00556638 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -1,6 +1,6 @@ # 卡片框架子系统变更说明 -## cl.form.1 配置文件 `form_config` 禁用手势配置项 `disabledDesktopBehaviors` 类型变更 +## cl.form.1 配置文件form_config禁用手势配置项disabledDesktopBehaviors类型变更 **访问级别** @@ -93,7 +93,7 @@ API 20。 **删除原因** -`setBackgroundImage` 接口限制图片资源大小，并涉及跨进程传输。开发时可在应用进程中绘制背景，不依赖此接口。 +setBackgroundImage接口限制图片资源大小，并涉及跨进程传输。开发时可在应用进程中绘制背景，不依赖此接口。 **删除影响** -- Gitee From f83afd4d47829352140f3906be02c8886c6db537 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Sun, 29 Jun 2025 18:59:57 +0800 Subject: [PATCH 04/15] =?UTF-8?q?form=20=E5=AD=90=E7=B3=BB=E7=BB=9F?= =?UTF-8?q?=E5=8F=98=E6=9B=B4=20changelog?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index b3a00556638..b3c5f2ab99f 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -13,8 +13,8 @@ **变更影响** 涉及自研系统应用，应用需变更禁用手势的配置方式。 -变更前：配置互动卡片时，禁用手势需使用|分割的字符串。 -变更后：配置互动卡片时，禁用手势需使用枚举类型。 +变更前：配置互动卡片时，禁用手势为使用|分割的字符串。 +变更后：配置互动卡片时，禁用手势为字符串数组。 **起始 API Level** -- Gitee From c5ecef18401c51c2225f34f87db94701f566574e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Mon, 30 Jun 2025 07:06:37 +0000 Subject: [PATCH 05/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index b3c5f2ab99f..22beda3c11c 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -66,8 +66,8 @@ API 20。 **变更影响** 此变更不涉及应用适配。 -变更前：添加互动卡片到桌面时，系统会主动触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。 -变更后：添加互动卡片到桌面时，系统不再主动触发卡片生命周期中的unUpdateForm事件。 +变更前：添加互动卡片到桌面时，系统会主动触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。开发者通过此生命周期获得卡片尺寸信息。 +变更后：添加互动卡片到桌面时，系统不再主动触发卡片生命周期中的unUpdateForm事件。开发者通过新增接口formProvider.getFormRect获得卡片最新尺寸信息。 **起始 API Level** @@ -83,7 +83,7 @@ API 20。 **适配指导** -接口默认行为变更，无需适配。 +接口默认行为变更，卡片尺寸信息查询通过新增接口formProvider.getFormRect查询获得。 ## cl.form.3 LiveFormExtensionContext.setBackgroundImage接口删除 -- Gitee From b740c405f3622603ea8ad9937a10a1a652391d4c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Mon, 30 Jun 2025 07:14:09 +0000 Subject: [PATCH 06/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index 22beda3c11c..590bc667104 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -61,11 +61,11 @@ API 20。 **变更原因** -互动卡片生命周期管理整改，不再支持加桌时触发内容动效。 +互动卡片生命周期管理整改，不再支持加桌时触发内容动效。不再支持互动卡片加桌时传递卡片位置、尺寸信息 **变更影响** -此变更不涉及应用适配。 +涉及应用适配，开发者需修改卡片尺寸获取方式。 变更前：添加互动卡片到桌面时，系统会主动触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。开发者通过此生命周期获得卡片尺寸信息。 变更后：添加互动卡片到桌面时，系统不再主动触发卡片生命周期中的unUpdateForm事件。开发者通过新增接口formProvider.getFormRect获得卡片最新尺寸信息。 -- Gitee From 961191038f1e929ba25b458fcaadf149e45641bf Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Mon, 30 Jun 2025 08:54:33 +0000 Subject: [PATCH 07/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../OpenHarmony_6.0.0.39/changelogs-form.md | 91 ++++++++++++++++++- 1 file changed, 90 insertions(+), 1 deletion(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index 590bc667104..e1662720d88 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -106,7 +106,19 @@ setBackgroundImage接口限制图片资源大小，并涉及跨进程传输。 **删除的接口/组件** ```ts -LiveFormExtensionContext.setBackgroundImage + /** + * Set the background image of the live form. + * + * @param { Resource } res - Resource of the background image. + * @returns { Promise } The promise returned by the function. + * @throws { BusinessError } 801 - Capability not supported. Failed to call the API due to limited device capabilities. + * @throws { BusinessError } 16501010 - Failed to set live form background image. + * @syscap SystemCapability.Ability.Form + * @stagemodelonly + * @atomicservice + * @since 20 + */ + setBackgroundImage(res: Resource): Promise; ``` **替代接口** @@ -116,3 +128,80 @@ LiveFormExtensionContext.setBackgroundImage **适配指导** 开发者可在应用进程中直接自行绘制背景组件。 + +## cl.form.4 formInfo.FORM_WIDTH_VP_KEY和formInfo.FORM_HEIGHT_VP_KEY接口删除 + +**访问级别** + +公开接口。 + +**删除原因** + +添加互动卡片到桌面时，系统会主动触发卡片的生命周期事件unUpdateForm，其中通过formInfo.FORM_WIDTH_VP_KEY和formInfo.FORM_HEIGHT_VP_KEY字段提供卡片尺寸信息。当前该机制已整改，所以删除对应字段 + +**删除影响** + +该变更为不兼容变更。接口删除后，卡片不再通过onUpdateForm提供卡片尺寸信息。 + +**删除发生版本** + +从OpenHarmony SDK 6.0.0.39开始。 + +**删除的接口/组件** + +```ts + /** + * Indicates the key specifying the width(vp) of the form to be obtained, which is represented as + * want: { + * "parameters": { + * FORM_WIDTH_VP_KEY: 400vp + * } + * } + * + * @syscap SystemCapability.Ability.Form + * @atomicservice + * @since 20 + */ + FORM_WIDTH_VP_KEY = 'ohos.extra.param.key.form_width_vp', + + /** + * Indicates the key specifying the height(vp) of the form to be obtained, which is represented as + * want: { + * "parameters": { + * FORM_HEIGHT_VP_KEY: 400vp + * } + * } + * + * @syscap SystemCapability.Ability.Form + * @atomicservice + * @since 20 + */ + FORM_HEIGHT_VP_KEY = 'ohos.extra.param.key.form_height_vp', +``` + +**替代接口** +```ts + /** + * Get form rect belonging to current bundle + * + * @param { string } formId + * + * @returns { Promise } + * @throws { BusinessError } 801 - Capability not supported.function getFormRect can not work correctly + * due to limited device capabilities. + * @throws { BusinessError } 16500050 - IPC connection error. + * @throws { BusinessError } 16500060 - Service connection error. + * @throws { BusinessError } 16500100 - Failed to obtain the configuration information. + * @throws { BusinessError } 16501000 - An internal functional error occurred. + * @throws { BusinessError } 16501001 - The ID of the form to be operated does not exist. + * @throws { BusinessError } 16501003 - The form cannot be operated by the current application. + * @syscap SystemCapability.Ability.Form + * @atomicservice + * @since 20 + */ + function getFormRect(formId: string): Promise; +``` + +**适配指导** + +卡片尺寸信息查询通过新增接口formProvider.getFormRect查询获得。 -- Gitee From 6b378d24e0033a9ab0872abcb2bb1271901656b5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Mon, 30 Jun 2025 08:55:51 +0000 Subject: [PATCH 08/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index e1662720d88..6246fc44c67 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -66,8 +66,8 @@ API 20。 **变更影响** 涉及应用适配，开发者需修改卡片尺寸获取方式。 -变更前：添加互动卡片到桌面时，系统会主动触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。开发者通过此生命周期获得卡片尺寸信息。 -变更后：添加互动卡片到桌面时，系统不再主动触发卡片生命周期中的unUpdateForm事件。开发者通过新增接口formProvider.getFormRect获得卡片最新尺寸信息。 +变更前：添加互动卡片到桌面时，系统会主动额外触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。开发者通过此生命周期获得卡片尺寸信息。 +变更后：添加互动卡片到桌面时，系统不再主动额外触发卡片生命周期中的unUpdateForm事件。开发者通过新增接口formProvider.getFormRect获得卡片最新尺寸信息。 **起始 API Level** -- Gitee From 39d99bbb1d927bec9c855b078680006f3b3714d0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Wed, 2 Jul 2025 00:24:55 +0000 Subject: [PATCH 09/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../OpenHarmony_6.0.0.39/changelogs-form.md | 55 ++++--------------- 1 file changed, 10 insertions(+), 45 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index 6246fc44c67..71a5defe1aa 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -1,20 +1,20 @@ # 卡片框架子系统变更说明 -## cl.form.1 配置文件form_config禁用手势配置项disabledDesktopBehaviors类型变更 +## cl.form.1 互动卡片disabledDesktopBehaviors禁用手势配置项类型变更 **访问级别** -公开接口。 +系统能力。 **变更原因** -变更disabledDesktopBehaviors为字符串枚举配置，以提升使用效率。 +disabledDesktopBehaviors配置项类型由字符串变更为字符串数组，提升使用效率。 **变更影响** -涉及自研系统应用，应用需变更禁用手势的配置方式。 -变更前：配置互动卡片时，禁用手势为使用|分割的字符串。 -变更后：配置互动卡片时，禁用手势为字符串数组。 +涉及自研华为音乐应用适配。 +变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，通过|拼接，例如："SWIPE_DESKTOP|PULL_DOWN_SEARCH"。 +变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，使用字符串数组形式，例如["SWIPE_DESKTOP", "PULL_DOWN_SEARCH"]。 **起始 API Level** @@ -26,32 +26,11 @@ API 20。 **变更的接口/组件** -变更涉及[配置ArkTS卡片的配置文件](../../../application-dev/form/arkts-ui-widget-configuration.md)中的disabledDesktopBehaviors配置项。 -变更前：自研系统应用配置互动卡片禁用手势时，需使用|分割的字符串进行配置，形如"disabledDesktopBehaviors":"LONG_CLICK|DRAG" 。 -变更后：自研系统应用配置互动卡片禁用手势时，使用枚举字符串类型进行配置，IDE 支持联想，形如"disabledDesktopBehaviors":\["LONG_CLICK","DRAG"\]。 +变更涉及[ArkTS卡片配置文件](../../../application-dev/form/arkts-ui-widget-configuration.md)中的disabledDesktopBehaviors配置项。 **适配指导** -开发者需要修改禁用手势配置方式，否则将导致代码工程编译失败。 -变更前：自研系统应用配置互动卡片禁用手势时，需使用|分割的字符串进行配置，形如"disabledDesktopBehaviors":"LONG_CLICK|DRAG" 。 - -```ts -"sceneAnimationParams": { - "abilityName": "UiExtAbility", - "disabledDesktopBehaviors": "LONG_CLICK|DRAG|SWIPE_DESKTOP|PULL_DOWN_SEARCH" -} -``` - -变更后：自研系统应用配置互动卡片禁用手势时，使用枚举字符串类型进行配置，IDE 支持联想，形如"disabledDesktopBehaviors":\["LONG_CLICK","DRAG"\]。 - -```ts -"sceneAnimationParams": { - "abilityName": "UiExtAbility", - "disabledDesktopBehaviors": [ - "LONG_CLICK", "DRAG", "SWIPE_DESKTOP", "PULL_DOWN_SEARCH" - ] -} -``` +针对场景动效类型互动卡片开发，开发者需要修改disabledDesktopBehaviors配置为字符串数组类型，例如："disabledDesktopBehaviors": ["SWIPE_DESKTOP", "PULL_DOWN_SEARCH"]，否则编译失败。 ## cl.form.2 互动卡片加桌时触发内容动效机制变更 @@ -105,21 +84,7 @@ setBackgroundImage接口限制图片资源大小，并涉及跨进程传输。 **删除的接口/组件** -```ts - /** - * Set the background image of the live form. - * - * @param { Resource } res - Resource of the background image. - * @returns { Promise } The promise returned by the function. - * @throws { BusinessError } 801 - Capability not supported. Failed to call the API due to limited device capabilities. - * @throws { BusinessError } 16501010 - Failed to set live form background image. - * @syscap SystemCapability.Ability.Form - * @stagemodelonly - * @atomicservice - * @since 20 - */ - setBackgroundImage(res: Resource): Promise; -``` +setBackgroundImage。 **替代接口** @@ -129,7 +94,7 @@ setBackgroundImage接口限制图片资源大小，并涉及跨进程传输。 开发者可在应用进程中直接自行绘制背景组件。 -## cl.form.4 formInfo.FORM_WIDTH_VP_KEY和formInfo.FORM_HEIGHT_VP_KEY接口删除 +## cl.form.4 formInfo.FORM_WIDTH_VP_KEY和formInfo.FORM_HEIGHT_VP_KEY删除 **访问级别** -- Gitee From 015f70615ca9bdf7b35761ac968f237322ce6f92 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Wed, 2 Jul 2025 00:26:35 +0000 Subject: [PATCH 10/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index 71a5defe1aa..f4fe2a973e8 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -13,7 +13,9 @@ disabledDesktopBehaviors配置项类型由字符串变更为字符串数组， **变更影响** 涉及自研华为音乐应用适配。 + 变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，通过|拼接，例如："SWIPE_DESKTOP|PULL_DOWN_SEARCH"。 + 变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，使用字符串数组形式，例如["SWIPE_DESKTOP", "PULL_DOWN_SEARCH"]。 **起始 API Level** @@ -45,7 +47,9 @@ API 20。 **变更影响** 涉及应用适配，开发者需修改卡片尺寸获取方式。 + 变更前：添加互动卡片到桌面时，系统会主动额外触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。开发者通过此生命周期获得卡片尺寸信息。 + 变更后：添加互动卡片到桌面时，系统不再主动额外触发卡片生命周期中的unUpdateForm事件。开发者通过新增接口formProvider.getFormRect获得卡片最新尺寸信息。 **起始 API Level** -- Gitee From 4f7b34ff7df58f71b21f3fd52f911dc08ce135be Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Wed, 2 Jul 2025 00:27:06 +0000 Subject: [PATCH 11/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index f4fe2a973e8..49b4f4ec204 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -16,7 +16,7 @@ disabledDesktopBehaviors配置项类型由字符串变更为字符串数组， 变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，通过|拼接，例如："SWIPE_DESKTOP|PULL_DOWN_SEARCH"。 -变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，使用字符串数组形式，例如["SWIPE_DESKTOP", "PULL_DOWN_SEARCH"]。 +变更后：配置互动卡片时，disabledDesktopBehaviors取值多个时，使用字符串数组形式，例如["SWIPE_DESKTOP", "PULL_DOWN_SEARCH"]。 **起始 API Level** -- Gitee From 8e60f27e4df16779b837fd039d2525a6fed870bc Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Wed, 2 Jul 2025 00:28:18 +0000 Subject: [PATCH 12/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index 49b4f4ec204..6c4b27577f0 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -12,7 +12,7 @@ disabledDesktopBehaviors配置项类型由字符串变更为字符串数组， **变更影响** -涉及自研华为音乐应用适配。 +不涉及暂不涉及已上架应用适配。 变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，通过|拼接，例如："SWIPE_DESKTOP|PULL_DOWN_SEARCH"。 -- Gitee From 3c3c73c75a2587a434cbfc77eadf575c4de1b7fe Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Wed, 2 Jul 2025 03:16:07 +0000 Subject: [PATCH 13/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index 6c4b27577f0..0a7dd238a74 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -12,7 +12,7 @@ disabledDesktopBehaviors配置项类型由字符串变更为字符串数组， **变更影响** -不涉及暂不涉及已上架应用适配。 +涉及系统应用适配。 变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，通过|拼接，例如："SWIPE_DESKTOP|PULL_DOWN_SEARCH"。 -- Gitee From c6524597abcf0a57fc510cf05e444179cdf355d8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Wed, 2 Jul 2025 06:03:44 +0000 Subject: [PATCH 14/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../OpenHarmony_6.0.0.39/changelogs-form.md | 20 +++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index 0a7dd238a74..b91f2508fce 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -4,7 +4,7 @@ **访问级别** -系统能力。 +系统接口。 **变更原因** @@ -12,7 +12,7 @@ disabledDesktopBehaviors配置项类型由字符串变更为字符串数组， **变更影响** -涉及系统应用适配。 +此变更涉及系统应用适配。 变更前：配置互动卡片时，disabledDesktopBehaviors取值多个时，通过|拼接，例如："SWIPE_DESKTOP|PULL_DOWN_SEARCH"。 @@ -46,11 +46,7 @@ API 20。 **变更影响** -涉及应用适配，开发者需修改卡片尺寸获取方式。 - -变更前：添加互动卡片到桌面时，系统会主动额外触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。开发者通过此生命周期获得卡片尺寸信息。 - -变更后：添加互动卡片到桌面时，系统不再主动额外触发卡片生命周期中的unUpdateForm事件。开发者通过新增接口formProvider.getFormRect获得卡片最新尺寸信息。 +此变更涉及应用适配。 **起始 API Level** @@ -66,7 +62,11 @@ API 20。 **适配指导** -接口默认行为变更，卡片尺寸信息查询通过新增接口formProvider.getFormRect查询获得。 +开发者需修改卡片尺寸获取方式。 + +变更前：添加互动卡片到桌面时，系统会主动额外触发卡片的生命周期事件unUpdateForm，支持在此事件中实现内容动画。开发者通过此生命周期获得卡片尺寸信息。 + +变更后：添加互动卡片到桌面时，系统不再主动额外触发卡片生命周期中的unUpdateForm事件。开发者通过新增接口formProvider.getFormRect获得卡片最新尺寸信息。 ## cl.form.3 LiveFormExtensionContext.setBackgroundImage接口删除 @@ -80,7 +80,7 @@ setBackgroundImage接口限制图片资源大小，并涉及跨进程传输。 **删除影响** -该变更为不兼容变更。接口删除后，需在应用进程中自行绘制背景组件。 +此变更涉及应用适配。接口删除后，需在应用进程中自行绘制背景组件。 **删除发生版本** @@ -110,7 +110,7 @@ setBackgroundImage。 **删除影响** -该变更为不兼容变更。接口删除后，卡片不再通过onUpdateForm提供卡片尺寸信息。 +此变更涉及应用适配。接口删除后，卡片不再通过onUpdateForm提供卡片尺寸信息。 **删除发生版本** -- Gitee From 00a08a0c03a0502ee1720ee050962c1118696fee Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E6=80=95=E9=BA=BB=E7=83=A6?= <354431057@qq.com> Date: Wed, 2 Jul 2025 06:07:18 +0000 Subject: [PATCH 15/15] update zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md. MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: 怕麻烦 <354431057@qq.com> --- .../changelogs/OpenHarmony_6.0.0.39/changelogs-form.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md index b91f2508fce..f02181f2f6e 100644 --- a/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md +++ b/zh-cn/release-notes/changelogs/OpenHarmony_6.0.0.39/changelogs-form.md @@ -4,7 +4,7 @@ **访问级别** -系统接口。 +系统接口 **变更原因** @@ -38,7 +38,7 @@ API 20。 **访问级别** -公开接口。 +公开接口 **变更原因** @@ -72,7 +72,7 @@ API 20。 **访问级别** -公开接口。 +公开接口 **删除原因** @@ -102,7 +102,7 @@ setBackgroundImage。 **访问级别** -公开接口。 +公开接口 **删除原因** -- Gitee