harmonyos-best-practices-mcp 0.1.0

package/data/docs/bpta-decrease_pakage_size.md

@@ -0,0 +1,126 @@
+# 应用包体积优化
+
+> 来源: https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-decrease_pakage_size
+> 文档标识(fileName): bpta-decrease_pakage_size  
+> 目录(catalogName): best-practices  
+> 语言: cn  
+> 更新时间: 2026-06-23 03:39:39  
+> 导航地址: /hmos/hmos-dp1
+
+---
+#### 概述
+
+减小应用包大小可以提升应用下载和安装体验。压缩、精简或复用代码和资源可以有效降低应用包体积。在优化包大小前，先了解HarmonyOS应用的[Stage模型应用程序包结构](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/application-package-structure-stage)，对HAP、HAR、HSP等特点建立一定认知，然后使用扫描工具分析App包，根据报告优化应用。具体优化方法可以参考以下内容：
+
+1. 对于含有so库的App工程，可以配置so库压缩选项，以减小应用包大小。
+2. 在应用存在多包（HAP、HSP）的场景中，可以使用HSP动态共享包在多个包（HAP、HSP）之间共享代码和资源，消除使用HAR静态共享包导致的代码和资源重复拷贝，从而减小应用包大小，同时开发者需要综合评估对编译性能的影响：大量使用HSP替代HAR，会在编译引用这些HSP共享包的模块时触发更多的语言编译任务，导致编译耗时、编译内存占用增加。
+3. 使用ohpm的[override](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-oh-package-json5#zh-cn_topic_0000001792256137_overrides)机制或开启 `[resolve_conflict](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpmrc#section368717475562)` 解决依赖冲突，减少依赖包导致的重复编译问题。
+4. 将不常用的功能作为按需加载的模块。
+
+#### 使用扫描工具分析App大小问题
+
+[扫描工具](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/app-check-tool)可用于分析检测应用包，根据不同的参数设定，扫描指定路径的App、HAP、HSP包内容并输出检测结果报告，为开发者优化包结构或排查问题提供数据支撑。
+
+根据扫描结果优化应用：
+
+1. 重复文件
+
+- 删除同一包内的重复资源。多包（HAP、HSP）间重复资源，可以使用HSP实现资源的复用，参考[多包情况下使用HSP共享代码及资源](#section13745162092020)。
+
+2. 较大文件
+
+- 确认应用是否必需，是否可以删除。
+- JPG、PNG、GIF等文件，可以考虑压缩图片。
+
+3. 特定类型的文件
+
+so文件，通过[配置so库压缩选项](#section15826132851819)来实现压缩打包。
+
+#### 减小应用包大小的方法
+
+## 配置so库压缩选项
+
+DevEco Studio 默认在打包应用时不压缩 so 库文件。配置 so 压缩选项后，DevEco Studio 将 so 库文件压缩并打包到应用中，从而减小应用包的大小。
+
+**配置方法**
+
+修改应用模块配置文件module.json5中的compressNativeLibs字段，将值配置为true，重新编译、打包应用。
+
+```
+{
+  "module": { 
+    // ...
+    "compressNativeLibs": true // Identify whether the so library is packaged in compressed storage. ’true’ means compressed so library, ’false’ means non-compressed.
+  }
+}
+```
+
+**so压缩效果**
+
+以DevEco Studio中的C++默认库文件为例，展示压缩前后的文件大小对比：
+
+| 文件名 | 原始大小 | 压缩后大小 | 压缩率 |
+| --- | --- | --- | --- |
+| armeabi-v7a/libc++_shared.so | 1108k | 386k | 34% |
+
+## 解决依赖减少依赖包重复编译
+
+对于ohpm 1.5.0之前的版本，如果hap依赖了不同版本的har（例如下图中的V1版本的harC和V2版本的harC），默认情况下，V1和V2两个版本的harC都会被打包到hap中。开发者可以使用ohpm的[override](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-oh-package-json5#zh-cn_topic_0000001792256137_overrides)机制，指定只打包一个版本。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/05/v3/PUAQnFfBTMeS5WDnZPVPng/zh-cn_image_0000002194011048.png?HW-CC-KV=V1&HW-CC-Date=20260623T075647Z&HW-CC-Expire=86400&HW-CC-Sign=45E51BE66910019B146470D700A2C2A17534772EC3D0F69C3F95A305562B69D6 "点击放大")
+
+如果使用的是ohpm 1.4.0 版本，可以使用override机制，开发者可以在项目级别的 oh-package.json5 （即项目根目录下的 oh-package.json5）文件中添加 overrides 配置，将依赖树中的依赖替换为另一个版本。替换的版本既可以是一个具体的版本号，也可以是本地存在的HAR包或源码目录。
+
+**注意：**
+
+必须在项目级别的 oh-package.json5 中配置 overrides，配置在模块级别的 oh-package.json5 中不会生效。
+
+例如， 这里以 'foo' 库为例，如果在项目中始终需要使用'1.0.0'版本，可在项目级的 oh-package.json5 中添加以下配置：
+
+```
+{
+  "overrides": {
+    "foo": "1.0.0"
+  }
+}
+```
+
+若本地存在 foo 的源码或 HAR 包，确保 foo 始终使用本地版本，可在项目级 oh-package.json5 中进行如下配置：
+
+1、本地存在"foo"的源码，即配置项目根目录下的foo目录，以"file:./foo"标识其路径。
+
+```
+{
+  "overrides": {
+    "foo": "file:./foo" 
+  }
+}
+```
+
+2、本地存在"foo.har"的HAR包，其存放在libs目录下，即配置"file:./libs/foo.har"。
+
+```
+{
+  "overrides": {   
+    "foo": "file:./libs/foo.har"
+  }
+}
+```
+
+对于1.5.0版本之后的ohpm，可以通过开启`[resolve_conflict](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/ide-ohpmrc#section368717475562)`，自动解决依赖冲突。依赖冲突的处理策略为：当项目同时依赖某个三方库的不同版本时，ohpm会选择其中的最高版本进行安装。
+
+## 按需分发
+
+对于应用中用户不常用的功能，可以考虑通过[产品特性按需分发](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/store-moduleinstall)的方式，将下载时机交由用户选择，使用时从应用市场获取安装，减少用户初次下载的包大小。
+
+## 多包场景下使用HSP共享代码和资源
+
+当前系统提供了两种共享包：HAR静态共享包和HSP动态共享包。HAR和HSP都用于实现代码和资源的共享，可以包含代码、C++库、资源和配置文件。HAR中的代码和资源跟随使用方编译，如果有多个使用方，编译产物中会存在多份相同拷贝。HSP中的代码和资源可以独立编译，在运行时进程中只存在一份。
+
+在多包场景下，如果应用的多个HAP或HSP包使用HAR包实现代码和资源的共享，打包后的每个HAP或HSP包中都会包含共享HAR包的拷贝，导致App包中存在冗余代码和资源。如下图示例，应用模块HAP1和HAP2/HSP1都引用了HAR2和HAR3，打包后，App包中HAR2和HAR3有多份重复拷贝，体积较大。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/56/v3/hRQpNPIiQ_-mofmn3CINwg/zh-cn_image_0000002229451341.png?HW-CC-KV=V1&HW-CC-Date=20260623T075647Z&HW-CC-Expire=86400&HW-CC-Sign=6638C236B857887E0F32188FEE32A4158CDE9B1C5DD6A3A47F86C70AE47027BE "点击放大")
+
+推荐使用HSP代替HAR实现代码和资源共享。如下图示例，使用HSP2对原应用进行升级改造，打包后，APP包中HAR2和HAR3仅保留一份拷贝。当HAR2和HAR3的总大小超过HSP时，可以减小应用包大小。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4c/v3/EYUA0Z7HSIiW4BxKr-EGhw/zh-cn_image_0000002229336845.png?HW-CC-KV=V1&HW-CC-Date=20260623T075647Z&HW-CC-Expire=86400&HW-CC-Sign=BF11EBA3E843E6ACED84906E19C204525F99B199A51C3E92D7AA80402521F429 "点击放大")

package/data/docs/bpta-delayed-trigger-operation.md

@@ -0,0 +1,215 @@
+# 操作延时触发
+
+> 来源: https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-delayed-trigger-operation
+> 文档标识(fileName): bpta-delayed-trigger-operation  
+> 目录(catalogName): best-practices  
+> 语言: cn  
+> 更新时间: 2026-06-23 03:39:36  
+> 导航地址: /hmos/hmos-dp1
+
+---
+#### **延迟加载Lazy-Import与动态加载await import**
+
+随着业务规模不断扩大，很多应用在冷启动时会静态import大量模块，这种静态import会在应用初始化阶段同步加载所有依赖模块，导致冷启动耗时增加。ArkTS 提供了[Lazy-Import](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-lazy-import-V5)能力和[动态加载](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-dynamic-import)（动态import）能力，使模块可在真正需要时再加载，从而提升应用启动速度，并有效降低资源消耗。
+
+- 动态加载（动态import）是一种异步模块加载机制，允许应用程序在运行时按照实际需求去加载相关模块。例如在用户交互等条件触发时，再动态加载特定模块，可以减少初始化import的加载时间和资源消耗，这将有助于提高应用程序的内存性能和响应速度。
+- 延迟加载（Lazy-Import）是一种延缓模块加载的机制，可以使待加载文件在冷启动阶段不被加载，而在后续导出变量被真正使用时再同步加载执行文件，从而节省资源以提高应用冷启动性能。具体案例与实验数据请参阅[延迟加载Lazy-Import使用指导](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-arkts-high-performance#section12861143418213)。
+
+两种延时加载方案的区别。具体请参阅[Lazy-Import与动态加载的区别](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-lazy-import#lazy-import与动态加载的区别)。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/e4/v3/aZm0waSbSdq1qEwhWQQBiw/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260623T075642Z&HW-CC-Expire=86400&HW-CC-Sign=AB52FCCC2EAFF8EED3C70AFD05D9D41242A0EB0B6C7BC602F23CD2B7C21D57FC) 
+
+延迟加载（lazy-Import）会改变模块执行顺序，可能导致预期的全局变量未定义。具体场景请参阅[Lazy-Import加载副作用](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V5/arkts-module-side-effects-V5#延迟加载lazy-import改变模块执行顺序可能导致预期的全局变量未定义)。
+
+## 延迟加载Lazy-Import
+
+**模块导入延迟到业务附近**
+
+一些应用在冷启动阶段会加载过多未使用模块，针对这种情况导致的启动缓慢问题，开发者可以对冷启动阶段未使用的模块进行 Lazy-Import 改造，使模块导入延迟到对应业务附近加载，从而有效缩短冷启动时间，最终提升用户的启动体验。案例可参考[模块导入延迟到业务附近](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/arkts-lazy-import#使用示例)。
+
+**延迟加载非关键路径模块**
+
+下面示例中，所有变量均从DeviceInfo模块中导出。除了冷启动用到的name模块，一些非关键路径模块（如screen和storage）也一起被导出。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/a9/v3/xW6tV1ShRs-OGpJ18yhtUQ/zh-cn_image_0000002533090658.png?HW-CC-KV=V1&HW-CC-Date=20260623T075642Z&HW-CC-Expire=86400&HW-CC-Sign=AF22B713A841526507821C793917AAD7B200B592EE3E7127F557CA44F7F0DA30 "点击放大")
+
+```
+// entry\src\main\ets\pages\Index.ets
+// Before optimization: All variables are exported from the user info
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { name, screen, storage } from './DeviceInfo';
+
+@Entry
+@Component
+struct Index {
+  build() {
+    RelativeContainer() {
+      Text(name)
+        .id('HelloWorld')
+        .fontSize($r('app.float.page_text_font_size'))
+        .fontWeight(FontWeight.Bold)
+        .alignRules({
+          center: { anchor: '__container__', align: VerticalAlign.Center },
+          middle: { anchor: '__container__', align: HorizontalAlign.Center }
+        })
+        .onClick(() => {
+          hilog.info(0x0000, 'testTag', 'screen: %{public}s', screen);
+          hilog.info(0x0000, 'testTag', 'storage: %{public}s', storage);
+        })
+    }
+    .height('100%')
+    .width('100%')
+  }
+}
+```
+
+```
+// entry\src\main\ets\pages\DeviceInfo.ets
+import { hilog } from '@kit.PerformanceAnalysisKit';
+
+const name = 'Mate 70';
+hilog.info(0x0000, 'testTag', 'export %{public}s', name);
+const screen = 'OLED';
+hilog.info(0x0000, 'testTag', 'export %{public}s', screen);
+const storage = '512GB';
+hilog.info(0x0000, 'testTag', 'export %{public}s', storage);
+
+export { name, screen, storage };
+```
+
+使用体检工具[体检工具](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-application-cold-start-optimization#section16955857103112)可以查看冷启动阶段未使用的模块和这些模块的加载耗时。将这些未使用模块（storage和screen）从关键路径中剥离，添加lazy标识进行延迟加载。修改后，从下图Trace中可以观察到冷启动阶段仅加载了DeviceName模块。OtherDeviceInfo模块被推迟到用户首次点击文本时才会执行。从修改前后的Trace可以看出，冷启动耗时有所降低。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/74/v3/Ylb3FKMLSK6nCQBFy6olwg/zh-cn_image_0000002563810679.png?HW-CC-KV=V1&HW-CC-Date=20260623T075642Z&HW-CC-Expire=86400&HW-CC-Sign=47A76A3F830DB3BCEE0265FC9207A08B36BB73F0796E7DF29D5F62AC69FDC176 "点击放大")
+
+```
+// entry\src\main\ets\pages\Index.ets
+// After optimization: split variables are exported from different modules
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { name } from './DeviceName';
+import lazy { screen, storage } from './OtherDeviceInfo';
+
+@Entry
+@Component
+struct Index {
+  build() {
+    RelativeContainer() {
+      Text(name)
+        .id('HelloWorld')
+        .fontSize($r('app.float.page_text_font_size'))
+        .fontWeight(FontWeight.Bold)
+        .alignRules({
+          center: { anchor: '__container__', align: VerticalAlign.Center },
+          middle: { anchor: '__container__', align: HorizontalAlign.Center }
+        })
+        .onClick(() => {
+          hilog.info(0x0000, 'testTag', 'screen: %{public}s', screen);
+          hilog.info(0x0000, 'testTag', 'storage: %{public}s', storage);
+        })
+    }
+    .height('100%')
+    .width('100%')
+  }
+}
+```
+
+```
+// entry\src\main\ets\pages\DeviceName.ets
+import { hilog } from '@kit.PerformanceAnalysisKit';
+
+const name = 'Mate 70';
+hilog.info(0x0000, 'testTag', 'export %{public}s', name);
+
+export { name };
+```
+
+```
+// entry\src\main\ets\pages\OtherDeviceInfo.ets
+import { hilog } from '@kit.PerformanceAnalysisKit';
+
+const screen = 'OLED';
+hilog.info(0x0000, 'testTag', 'export %{public}s', screen);
+const storage = '512GB';
+hilog.info(0x0000, 'testTag', 'export %{public}s', storage);
+
+export { screen, storage };
+```
+
+## 动态加载await import
+
+**动态加载冷启动未用到的so**
+
+下面示例在应用启动时，界面仅需显示基础文本信息，但可以从下图的Trace中看到一个本地so库（libentry.so）被同步导入。该SO库包含数学运算功能，在用户点击界面之前不需要加载和初始化。
+
+```
+// entry\src\main\ets\pages\Index.ets
+// Before optimization: statically import the so that is not used in cold start
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import testNapi from 'libentry.so';
+import { title } from './name';
+
+@Entry
+@Component
+struct Index {
+  build() {
+    Row() {
+      Column() {
+        Text(title)
+          .fontSize($r('app.float.page_text_font_size'))
+          .fontWeight(FontWeight.Bold)
+          .onClick(() => {
+            hilog.info(0x0000, 'testTag', 'Test NAPI 2 + 3 = %{public}d', testNapi.add(2, 3));
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+```
+// entry\src\main\ets\pages\name.ets
+export const title = 'HarmonyOS';
+```
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/6a/v3/JAyaK1ITTJu1BqVVFdu9ZQ/zh-cn_image_0000002547097925.png?HW-CC-KV=V1&HW-CC-Date=20260623T075642Z&HW-CC-Expire=86400&HW-CC-Sign=B51C3D3C8B25E4FED6C006BA8D3BFDBA1B62103C1F9281D198E0E165CFABDCB8 "点击放大")
+
+使用[体检工具](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-application-cold-start-optimization#section16955857103112)记录冷启动Trace，识别启动阶段未使用的模块及其加载耗时。在该示例中，不需要在用户点击事件前加载[libentry.so](https://libentry.so/)模块，建议删除import testNapi from 'libentry.so'语句，仅在需要使用时通过import()函数动态加载该模块。下图为修改后采集的冷启动Trace，从图中可以看到冷启动阶段不再加载libentry.so。从修改前后的Trace可以看出降低了冷启动的耗时。
+
+```
+// entry\src\main\ets\pages\Index.ets
+import { hilog } from '@kit.PerformanceAnalysisKit';
+import { title } from './name';
+
+@Entry
+@Component
+struct Index {
+  build() {
+    Row() {
+      Column() {
+        Text(title)
+          .fontSize($r('app.float.page_text_font_size'))
+          .fontWeight(FontWeight.Bold)
+          .onClick(async () => {
+            // After optimization: The SO file is dynamically loaded at the point of use.
+            let ns: ESObject | null = null;
+            try {
+              ns = await import('libentry.so');
+              hilog.info(0x0000, 'testTag', 'Test NAPI 2 + 3 = %{public}d', ns.default.add(2, 3));
+            } catch (error) {
+              hilog.error(0x0000, 'testTag', `Load so failed, code is ${error.code}, message is ${error.message}`);
+            }
+          })
+      }
+      .width('100%')
+    }
+    .height('100%')
+  }
+}
+```
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/41/v3/FxDUl66UQbeEwYgH-FD9NA/zh-cn_image_0000002515418092.png?HW-CC-KV=V1&HW-CC-Date=20260623T075642Z&HW-CC-Expire=86400&HW-CC-Sign=45183690B5293606CE7A76CF5257856229E3967B1D2D5DE56314D940F85679B5 "点击放大")
+
+#### **延迟执行资源释放操作**
+
+将资源关闭和释放操作放在[setTimeout](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-timer#settimeout)函数中执行，使其延迟到系统相对空闲的时刻进行，可以避免在程序忙碌时段占用关键资源，提升整体性能及响应能力。例如相机正常使用后，[延迟执行释放相机资源](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-application-latency-optimization-cases#section8783201923819)的相关操作。

package/data/docs/bpta-desktop-shortcuts.md

@@ -0,0 +1,180 @@
+# 桌面快捷方式
+
+> 来源: https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-desktop-shortcuts
+> 文档标识(fileName): bpta-desktop-shortcuts  
+> 目录(catalogName): best-practices  
+> 语言: cn  
+> 更新时间: 2026-06-23 03:34:36  
+> 导航地址: /hmos/hmos-dp1
+
+---
+#### 概述
+
+随着应用的功能越来越复杂，用户在使用应用时，找到某个功能的操作步骤也在变得更加繁琐。为了提升用户体验，可以对应用中常用的功能创建对应的桌面快捷方式，以达到快速启动应用、一键直达特定功能等目的。例如相机应用的 “快速拍照”、便签应用的 “新建便签” 和地图应用的“常用地点导航”等功能的快捷方式，用户通过快捷方式可以快速进入特定功能页面，既能大大提高操作效率，同时也增加了用户对应用的依赖性。使用快捷方式，还可以实现个性化定制的需求，创建多个快捷方式，以满足个性化的工作流程和操作偏好。
+
+#### 场景介绍
+
+以导航场景为例，当用户使用地图应用导航时，通常是先搜索目的地，然后开始导航。为了提升导航效率和提高操作便捷性，可以给该地图应用添加常去地点的导航快捷方式，如去公司、回家等。添加常去地点（例如公司、家等）的快捷方式后，用户即可通过长按应用图标，打开快捷方式入口，快速开启导航。
+
+快捷方式创建成功后支持以下启动方式：
+
+- 点击快捷方式入口列表中的“回家”项，即可快速打开地图应用，开启从当前位置到家的导航路线选择。
+
+  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/32/v3/saNBRsABRMa3ppL_0z2dew/zh-cn_image_0000002229451729.gif?HW-CC-KV=V1&HW-CC-Date=20260623T075536Z&HW-CC-Expire=86400&HW-CC-Sign=2F3F464FE58A29A6B252A1653AFA2084A320ACB6BA6A1D2CB03B04133F157EF4 "点击放大")
+- 长按快捷方式入口列表中的“回家”项，可将其拖动至桌面，点击桌面对应图标，即可开启从当前位置到家的导航路线选择。
+
+  ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/22/v3/OI9Kds1cQ8ic9P2i3g9I5w/zh-cn_image_0000002229451733.gif?HW-CC-KV=V1&HW-CC-Date=20260623T075536Z&HW-CC-Expire=86400&HW-CC-Sign=5E9EFBCB565BA25A8FEF55008E94ACB7D95CCF1F9136ECFBE33F480AD0F43D0E "点击放大")
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/37/v3/szTffEpdQWyB837lKUoS9w/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260623T075536Z&HW-CC-Expire=86400&HW-CC-Sign=C6BABA5048873BF23153DB7D0952E9DAD93759F1CA8486FF08AA7391CA12171C) 
+
+本文以单[HAP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hap-package)包为场景，讲述了快捷方式的实现步骤。多[HAP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hap-package)包的场景下， 步骤与单[HAP](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/hap-package)包一致，都是在entry文件夹下进行shortcuts_config.json的创建和module.json5的配置。
+
+#### 实现原理
+
+## 关键技术
+
+使用[shortcuts](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#shortcuts标签)来配置应用的快捷方式，其配置值为数组，包含四个子标签shortcutId、label、icon、wants。
+
+- shortcutId：标识快捷方式的ID，取值为长度不超过63字节的字符串。
+- label：标识快捷方式的标签信息，即快捷方式对外显示的文字描述信息。取值为长度不超过255字节的字符串，可以是描述性内容，也可以是标识label的资源索引。
+- icon：标识快捷方式的图标，取值为资源文件的索引。
+- [wants](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#wants标签)：标识快捷方式内定义的目标[wants](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#wants标签)信息集合，[wants](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#wants标签)中可配置如下参数：
+
+  | 属性名称 | 含义 |
+  | --- | --- |
+  | bundleName | 表示快捷方式的目标包名。 |
+  | moduleName | 表示快捷方式的目标模块名。 |
+  | abilityName | 表示快捷方式的目标组件名。 |
+  | parameters | 表示拉起快捷方式时的自定义数据，仅支持配置字符串类型的数据。其中键值均最大支持1024长度的字符串。 |
+
+[shortcuts](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#shortcuts标签)配置完成后，还需要在[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)中配置[metadata](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#metadata标签)字段来指定应用的快捷方式配置文件，从而完成快捷方式的基本配置。
+
+![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dc/v3/rHIiX0CaQt-9AYoF3o_GYg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260623T075536Z&HW-CC-Expire=86400&HW-CC-Sign=FC2888ED9B124792602F1B5A572DB8F07ED6BFBE0CE74F3FD48A09B45A8A5D48) 
+
+通过在[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)中配置[metadata](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#metadata标签)字段的快捷方式是一种在系统中创建的可以快速访问应用程序或特定功能的链接，与[卡片](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/formkit-overview)的区别在于：快捷方式只允许跳转至某个具体的UIAbility，无法直接跳转至非入口页面。
+
+## 实现流程
+
+给地图应用添加常用地点的导航快捷方式需要进行如下步骤：
+
+1. 创建页面并配置页面的路由信息。首先需要创建对应的快捷方式页面，且页面组件需要用@Entry装饰。然后在resources/base/profile下的main_pages.json文件中添加对应快捷方式页面的路由信息。
+
+   ```
+   {
+     "src": [
+       "pages/Index",
+       "pages/GoHouse",
+       "pages/GoCompany"
+     ]
+   }
+   ```
+2. 在/resources/base/profile/目录下创建名为shortcuts_config.json的文件，并在文件中定义应用快捷方式的相关配置。其中shortcutId表示快捷方式的ID、label表示快捷方式对外显示的文字描述信息、icon表示快捷方式的图标、[wants](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#wants标签)中则是快捷方式内定义的目标wants信息集合。通过wants中的parameters参数来指定拉起快捷方式时的自定义数据。
+
+   ```
+   {
+     "shortcuts": [
+       {
+         "shortcutId": "id_company",
+         "label": "$string:Go_to_the_Company",
+         "icon": "$media:company",
+         "wants": [
+           {
+             "bundleName": "com.example.desktopshortcuts",
+             "moduleName": "entry",
+             "abilityName": "EntryAbility",
+             "parameters": {
+               "shortCutKey": "CompanyPage"
+             }
+           }
+         ]
+       },
+       {
+         "shortcutId": "id_house",
+         "label": "$string:Go_to_House",
+         "icon": "$media:house",
+         "wants": [
+           {
+             "bundleName": "com.example.desktopshortcuts",
+             "moduleName": "entry",
+             "abilityName": "EntryAbility",
+             "parameters": {
+               "shortCutKey": "HousePage"
+             }
+           }
+         ]
+       }
+     ]
+   }
+   ```
+3. 在[module.json5配置文件](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file)中的[abilities](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#abilities标签)标签下的[metadata](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/module-configuration-file#metadata标签)中设置resource属性值为$profile:shortcuts_config，指定应用的快捷方式配置文件，即使用shortcuts_config.json文件中的shortcuts配置。
+
+   ```
+   {
+     "module": {
+       // ...
+       "abilities": [
+         {
+           "name": "EntryAbility",
+           "srcEntry": "./ets/entryability/EntryAbility.ets",
+           // ...
+           "skills": [
+             {
+               "entities": [
+                 "entity.system.home"
+               ],
+               "actions": [
+                 "ohos.want.action.home"
+               ]
+             }
+           ],
+           "metadata": [
+             {
+               "name": "ohos.ability.shortcuts",
+               "resource": "$profile:shortcuts_config"
+             }
+           ]
+         }
+       ],
+       // ...
+     }
+   }
+   ```
+4. 定义跳转到指定页面的方法。在步骤2中，通过parameters参数来指定了拉起快捷方式时的自定义数据 ，如"shortCutKey": "HousePage"。此时，可以通过获取want中的parameters里的shortCutKey来判断用户使用了哪种快捷方式，从而进行对应的页面跳转。如用户使用了“回家”的快捷方式进行导航，则获取到的shortCutKey的值为HousePage。
+
+   ```
+   export function goToSpecifyPage(context: UIContext, want?: Want) {
+     let shortCutKey = want?.parameters?.shortCutKey;
+
+     if (shortCutKey && shortCutKey === 'CompanyPage') {
+       context.getRouter().pushUrl({
+         url: 'pages/GoCompany'
+       }).catch((err: BusinessError) => {
+         hilog.error(0x0000, 'testTag', `Failed to push url. Code is ${err.code}, message is ${err.message}`);
+       });
+     }
+     if (shortCutKey && shortCutKey === 'HousePage') {
+       context.getRouter().pushUrl({
+         url: 'pages/GoHouse'
+       }).catch((err: BusinessError) => {
+         hilog.error(0x0000, 'testTag', `Failed to push url. Code is ${err.code}, message is ${err.message}`);
+       });
+     }
+   }
+   ```
+5. 最后，需要在Index.ets文件中定义newWantChange()方法，并在该方法中调用步骤4的goToSpecifyPage()方法，并将want作为参数传入。其中，want需要在EntryAbility.ets文件中的[onNewWant()](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-app-ability-uiability#onnewwant)方法中通过AppStorage存入，然后在newWantChange()方法中获取。
+
+   ```
+   newWantChange(): void {
+     if (this.isNewWant && AppStorage.has('want')) {
+       let want: Want | undefined = AppStorage.get('want');
+       if (want?.parameters?.shortCutKey) {
+         this.isNewWant = false;
+         goToSpecifyPage(this.getUIContext(), want);
+       }
+     }
+   }
+   ```
+
+#### 示例代码
+
+- [通过module.json5文件配置应用快捷打开方式入口](https://gitcode.com/harmonyos_samples/DesktopShortcut)

package/data/docs/bpta-detection.md

@@ -0,0 +1,12 @@
+# 性能检测
+
+> 来源: https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-detection
+> 文档标识(fileName): bpta-detection  
+> 目录(catalogName): best-practices  
+> 语言: cn  
+> 更新时间: 2026-06-23 03:39:23  
+> 导航地址: /hmos/hmos-dp1
+
+---
+- **[开发态性能检测](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-performance-detection)**
+- **[运行态性能检测](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-performance-runtime-detection)**

package/data/docs/bpta-developing-high-performance-ui.md

@@ -0,0 +1,19 @@
+# 界面渲染性能优化
+
+> 来源: https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-developing-high-performance-ui
+> 文档标识(fileName): bpta-developing-high-performance-ui  
+> 目录(catalogName): best-practices  
+> 语言: cn  
+> 更新时间: 2026-06-23 03:39:26  
+> 导航地址: /hmos/hmos-dp1
+
+---
+- **[组件嵌套优化](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-component-nesting-optimization)**
+- **[懒加载优化性能](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-lazyforeach-optimization)**
+- **[UI组件性能优化](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-ui-component-performance-optimization)**
+- **[主线程耗时操作优化](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-time-optimization-of-the-main-thread)**
+- **[高负载场景分帧渲染](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-dispose-highly-loaded-component-render)**
+- **[长列表加载丢帧优化](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-best-practices-long-list)**
+- **[瀑布流加载丢帧优化](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-waterflow-performance-optimization)**
+- **[Grid组件加载丢帧优化](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-improve_grid_performance)**
+- **[Swiper组件加载丢帧优化](https://developer.huawei.com/consumer/cn/doc/best-practices/bpta-swiper_high_performance_development_guide)**