From 139d384c3475f7e74295455d92ffe4bb6adaa344 Mon Sep 17 00:00:00 2001 From: pdf001 <1626385780@qq.com> Date: Wed, 2 Jul 2025 10:47:11 +0000 Subject: [PATCH] =?UTF-8?q?master=EF=BC=8C=E4=BF=AE=E6=94=B9=E6=96=AD?= =?UTF-8?q?=E9=93=BE=E9=97=AE=E9=A2=98?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: pdf001 <1626385780@qq.com> --- zh-cn/application-dev/form/arkts-form-overview.md | 2 +- zh-cn/application-dev/form/arkts-ui-widget-event-call.md | 2 +- .../form/arkts-ui-widget-event-formextensionability.md | 2 +- zh-cn/application-dev/form/arkts-ui-widget-event-overview.md | 2 +- zh-cn/application-dev/form/arkts-ui-widget-event-router.md | 2 +- zh-cn/application-dev/form/arkts-ui-widget-event-uiability.md | 2 +- .../form/arkts-ui-widget-interaction-overview.md | 2 +- .../internationalization/l10n-hard-coding-concatenate.md | 2 +- .../internationalization/l10n-multilingual-resources.md | 2 +- .../quick-start/application-package-install-uninstall.md | 2 +- zh-cn/application-dev/task-management/native-transient-task.md | 2 +- 11 files changed, 11 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 b65519cad4c..d1981e77fc9 100644 --- a/zh-cn/application-dev/form/arkts-form-overview.md +++ b/zh-cn/application-dev/form/arkts-form-overview.md @@ -44,7 +44,7 @@ ArkTS卡片分为动态卡片与静态卡片两种类型。 | 动态卡片 | 除了支持UI组件和布局能力，还支持通用事件能力和自定义动效能力。 | 用于有复杂业务逻辑和交互的场景。例如：卡片页面图片的刷新、卡片内容的刷新等。| 功能丰富但内存开销较大。| ### 动态卡片 -ArkTS卡片中提供了[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction)接口用于动态卡片内部和提供方应用间的交互，当前支持router、message和call三种类型的事件，仅在卡片控件的点击事件中可以调用。 +ArkTS卡片中提供了[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction-1)接口用于动态卡片内部和提供方应用间的交互，当前支持router、message和call三种类型的事件，仅在卡片控件的点击事件中可以调用。 **图4** 动态卡片事件实现原理 ![WidgetPostCardAction](figures/WidgetPostCardAction.png) diff --git a/zh-cn/application-dev/form/arkts-ui-widget-event-call.md b/zh-cn/application-dev/form/arkts-ui-widget-event-call.md index 6b31773bb3a..9ed229dda6d 100644 --- a/zh-cn/application-dev/form/arkts-ui-widget-event-call.md +++ b/zh-cn/application-dev/form/arkts-ui-widget-event-call.md @@ -1,7 +1,7 @@ # 卡片拉起应用UIAbility到后台（call事件） -许多应用希望借助卡片的能力，实现和应用在前台时相同的功能。例如音乐卡片，卡片上提供播放、暂停等按钮，点击不同按钮将触发音乐应用的不同功能，进而提高用户的体验。在卡片中使用[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction)接口的call能力，能够将卡片提供方应用的指定的UIAbility拉到后台。同时，call能力提供了调用应用指定方法、传递数据的功能，使应用在后台运行时可以通过卡片上的按钮执行不同的功能。 +许多应用希望借助卡片的能力，实现和应用在前台时相同的功能。例如音乐卡片，卡片上提供播放、暂停等按钮，点击不同按钮将触发音乐应用的不同功能，进而提高用户的体验。在卡片中使用[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction-1)接口的call能力，能够将卡片提供方应用的指定的UIAbility拉到后台。同时，call能力提供了调用应用指定方法、传递数据的功能，使应用在后台运行时可以通过卡片上的按钮执行不同的功能。 > **说明：** > diff --git a/zh-cn/application-dev/form/arkts-ui-widget-event-formextensionability.md b/zh-cn/application-dev/form/arkts-ui-widget-event-formextensionability.md index de60c436bd0..fb13f720dcb 100644 --- a/zh-cn/application-dev/form/arkts-ui-widget-event-formextensionability.md +++ b/zh-cn/application-dev/form/arkts-ui-widget-event-formextensionability.md @@ -1,6 +1,6 @@ # 卡片传递消息给应用（message事件） -在卡片页面中可以通过[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction)接口触发message事件拉起[FormExtensionAbility](../reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md)，通过[onFormEvent](../reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md#formextensionabilityonformevent)接口回调通知，以完成点击卡片控件后传递消息给应用的功能，然后由FormExtensionAbility刷新卡片内容，下面是这种刷新方式的简单示例。 +在卡片页面中可以通过[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction-1)接口触发message事件拉起[FormExtensionAbility](../reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md)，通过[onFormEvent](../reference/apis-form-kit/js-apis-app-form-formExtensionAbility.md#formextensionabilityonformevent)接口回调通知，以完成点击卡片控件后传递消息给应用的功能，然后由FormExtensionAbility刷新卡片内容，下面是这种刷新方式的简单示例。 > **说明：** > diff --git a/zh-cn/application-dev/form/arkts-ui-widget-event-overview.md b/zh-cn/application-dev/form/arkts-ui-widget-event-overview.md index 29e16a6e89c..1f70cb139cd 100644 --- a/zh-cn/application-dev/form/arkts-ui-widget-event-overview.md +++ b/zh-cn/application-dev/form/arkts-ui-widget-event-overview.md @@ -1,6 +1,6 @@ # ArkTS卡片页面交互概述 -ArkTS卡片提供页面交互能力，包括卡片与卡片提供方（例如：应用）的页面跳转、卡片拉起卡片提供方进程、卡片与卡片提供方的消息传递。其中[动态卡片](arkts-form-overview.md#动态卡片)可以使用[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction)接口、[静态卡片](arkts-form-overview.md#静态卡片)使用[FormLink](../reference/apis-arkui/arkui-ts/ts-container-formlink.md)实现页面交互功能。并且postCardAction和FormLink，均支持router、message和call三种类型的事件，具体使用场景如下： +ArkTS卡片提供页面交互能力，包括卡片与卡片提供方（例如：应用）的页面跳转、卡片拉起卡片提供方进程、卡片与卡片提供方的消息传递。其中[动态卡片](arkts-form-overview.md#动态卡片)可以使用[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction-1)接口、[静态卡片](arkts-form-overview.md#静态卡片)使用[FormLink](../reference/apis-arkui/arkui-ts/ts-container-formlink.md)实现页面交互功能。并且postCardAction和FormLink，均支持router、message和call三种类型的事件，具体使用场景如下： - [router事件](arkts-ui-widget-event-router.md)：可以使用router事件跳转到指定UIAbility，以完成点击卡片跳转至应用内页面的功能。对于非系统应用仅支持跳转到自己应用内的UIAbility。 - [call事件](arkts-ui-widget-event-call.md)：可以使用call事件拉起指定UIAbility到后台，再通过UIAbility申请对应后台长时任务完成音乐播放等功能。 diff --git a/zh-cn/application-dev/form/arkts-ui-widget-event-router.md b/zh-cn/application-dev/form/arkts-ui-widget-event-router.md index 938b214b4d3..08ab413fbc8 100644 --- a/zh-cn/application-dev/form/arkts-ui-widget-event-router.md +++ b/zh-cn/application-dev/form/arkts-ui-widget-event-router.md @@ -1,6 +1,6 @@ # 卡片跳转到应用页面（router事件） -在动态卡片中使用[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction)接口的router能力，能够快速拉起动态卡片提供方应用的指定UIAbility(页面)，因此UIAbility较多的应用往往会通过卡片提供不同的跳转按钮，实现一键直达的效果。例如相机卡片，卡片上提供拍照、录像等按钮，点击不同按钮将拉起相机应用的不同UIAbility，从而提高用户的体验。 +在动态卡片中使用[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction-1)接口的router能力，能够快速拉起动态卡片提供方应用的指定UIAbility(页面)，因此UIAbility较多的应用往往会通过卡片提供不同的跳转按钮，实现一键直达的效果。例如相机卡片，卡片上提供拍照、录像等按钮，点击不同按钮将拉起相机应用的不同UIAbility，从而提高用户的体验。 ![WidgerCameraCard](figures/WidgerCameraCard.png) diff --git a/zh-cn/application-dev/form/arkts-ui-widget-event-uiability.md b/zh-cn/application-dev/form/arkts-ui-widget-event-uiability.md index 81c4b3ef4b1..974c3c8e1cb 100644 --- a/zh-cn/application-dev/form/arkts-ui-widget-event-uiability.md +++ b/zh-cn/application-dev/form/arkts-ui-widget-event-uiability.md @@ -1,6 +1,6 @@ # 通过router或call事件刷新卡片内容 -使用router事件，点击卡片可拉起对应应用的UIAbility至前台，并刷新卡片。使用call事件，点击卡片可拉起对应应用的UIAbility至后台，并刷新卡片。在卡片页面中可以通过[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction)接口触发router事件或者call事件拉起UIAbility，然后由UIAbility刷新卡片内容，下面是这种刷新方式的简单示例。 +使用router事件，点击卡片可拉起对应应用的UIAbility至前台，并刷新卡片。使用call事件，点击卡片可拉起对应应用的UIAbility至后台，并刷新卡片。在卡片页面中可以通过[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction-1)接口触发router事件或者call事件拉起UIAbility，然后由UIAbility刷新卡片内容，下面是这种刷新方式的简单示例。 > **说明：** > diff --git a/zh-cn/application-dev/form/arkts-ui-widget-interaction-overview.md b/zh-cn/application-dev/form/arkts-ui-widget-interaction-overview.md index 3a9c5850ef1..8af67488b39 100644 --- a/zh-cn/application-dev/form/arkts-ui-widget-interaction-overview.md +++ b/zh-cn/application-dev/form/arkts-ui-widget-interaction-overview.md @@ -4,7 +4,7 @@ ## 卡片数据交互 -ArkTS卡片框架提供卡片提供方（例如：应用）和卡片的数据交互能力。其中卡片通过[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction)传递数据给卡片提供方，卡片提供方可以通过[updateForm](../reference/apis-form-kit/js-apis-app-form-formProvider.md#formproviderupdateform)接口传递数据给卡片。卡片提供方将数据提供给卡片后，可以用于卡片页面刷新等。 +ArkTS卡片框架提供卡片提供方（例如：应用）和卡片的数据交互能力。其中卡片通过[postCardAction](../reference/apis-arkui/js-apis-postCardAction.md#postcardaction-1)传递数据给卡片提供方，卡片提供方可以通过[updateForm](../reference/apis-form-kit/js-apis-app-form-formProvider.md#formproviderupdateform)接口传递数据给卡片。卡片提供方将数据提供给卡片后，可以用于卡片页面刷新等。 由于卡片提供方和卡片为相互独立的进程，两者间的数据共享只能通过[LocalStorageProp](../ui/state-management/arkts-localstorage.md#localstorageprop)传递，不能使用getContext方法。因此卡片提供方推送数据后，卡片UI需要通过LocalStorageProp接收数据，且接收数据时，卡片数据会被转换成string类型。 diff --git a/zh-cn/application-dev/internationalization/l10n-hard-coding-concatenate.md b/zh-cn/application-dev/internationalization/l10n-hard-coding-concatenate.md index 7ebd67c7f0e..fed26b2ab93 100644 --- a/zh-cn/application-dev/internationalization/l10n-hard-coding-concatenate.md +++ b/zh-cn/application-dev/internationalization/l10n-hard-coding-concatenate.md @@ -10,7 +10,7 @@ ## 约束与限制 -1. 避免使用硬编码，将需要翻译的字符串提取到资源文件中，与代码分离，然后使用相关的接口加载，具体请参考[提供多语言资源](./l10n-multilingual-resources.md#提供多语言资源)。 +1. 避免使用硬编码，将需要翻译的字符串提取到资源文件中，与代码分离，然后使用相关的接口加载，具体请参考[提供多语言资源](./l10n-multilingual-resources.md)。 2. 避免字符串直接拼接，若语句存在变化部分（如“打开视频”和“打开浏览器”，变化部分是“视频”和“浏览器”），对应变量应使用占位标识，呈现完整的语句表达。 资源占位符示例： diff --git a/zh-cn/application-dev/internationalization/l10n-multilingual-resources.md b/zh-cn/application-dev/internationalization/l10n-multilingual-resources.md index 3bc2037aed9..8d677174542 100644 --- a/zh-cn/application-dev/internationalization/l10n-multilingual-resources.md +++ b/zh-cn/application-dev/internationalization/l10n-multilingual-resources.md @@ -26,7 +26,7 @@ > > - 应用本地化的推荐作法是将本地化的内容与核心功能尽可能分开，本地化内容放置在资源目录下。 > - > - 创建资源目录、资源组目录和资源文件的具体操作请参考[资源分类与访问](../quick-start/resource-categories-and-access.md#资源分类与访问)。 + > - 创建资源目录、资源组目录和资源文件的具体操作请参考[资源分类与访问](../quick-start/resource-categories-and-access.md)。 ## 资源匹配规则 diff --git a/zh-cn/application-dev/quick-start/application-package-install-uninstall.md b/zh-cn/application-dev/quick-start/application-package-install-uninstall.md index 0ed3293da03..2b5d1d00421 100644 --- a/zh-cn/application-dev/quick-start/application-package-install-uninstall.md +++ b/zh-cn/application-dev/quick-start/application-package-install-uninstall.md @@ -19,7 +19,7 @@ ## 应用程序包的更新 -对于开发者，应用程序包的更新，首先需要更新[app.json5配置文件](./app-configuration-file.md#appjson5配置文件)中的versionCode版本号字段，通过DevEco Studio打包后在应用市场发布，发布流程与首次发布一致。对于终端设备用户，新版本发布后，可以通过以下两种方式更新应用程序包。 +对于开发者，应用程序包的更新，首先需要更新[app.json5配置文件](./app-configuration-file.md)中的versionCode版本号字段，通过DevEco Studio打包后在应用市场发布，发布流程与首次发布一致。对于终端设备用户，新版本发布后，可以通过以下两种方式更新应用程序包。 - 应用市场内更新：应用市场通知用户该应用有新版本，用户根据通知到应用市场（客户端）进行升级。 - 应用内检测升级：开发者根据[更新指导](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-update#section316371715233)实现版本更新提醒功能，应用启动完成或用户在应用中主动检查新版本时，会弹出升级对话框，用户根据对话框提示升级。 diff --git a/zh-cn/application-dev/task-management/native-transient-task.md b/zh-cn/application-dev/task-management/native-transient-task.md index 501d0af63d9..e48b1e91218 100644 --- a/zh-cn/application-dev/task-management/native-transient-task.md +++ b/zh-cn/application-dev/task-management/native-transient-task.md @@ -6,7 +6,7 @@ ## 接口说明 -常用接口如下表所示，具体API说明详见[API参考](../reference/apis-backgroundtasks-kit/_transient_task.md#transienttask)。 +常用接口如下表所示，具体API说明详见[API参考](../reference/apis-backgroundtasks-kit/_transient_task.md#函数)。 | 接口名 | 描述 | -- Gitee