From 18879b7432150beee6f0c84fd03f68b095e21680 Mon Sep 17 00:00:00 2001 From: liumingyue Date: Thu, 3 Jul 2025 15:00:32 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=E4=BA=91=E5=90=8C=E6=AD=A5?= =?UTF-8?q?=E6=9C=8D=E5=8A=A1=E5=90=AF=E7=94=A8=E6=A0=87=E8=AF=86?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: liumingyue --- zh-cn/application-dev/quick-start/app-configuration-file.md | 2 ++ .../apis-ability-kit/js-apis-bundleManager-applicationInfo.md | 1 + .../reference/apis-ability-kit/js-apis-bundleManager-sys.md | 1 + 3 files changed, 4 insertions(+) diff --git a/zh-cn/application-dev/quick-start/app-configuration-file.md b/zh-cn/application-dev/quick-start/app-configuration-file.md index c11e719eb78..9b197f74795 100644 --- a/zh-cn/application-dev/quick-start/app-configuration-file.md +++ b/zh-cn/application-dev/quick-start/app-configuration-file.md @@ -38,6 +38,7 @@ "hwasanEnabled": false, "ubsanEnabled": false, "cloudFileSyncEnabled": false, + "cloudStructuredDataSyncEnabled": false, "configuration": "$profile:configuration", "assetAccessGroups": [ "com.ohos.photos", @@ -88,6 +89,7 @@ app.json5配置文件包含以下标签。 | hwasanEnabled | 标识应用程序是否开启[HWAsan检测](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-hwasan)。HWAsan(HardWare-assisted AddressSanitizer)是利用Top-Byte-Ignore特性实现的增强版Asan，与Asan相比HWAsan的内存开销更低，检测到的内存错误范围更大。
- true：当前工程开启HWAsan检测。
- false：当前工程不开启HWAsan检测。
**说明：**
从API version 14开始，支持该字段。 | 布尔值 | 该标签可缺省，缺省值为false。 | | ubsanEnabled | 标识应用程序是否开启UBsan检测。
UBsan(Undefined Behavior Sanitizer)是一个用于运行时检测程序中未定义行为的工具，旨在帮助开发人员发现代码中潜在的错误和漏洞。
- true：当前工程开启UBsan检测。
- false：当前工程不开启UBsan检测。
**说明：**
从API version 14开始，支持该字段。 | 布尔值 | 该标签可缺省，缺省值为false。 | | cloudFileSyncEnabled | 标识当前应用是否启用端云文件同步能力。
- true：当前应用启用端云文件同步能力。
- false：当前应用不启用端云文件同步能力。 | 布尔值 | 该标签可缺省，缺省值为false。 | +| cloudStructuredDataSyncEnabled | 标识当前应用是否启用端云结构化数据同步能力。
- true：当前应用启用端云结构化数据同步能力。
- false：当前应用不启用端云结构化数据同步能力。
**说明：**
从API version 20开始，支持该字段。 | 布尔值 | 该标签可缺省，缺省值为false。 | | [configuration](#configuration标签) | 标识当前应用字体大小跟随系统配置的能力。
该标签是一个profile文件资源，用于指定描述应用字体大小跟随系统变更的配置文件。| 字符串 | 该标签可缺省，缺省时configuration使用不跟随系统默认设定。 | | assetAccessGroups | 配置应用的Group ID，它和Developer ID一起组成群组信息。
打包HAP时，DevEco使用开发者证书对群组信息签名，其中群组信息由Developer ID（由应用市场分配）+ Group ID（开发者配置）组成。
**说明：**
从API version 18开始，支持该字段。| 字符串数组 | 该标签可缺省，缺省值为空。 | | appPreloadPhase | 配置应用预加载到不同阶段。支持的取值如下：
-processCreated：预加载到进程创建完成阶段。
-abilityStageCreated：预加载到[AbilityStage](../reference/apis-ability-kit/js-apis-app-ability-abilityStage.md)创建完成阶段。
-windowStageCreated：预加载到[WindowStage](../reference/apis-arkui/arkts-apis-window-WindowStage.md#windowstage9)创建完成阶段。
**说明：**
从API version 20开始，支持该字段。
仅在[应用](../reference/apis-ability-kit/js-apis-bundleManager.md#bundletype)的entry模块配置有效。| 字符串| 该标签可缺省，缺省时不进行预加载。 | diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md index 547f84ef997..8feeac62ad8 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-applicationInfo.md @@ -48,6 +48,7 @@ import { bundleManager } from '@kit.AbilityKit'; | installSource12+ | string | 是 | 否 | 应用程序的安装来源，支持的取值如下：
- pre-installed表示应用为第一次开机时安装的预置应用。
- ota表示应用为系统升级时新增的预置应用。
- recovery表示卸载后再恢复的预置应用。
- bundleName表示应用由此包名对应的应用安装。
- unknown表示应用安装来源未知。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | releaseType12+ | string | 是 | 否 | 标识应用打包时使用的SDK的发布类型。当前SDK的发布类型可能为Canary、Beta、Release，其中Canary和Beta可能通过序号进一步细分，例如Canary1、Canary2、Beta1、Beta2等。开发者可通过对比应用打包依赖的SDK发布类型和OS的发布类型（[deviceInfo.distributionOSReleaseType](../apis-basic-services-kit/js-apis-device-info.md)）来判断兼容性。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | | cloudFileSyncEnabled12+ | boolean | 是 | 否 | 标识当前应用是否启用端云文件同步能力。true表示当前应用启用端云文件同步能力，false表示当前应用不启用端云文件同步能力。
**原子化服务API：** 从API version 12开始，该接口支持在原子化服务中使用。 | +| cloudStructuredDataSyncEnabled20+ | boolean | 是 | 是 | 标识当前应用是否启用端云结构化数据同步能力。true表示当前应用启用端云结构化数据同步能力，false表示当前应用不启用端云结构化数据同步能力。
**原子化服务API：** 从API version 20开始，该接口支持在原子化服务中使用。 | ## MultiAppMode12+ 表示[应用多开](../../quick-start/multiInstance.md)模式。 diff --git a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md index 25d810c16eb..d402d65f7d3 100644 --- a/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md +++ b/zh-cn/application-dev/reference/apis-ability-kit/js-apis-bundleManager-sys.md @@ -25,6 +25,7 @@ import { bundleManager } from '@kit.AbilityKit'; | GET_BUNDLE_INFO_ONLY_WITH_LAUNCHER_ABILITY12+ | 0x00001000 | 用于获取仅包含有桌面图标的应用的bundleInfo。它仅在[getAllBundleInfo](#bundlemanagergetallbundleinfo)接口中生效。
**系统API：** 该标记仅支持在系统API中使用。| | GET_BUNDLE_INFO_OF_ANY_USER12+ | 0x00002000 | 用于获取任意用户安装的bundleInfo。它不能单独使用，需要与GET_BUNDLE_INFO_WITH_APPLICATION一起使用。它仅在[getBundleInfo](#bundlemanagergetbundleinfo14)、[getAllBundleInfo](#bundlemanagergetallbundleinfo)接口生效。
**系统API：** 该标记仅支持在系统API中使用。 | | GET_BUNDLE_INFO_EXCLUDE_CLONE12+ | 0x00004000 | 用于获取去除分身应用而仅包含主应用的bundleInfo。它仅在[getAllBundleInfo](#bundlemanagergetallbundleinfo)接口中生效。
**系统API：** 该标记仅支持在系统API中使用。| +| GET_BUNDLE_INFO_WITH_CLOUD_KIT20+ | 0x00008000 | 用于获取启用端云文件同步能力或者端云结构化数据同步能力的应用的bundleInfo。它仅在[getAllBundleInfo](#bundlemanagergetallbundleinfo)接口中生效。
**系统API：** 该标记仅支持在系统API中使用。| ## ApplicationFlag -- Gitee