harmonyos-best-practices-mcp 0.1.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/README.md +103 -6
  2. package/data/INDEX.md +486 -0
  3. package/data/index_log.txt +452 -0
  4. package/data/synonyms.json +58 -0
  5. package/dist/data.js +164 -7
  6. package/dist/index.js +108 -41
  7. package/dist/search.js +183 -19
  8. package/package.json +2 -2
  9. /package/data/{index.md → code_list.md} +0 -0
package/README.md CHANGED
@@ -1,27 +1,97 @@
1
1
  # HarmonyOS 最佳实践 MCP 服务器
2
2
 
3
- 把鸿蒙应用开发最佳实践资料(452 篇文档 + 186 个示例仓库)通过 MCP 暴露为检索工具,供 Claude Code / Cursor / Cline 等 MCP 客户端在开发时动态调用。
3
+ 把鸿蒙应用开发最佳实践资料通过 MCP 暴露为检索工具,供 Claude Code / Cursor / Cline 等 MCP 客户端在开发时动态调用。
4
4
 
5
5
  **文档(9MB)随包发布,装包即用、零配置。** 代码(8GB)不随包,按需配置本地路径(见下)。
6
6
 
7
+ 与姊妹项目分工互补:
8
+
9
+ | | 本项目(best-practices) | guides | api-references | ui-design-guides |
10
+ |---|---|---|---|---|
11
+ | 查什么 | **场景最佳实践 + 参考代码** | **API 用法、调用流程** | **接口精确定义**(参数/枚举) | **设计怎么做**(视觉/交互/控件设计规范) |
12
+ | 数据 | 452 篇 + 186 代码仓库 | 5489 篇指南 | 4495 篇 API 参考 | 166 篇设计指南 |
13
+ | 适用 | "长列表丢帧优化""组件复用范例" | "AVPlayer 怎么初始化" | "AudioCapturer 方法签名" | "底部页签设计规范" |
14
+
15
+ 四者并列:best-practices 给场景实践与参考代码、guides 讲 API 用法、api-references 查精确签名、ui-design-guides 定设计规范。
16
+
7
17
  ## 提供的工具
8
18
 
9
19
  | 工具 | 作用 |
10
20
  |------|------|
11
21
  | `search_best_practices({query, limit?})` | 全文检索文档(中文友好),返回相关度排序的文档列表(含主题、是否有代码、代码仓库名) |
12
22
  | `get_doc({name})` | 读取指定文档(docId)的完整 Markdown 正文 |
13
- | `get_code_example({docName})` | 返回文档关联的参考代码:本地仓库绝对路径、远程 URL、入口 `.ets/.ts` 文件 |
23
+ | `get_code_example({docName})` | 返回文档关联的参考代码:本地仓库绝对路径、远程 URL、README 简介、入口 `.ets/.ts` 文件(带用途注释) |
14
24
  | `list_by_topic({topic?})` | 按大类浏览(稳定性/性能/媒体/功耗/一多…);省略参数返回所有大类及文档数 |
15
25
 
16
- ## 安装(最终用户)
26
+ ## 四者并列使用
27
+
28
+ ### OpenCode 示例
29
+
30
+ ```json
31
+ {
32
+ "mcp": {
33
+ "harmonyos-best-practices": {
34
+ "type": "local",
35
+ "command": ["npx", "-y", "harmonyos-best-practices-mcp"],
36
+ "environment": { "BP_CODE_DIR": "/abs/path/to/best_practices_code" }
37
+ },
38
+ "harmonyos-guides": {
39
+ "type": "local",
40
+ "command": ["npx", "-y", "harmonyos-guides-mcp"]
41
+ },
42
+ "harmonyos-api-references": {
43
+ "type": "local",
44
+ "command": ["npx", "-y", "harmonyos-api-references-mcp"]
45
+ },
46
+ "harmonyos-ui-design-guides": {
47
+ "type": "local",
48
+ "command": ["npx", "-y", "harmonyos-ui-design-guides-mcp"]
49
+ }
50
+ }
51
+ }
52
+ ```
53
+
54
+ ### Claude Code 示例
55
+
56
+ ```json
57
+ {
58
+ "mcpServers": {
59
+ "harmonyos-best-practices": {
60
+ "command": "npx",
61
+ "args": ["-y", "harmonyos-best-practices-mcp"],
62
+ "env": { "BP_CODE_DIR": "/abs/path/to/best_practices_code" }
63
+ },
64
+ "harmonyos-guides": {
65
+ "command": "npx",
66
+ "args": ["-y", "harmonyos-guides-mcp"]
67
+ },
68
+ "harmonyos-api-references": {
69
+ "command": "npx",
70
+ "args": ["-y", "harmonyos-api-references-mcp"]
71
+ },
72
+ "harmonyos-ui-design-guides": {
73
+ "command": "npx",
74
+ "args": ["-y", "harmonyos-ui-design-guides-mcp"]
75
+ }
76
+ }
77
+ }
78
+ ```
79
+
80
+ ### BP_CODE_DIR 设置
81
+
82
+ > **`BP_CODE_DIR`(仅 best-practices 可选)**:指向本地 `best_practices_code/` 目录(从 GitHub Release 下载 `harmonyos-best-practices-code.tar.gz` 解压得到)。配置后 `get_code_example` 会返回本地仓库路径与入口 `.ets` 文件,AI 可直接读取真实官方示例代码;**不配则只返回 gitcode 远程 URL**。Windows 路径用正斜杠更稳(如 `C:/path/to/best_practices_code`)。其余三个 MCP 是纯文档,无需此变量。
83
+
84
+ 搭配各自的 Skill(`harmonyos-best-practices` / `harmonyos-guides` / `harmonyos-api-references` / `harmonyos-ui-design-guides`),AI 可据需求选用:guides 查 API 用法、best-practices 查场景实践与参考代码、api-references 查精确签名、ui-design-guides 查设计规范。
85
+
86
+ ## 安装
17
87
 
18
88
  无需 clone 本仓库。直接用 npx 或全局安装:
19
89
 
20
90
  ```bash
21
- # 方式一:一次性运行(推荐)
22
- npx harmonyos-best-practices-mcp
91
+ # 方式一:一次性运行(推荐,每次自动拉最新版)
92
+ npx -y harmonyos-best-practices-mcp
23
93
 
24
- # 方式二:全局安装
94
+ # 方式二:全局安装(需手动更新)
25
95
  npm install -g harmonyos-best-practices-mcp
26
96
  ```
27
97
 
@@ -90,6 +160,33 @@ Claude Code 配置加 env:
90
160
  | `BP_INDEX` | 包内 `data/index.md` | 索引文件(一般无需改) |
91
161
  | `BP_CODE_DIR` | 空 | 本地代码根目录;为空时 `get_code_example` 只给 URL |
92
162
 
163
+ ## 更新
164
+
165
+ 文档和服务器会持续更新(版本号见 `package.json`)。
166
+
167
+ **更新服务器**:
168
+
169
+ ```bash
170
+ # npx -y 方式:无需手动操作,每次启动自动拉最新版
171
+ # 全局安装方式:手动更新
172
+ npm update -g harmonyos-best-practices-mcp
173
+ # 或锁定最新版
174
+ npm install -g harmonyos-best-practices-mcp@latest
175
+ ```
176
+
177
+ 更新后**重启 AI 客户端**(Claude Code / Cursor / Cline 等),让新进程加载新版 MCP。
178
+
179
+ **更新文档**:文档随包内置(`data/docs/`),更新 npm 包即同步更新 452 篇文档,无需单独操作。
180
+
181
+ **更新代码包**(仅当启用了本地代码读取):GitHub Release 有新版 `harmonyos-best-practices-code.tar.gz` 时,重新下载解压覆盖 `BP_CODE_DIR` 指向的目录即可。
182
+
183
+ **查看版本**:
184
+ ```bash
185
+ npm view harmonyos-best-practices-mcp version # 最新发布版
186
+ npm ls -g harmonyos-best-practices-mcp # 本地已装版本
187
+ ```
188
+ 或看客户端 MCP 面板里服务器的 `version` 字段。
189
+
93
190
  ## 开发与发布(维护者)
94
191
 
95
192
  ```bash
package/data/INDEX.md ADDED
@@ -0,0 +1,486 @@
1
+ # 鸿蒙最佳实践文档索引 (best-practices)
2
+
3
+ > 共 452 篇，目录 `best_practices_docs/`。文件名即文档 slug（docId）。
4
+ > 本索引由 `index_log.txt` 生成，仅供浏览；MCP 工具按 `大类 / 小标题` 分类。
5
+
6
+ - **稳定性** (76)
7
+ - `bpta-stability-overview.md` — 稳定性概览
8
+ - `bpta-stability-detection.md` — 稳定性检测
9
+ - `bpta-stability-develop-detection.md` — 开发态稳定性检测
10
+ - `bpta-stability-ram-detection.md` — 地址越界类问题检测
11
+ - `bpta-stability-address-sanitizer-overview.md` — 地址越界检测能力概述
12
+ - `bpta-stability-address-sanitizer-catagory.md` — 地址越界经典问题类型
13
+ - `bpta-stability-address-sanitizer-principle.md` — 地址越界检测工具原理
14
+ - `bpta-stability-asan-detection.md` — 使用ASan检测内存错误
15
+ - `bpta-stability-hwasan-detection.md` — 使用HWASan检测内存错误
16
+ - `bpta-stability-gwpasan-detection.md` — 使用GWP-ASan检测内存错误
17
+ - `bpta-stability-address-sanitizer-faq.md` — 适配常见问题
18
+ - `bpta-stability-thread-detection.md` — 线程并发类问题检测
19
+ - `bpta-stability-tsan-detection.md` — 使用TSan检测线程问题
20
+ - `bpta-stability-leak-detection.md` — 资源泄漏类问题检测
21
+ - `bpta-stability-memleak-detection-overview.md` — 内存泄漏类问题检测方法
22
+ - `bpta-stability-js-memleak-detection.md` — JS内存泄漏问题检测方法
23
+ - `bpta-stability-native-memleak-detection.md` — Native内存泄漏问题检测方法
24
+ - `bpta-js-leak-watcher.md` — JsLeakWatcher开发实践
25
+ - `bpta-malloc-dispatch-table.md` — 内存泄漏定制能力开放使用指导
26
+ - `bpta-stability-file-handle-detection.md` — 文件句柄泄漏类问题检测方法
27
+ - `bpta-stability-thread-leak-detection.md` — 线程泄漏类问题检测方法
28
+ - `bpta-stability-ark-detection.md` — 方舟类问题检测
29
+ - `bpta-stability-ark-runtime-detection.md` — 方舟运行时检测
30
+ - `bpta-stability-ark-exception-detection.md` — 使用方舟异常信息增强检测
31
+ - `bpta-stability-ubsan-detection.md` — 使用UBSan检测未定义行为
32
+ - `bpta-stability-app-analyzer.md` — 应用体检
33
+ - `bpta-stability-testing.md` — 稳定性测试
34
+ - `bpta-stability-deveco-testing.md` — 使用DevEco Testing进行稳定性测试
35
+ - `bpta-stability-runtime-detection.md` — 运行态稳定性检测
36
+ - `bpta-stability-runtime-address-sanitizer-detection.md` — 地址越界类问题检测方法
37
+ - `bpta-stability-runtime-leak-detection.md` — 资源泄漏类问题检测方法
38
+ - `bpta-stability-runtime-freeze-detection.md` — 应用冻屏类问题检测方法
39
+ - `bpta-stability-runtime-exception-exit-detection.md` — 应用异常退出类问题检测方法
40
+ - `bpta-stability-runtime-crash-detection.md` — 应用崩溃问题检测方法
41
+ - `bpta-stability-runtime-appkilled-detection.md` — 应用被查杀问题检测方法
42
+ - `bpta-stability-analysis.md` — 稳定性分析
43
+ - `bpta-stability-fault-log.md` — 稳定性故障类型及日志规格说明
44
+ - `bpta-stability-fault-type.md` — 故障类型
45
+ - `bpta-stability-log-specs.md` — 日志规格
46
+ - `bpta-stability-address-illegal-way.md` — 地址越界类问题分析方法
47
+ - `bpta-stability-leak-way.md` — 资源泄漏类问题分析方法
48
+ - `bpta-stability-app-freeze.md` — 应用冻屏类问题分析方法
49
+ - `bpta-stability-app-freeze-way.md` — 应用冻屏问题排查方法
50
+ - `bpta-stability-app-freeze-ark-runtime.md` — 栈顶在方舟运行时的应用冻屏问题定位实践
51
+ - `bpta-stability-app-crash.md` — 应用异常退出类问题分析方法
52
+ - `bpta-stability-app-crash-cpp-way.md` — CppCrash类问题分析方法
53
+ - `bpta-stability-app-crash-js-way.md` — JS Crash类问题分析方法
54
+ - `bpta-stability-app-killed-way.md` — 应用被查杀类问题分析方法
55
+ - `bpta-stability-opt.md` — 稳定性优化
56
+ - `bpta-stability-coding-standard.md` — 稳定性编码规范
57
+ - `bpta-stability-coding-standard-ndk-arkts.md` — NDK开发ArkTS侧编码规范
58
+ - `bpta-stability-coding-standard-node.md` — Node-API开发规范
59
+ - `bpta-stability-coding-standard-cpp.md` — C++编码规范
60
+ - `bpta-stability-coding-standard-libuv.md` — libuv使用规范及案例
61
+ - `bpta-stability-coding-standard-api.md` — 易错API的使用规范
62
+ - `bpta-stability-ide-static-detection.md` — 使用DevEco Studio静态检测编码规范
63
+ - `bpta-stability-log-standard.md` — 日志打印规范
64
+ - `bpta-stability-log-standard-hilog.md` — HiLog打印规范
65
+ - `bpta-stability-address-sanitizer-opt.md` — 地址越界类问题优化建议
66
+ - `bpta-stability-leak-opt.md` — 资源泄漏类问题优化建议
67
+ - `bpta-stability-app-freeze-opt.md` — 应用冻屏类问题优化建议
68
+ - `bpta-stability-exception-exit-opt.md` — 应用异常退出类问题优化建议
69
+ - `bpta-stability-cpp-crash-opt.md` — CppCrash类问题优化建议
70
+ - `bpta-stability-js-crash-opt.md` — JS Crash类问题优化建议
71
+ - `bpta-scenario-stability.md` — 稳定性案例
72
+ - `bpta-scenario-stability-address-sanitizer.md` — 地址越界类问题案例
73
+ - `bpta-scenario-stability-leak.md` — 资源泄漏类问题案例
74
+ - `bpta-scenario-stability-app-freeze.md` — 应用冻屏类问题案例
75
+ - `bpta-scenario-stability-exception-exit.md` — 应用异常退出类问题案例
76
+ - `bpta-scenario-stability-cppcrash.md` — CppCrash类问题案例
77
+ - `bpta-scenario-stability-jscrash.md` — JS Crash类问题案例
78
+ - `bpta-stability-operate.md` — 稳定性运维
79
+ - `bpta-stability-operate-apm.md` — APM能力建设
80
+ - `bpta-stability-operate-event.md` — 稳定性事件接入
81
+ - `bpta-stability-operate-app-event.md` — 应用事件
82
+ - `bpta-crash-monitor-practice.md` — 崩溃监测实践
83
+ - **性能** (64)
84
+ - `bpta-performance-guide-reading.md` — 性能概览
85
+ - `bpta-smooth-application-design.md` — 性能体验设计
86
+ - `bpta-detection.md` — 性能检测
87
+ - `bpta-performance-detection.md` — 开发态性能检测
88
+ - `bpta-performance-runtime-detection.md` — 运行态性能检测
89
+ - `bpta-performance-startup-time-detection.md` — 启动耗时类问题检测方法
90
+ - `bpta-performance-mainthread-consumption-detection.md` — 主线程超时类问题检测方法
91
+ - `bpta-performance-sliding-frame-drop-detection.md` — 滑动丢帧类问题检测方法
92
+ - `bpta-optimization-tool-practice.md` — 性能分析
93
+ - `bpta-optimization-overview.md` — 性能分析简介
94
+ - `bpta-click-to-click-response-optimization.md` — 点击响应时延分析
95
+ - `bpta-click-to-complete-delay-analysis.md` — 点击完成时延分析
96
+ - `bpta-zhenlv.md` — 帧率问题分析
97
+ - `bpta-web-click-response-delay-analysis.md` — Web点击响应时延分析
98
+ - `bpta-web-completion-delay-analysis.md` — Web加载完成时延分析
99
+ - `bpta-web-frame-rate-performance-analysis.md` — Web帧率问题分析
100
+ - `bpta-threads-serialization-timeout-analysis.md` — 跨线程序列化耗时问题分析
101
+ - `bpta-analyze-memory-problem.md` — 分析内存占用问题
102
+ - `bpta-memory-basic-knowledge.md` — 内存基础知识
103
+ - `bpta-retrieve-process-memory-info.md` — 获取进程内存信息
104
+ - `bpta-arkts-js-memory-analysis.md` — 分析ArkTS/JS内存
105
+ - `bpta-native-memory-analysis.md` — 分析native内存
106
+ - `bpta-kernel-memory-analysis.md` — 分析内核态内存
107
+ - `bpta-permission-timeout-analysis.md` — 分析任务执行超时问题
108
+ - `bpta-performance-optimization.md` — 性能优化
109
+ - `bpta-perceived-smoothness.md` — 感知流畅优化
110
+ - `bpta-control-rendering-range.md` — 渲染范围控制
111
+ - `bpta-reduce-layout-nodes.md` — 布局节点减少
112
+ - `bpta-pptimized-component-drawing.md` — 组件绘制优化
113
+ - `bpta-state-refresh.md` — 状态刷新控制
114
+ - `bpta-animation-frame.md` — 动画帧率优化
115
+ - `bpta-concurrency-capability.md` — 并发能力使用
116
+ - `bpta-preloading-resources.md` — 资源提前加载
117
+ - `bpta-improve-running-efficiency.md` — 运行效率提高
118
+ - `bpta-reduce-time-consuming.md` — 耗时操作减少
119
+ - `bpta-delayed-trigger-operation.md` — 操作延时触发
120
+ - `bpta-scenario-performance-optimization.md` — 性能场景优化案例
121
+ - `bpta-developing-high-performance-ui.md` — 界面渲染性能优化
122
+ - `bpta-component-nesting-optimization.md` — 组件嵌套优化
123
+ - `bpta-lazyforeach-optimization.md` — 懒加载优化性能
124
+ - `bpta-ui-component-performance-optimization.md` — UI组件性能优化
125
+ - `bpta-time-optimization-of-the-main-thread.md` — 主线程耗时操作优化
126
+ - `bpta-dispose-highly-loaded-component-render.md` — 高负载场景分帧渲染
127
+ - `bpta-best-practices-long-list.md` — 长列表加载丢帧优化
128
+ - `bpta-waterflow-performance-optimization.md` — 瀑布流加载丢帧优化
129
+ - `bpta-improve_grid_performance.md` — Grid组件加载丢帧优化
130
+ - `bpta-swiper_high_performance_development_guide.md` — Swiper组件加载丢帧优化
131
+ - `bpta-startup-response-optimization.md` — 应用启动与响应优化
132
+ - `bpta-application-cold-start-optimization.md` — 应用冷启动时延优化
133
+ - `bpta-application-latency-optimization-cases.md` — 应用时延优化
134
+ - `bpta-resource-and-storage-optimization.md` — 资源与存储优化
135
+ - `bpta-decrease_pakage_size.md` — 应用包体积优化
136
+ - `bpta-memory-optimization.md` — 应用内存占用优化
137
+ - `bpta-texture-compression-improve-performance.md` — 图片资源加载优化
138
+ - `bpta-file-upload-and-download-performance.md` — 文件上传下载优化
139
+ - `bpta-web-performance-optimization.md` — Web性能优化
140
+ - `bpta-web-develop-optimization.md` — Web加载性能优化
141
+ - `bpta-solutions-to-special-issues.md` — 专项问题解决方案
142
+ - `bpta-screen-flicker-solution.md` — 应用闪屏解决方案
143
+ - `bpta-image-white-lump-solution.md` — Image白块解决方案
144
+ - `bpta-object-serialization-performance.md` — 对象序列化性能优化
145
+ - `bpta-high-performance-json-parsing.md` — 高性能JSON解析
146
+ - `bpta-high-performance-protobuf-parsing.md` — 高性能Protobuf解析
147
+ - `bpta-concurrent-optimization.md` — 并行化性能优化
148
+ - **媒体** (49)
149
+ - `bpta-photo.md` — 相机
150
+ - `bpta-camera-shot2see.md` — 相机分段式拍照性能优化
151
+ - `bpta-deal-stride-solution.md` — 相机预览花屏解决方案
152
+ - `bpta-custom-camera-preview.md` — 自定义相机预览
153
+ - `bpta-custom-camera-photo.md` — 自定义相机拍照
154
+ - `bpta-custom-camera-video.md` — 自定义相机录像
155
+ - `bpta-picture.md` — 图片
156
+ - `bpta-image_get_and_save.md` — 图片获取与保存实践
157
+ - `bpta-long-snapshot-practice.md` — 长截图
158
+ - `bpta-audio-and-video.md` — 音频和视频
159
+ - `bpta-avplayer-video-practices.md` — 基于AVPlayer播放视频系列开发实践
160
+ - `bpta-avplayer-basic-control.md` — 基于AVPlayer基础播控实践
161
+ - `bpta-avplayer-long-video.md` — 基于AVPlayer播放长视频实践
162
+ - `bpta-avplayer-short-video.md` — 基于AVPlayer播放短视频实践
163
+ - `bpta-avplayer-embeded-short-video.md` — 基于AVPlayer播放嵌入式短视频实践
164
+ - `bpta-avplayer-embeded-network-video.md` — 基于AVPlayer播放网络视频实践
165
+ - `bpta-audio-playback-series.md` — 音频播放系列开发实践
166
+ - `bpta-general-comments.md` — 概述
167
+ - `bpta-playing-pcm-audio-based-audiorenderer.md` — 基于AudioRenderer播放PCM音频
168
+ - `bpta-playing-pcm-audio-based-ohaudio.md` — 基于OHAudio播放PCM音频
169
+ - `bpta-playing-formatted-audio-based-avplayer-arkts.md` — 基于AVPlayer播放格式化音频（ArkTS）
170
+ - `bpta-playing-formatted-audio-based-avplayer-cpp.md` — 基于AVPlayer播放格式化音频（C++）
171
+ - `bpta-playing-short-audio-based-soundpool.md` — 基于SoundPool播放短音频
172
+ - `bpta-audio-record.md` — 音频录制系列开发实践
173
+ - `bpta-audio-record-overview.md` — 概述
174
+ - `bpta-audio-record-base-on-audiocapturer.md` — 基于AudioCapturer录制PCM音频（ArkTS）
175
+ - `bpta-audio-record-base-on-ohaudio.md` — 基于OHAudio录制PCM音频（C++）
176
+ - `bpta-audio-record-base-on-avrecorder-arkts.md` — 基于AVRecorder录制格式化音频（ArkTS）
177
+ - `bpta-audio-record-base-on-avrecorder.md` — 基于AVRecorder录制格式化音频（C++）
178
+ - `bpta-audio-record-base-on-avscreencapture.md` — 基于AVScreenCapture录制音频
179
+ - `bpta-video-practices.md` — 基于Video播放视频系列开发实践
180
+ - `bpta-video-component-long-video.md` — 基于Video组件播放长视频
181
+ - `bpta-video-component-short-video.md` — 基于Video组件播放短视频
182
+ - `bpta-video-render.md` — 渲染视频画面
183
+ - `bpta-surface-encoder.md` — 基于Surface模式进行视频编码
184
+ - `bpta-buffer-mode-transcoding.md` — 基于Buffer模式进行视频转码
185
+ - `bpta-audio-focus-management.md` — 音频焦点管理解决方案
186
+ - `bpta-online-video-playback-lags-practice.md` — 在线视频播放卡顿优化
187
+ - `bpta-hdrvivid.md` — HDR Vivid视频播放与录制开发实践
188
+ - `bpta-hdrtosdr.md` — HDR Vivid视频转码SDR视频开发实践
189
+ - `bpta-video-thumbnail.md` — 基于系统能力获取视频缩略图
190
+ - `bpta-audio-video-synchronization.md` — 音画同步
191
+ - `bpta-avscreencapture-for-screen-recording.md` — 基于AVScreenCapture实现屏幕录制
192
+ - `bpta-sound-quality-switching.md` — 音质切换开发实践
193
+ - `bpta-image-to-video-synthesis.md` — 图片合成视频开发实践
194
+ - `bpta-audio-ripple-animation.md` — 基于AudioRenderer和AudioCapturer实现音频波形动画
195
+ - `bpta-audio-in-ear-monitor.md` — 基于Audio能力实现音频耳返
196
+ - `bpta-managing-audio-input-devices.md` — 管理音频输入设备开发实践
197
+ - `bpta-managing-audio-output-devices.md` — 管理音频输出设备开发实践
198
+ - **功耗** (47)
199
+ - `bpta-power_overview.md` — 功耗概览
200
+ - `bpta-power-consumption-experience.md` — 应用功耗体验
201
+ - `bpta-power-consumption-analysis.md` — 应用功耗检测
202
+ - `bpta-power-consumption-develop-analysis.md` — 开发态功耗检测
203
+ - `bpta-application-power-test.md` — 场景功耗测试
204
+ - `bpta-power-basic-quality-test.md` — 功耗基础质量测试
205
+ - `bpta-power-consumption-runtime-analysis.md` — 运行态功耗检测
206
+ - `bpta-application-power-analysis.md` — 应用功耗分析
207
+ - `bpta-high-cpu-load-analysis.md` — CPU 高负载分析
208
+ - `bpta-frontend-invisible-animation-analysis.md` — 前台不可见动效问题分析
209
+ - `bpta-ui-skip-analysis.md` — 应用UI进程空跑问题分析
210
+ - `bpta-hwc-self-rendering-layer-analysis.md` — 自渲染图层未使用硬件合成问题分析
211
+ - `bpta-background-sensors-baned-analysis.md` — 应用退后台禁止使用传感器问题分析
212
+ - `bpta-application-power-optimization.md` — 应用功耗优化
213
+ - `bpta-low-power-consumption-of-foreground-tasks.md` — 前台任务低功耗
214
+ - `bpta-low-power-design-in-dark-mode.md` — 省电和深色模式下低功耗设计
215
+ - `bpta-ltpo-description.md` — 基于LTPO的低功耗设计
216
+ - `bpta-utilize-hwc-efficiently.md` — 高效利用HWC的低功耗设计
217
+ - `bpta-properly-use-foreground-resources.md` — 前台资源合理使用
218
+ - `bpta-music-playback-scenarios.md` — 音乐播放场景低功耗规则
219
+ - `bpta-navigation-scenarios.md` — 导航定位场景低功耗规则
220
+ - `bpta-static-scenarios.md` — 静态场景低功耗规则
221
+ - `bpta-video-codec.md` — 视频场景编解码低功耗规则
222
+ - `bpta-video-barrage.md` — 视频场景弹幕绘制低功耗规则
223
+ - `bpta-video-rom.md` — 视频场景ROM低功耗建议
224
+ - `bpta-video-layer.md` — 视频场景图层低功耗建议
225
+ - `bpta-video-wifi.md` — 视频场景Wi-Fi加载低功耗建议
226
+ - `bpta-network-resources.md` — 网络资源低功耗建议
227
+ - `low-power-consumption-suggestions.md` — 不可见组件低功耗建议
228
+ - `bpta-low-power-consumption-of-background-tasks.md` — 后台任务低功耗
229
+ - `bpta-use-of-background-tasks.md` — 后台任务合理使用
230
+ - `bpta-back-task-implement.md` — 应用后台运行
231
+ - `bpta-use-of-background-hardware-resources.md` — 后台硬件资源合理使用
232
+ - `bpta-controlling-background-process-cpu.md` — 控制后台进程CPU使用率
233
+ - `bpta-reasonable-bluetooth-use.md` — 蓝牙资源合理使用
234
+ - `bpta-reasonable-network-use.md` — 网络资源合理使用
235
+ - `bpta-reasonable-audio-use.md` — 音频资源合理使用
236
+ - `bpta-reasonable-gps-use.md` — GPS资源合理使用
237
+ - `bpta-reasonable-sensor-use.md` — 传感器资源合理使用
238
+ - `bpta-use-of-background-software-resources.md` — 后台软件资源合理使用
239
+ - `bpta-reasonable-request-use.md` — 后台上传下载合理使用
240
+ - `bpta-reasonable-audio-playback-use.md` — 后台音频播放合理使用
241
+ - `bpta-reasonable-position-navigation-use.md` — 后台定位导航服务合理使用
242
+ - `bpta-reasonable-system-use.md` — 后台系统资源合理使用
243
+ - `bpta-scenario-power-optimization.md` — 功耗场景优化案例
244
+ - `bpta-vsync-power-optimization.md` — Vsync低功耗优化
245
+ - `bpta-buffer-power-optimization.md` — Buffer低功耗优化
246
+ - **一次开发，多端部署** (47)
247
+ - `bpta-multi-device-overview.md` — 一次开发，多端部署概览
248
+ - `bpta-multi-device-start.md` — 从一个例子开始
249
+ - `bpta-multi-device-design-principles.md` — 多设备体验设计
250
+ - `bpta-multi-device-page.md` — 多设备界面开发
251
+ - `bpta-multi-device-window.md` — 多设备窗口形态
252
+ - `bpta-multi-device-window-mode.md` — 窗口模式
253
+ - `bpta-multi-device-window-direction.md` — 窗口方向
254
+ - `bpta-multi-device-window-immersive.md` — 窗口沉浸式
255
+ - `bpta-multi-device-layout-overview.md` — 布局概述
256
+ - `bpta-multi-device-responsive.md` — 界面布局响应式变化
257
+ - `bpta-multi-device-responsive-layout.md` — 响应式布局
258
+ - `bpta-multi-device-page-layout.md` — 页面布局场景
259
+ - `bpta-multi-device-component-layout.md` — 组件布局场景
260
+ - `bpta-multi-device-screen-layout.md` — 屏幕类型布局场景
261
+ - `bpta-multi-device-adaptive.md` — 界面元素自适应变化
262
+ - `bpta-multi-device-adaptive-layout.md` — 自适应布局
263
+ - `bpta-multi-device-hardware.md` — 特殊界面布局场景
264
+ - `bpta-folded-hover.md` — 折叠屏悬停态
265
+ - `bpta-web-adaptation.md` — Web响应式布局
266
+ - `bpta-compatible-scheme.md` — 兼容方案
267
+ - `bpta-easygo-parallel.md` — 平行视界
268
+ - `bpta-multi-device-interaction.md` — 多设备交互
269
+ - `bpta-multi-interaction.md` — 多设备交互
270
+ - `bpta-multi-device-resource.md` — 多设备资源文件
271
+ - `bpta-multi-device-ui-development.md` — 多设备界面开发案例
272
+ - `multi-video-app.md` — 多设备长视频界面
273
+ - `multi-ticket-class.md` — 多设备股票类界面
274
+ - `multi-business-office.md` — 多设备商务办公界面
275
+ - `bpta-multi-music-app-overview.md` — 多设备音乐界面
276
+ - `multi-shopping-price-comparison.md` — 多设备购物比价界面
277
+ - `multi-travel-accommodation.md` — 多设备旅行订票界面
278
+ - `multi-travel-navigation.md` — 多设备地图导航界面
279
+ - `multi-convenient-life.md` — 多设备便捷生活界面
280
+ - `multi-financial-app.md` — 多设备银行理财界面
281
+ - `multi-community-app.md` — 多设备社区评论界面
282
+ - `multi-news-read.md` — 多设备新闻阅读界面
283
+ - `bpta-multi-mobile-payment.md` — 多设备移动支付界面
284
+ - `multi-communication-app.md` — 多设备即时通讯界面
285
+ - `multi-picture-app.md` — 多设备图片美化界面
286
+ - `bpta-multi_game.md` — 多设备游戏界面
287
+ - `bpta-multi-settings-application-page.md` — 多设备设置界面
288
+ - `multi-short-video-app.md` — 多设备短视频界面
289
+ - `bpta-multi-device.md` — 多设备功能开发
290
+ - `bpta-multi-device-function.md` — 多设备功能开发
291
+ - `bpta-multi-device-camera.md` — 相机硬件差异
292
+ - `bpta-multi-device-screen-diff.md` — 多设备适配屏幕差异
293
+ - `bpta-multi-device-ide.md` — 多设备工程部署与发布
294
+ - **应用框架** (36)
295
+ - `bpta-arkts-language.md` — ArkTS语言
296
+ - `bpta-arkts-high-performance.md` — ArkTS高性能编程
297
+ - `bpta-app-concurrency-design.md` — 应用并发设计
298
+ - `bpta-comparative_practice_of_taskpool_and_worker.md` — TaskPool和Worker对比
299
+ - `bpta-taskpool_usage_specifications_and_faqs.md` — TaskPool使用规范
300
+ - `bpta-application-aspect-programming-design.md` — 应用切面编程设计
301
+ - `bpta-application-track-practice.md` — 应用埋点
302
+ - `bpta-aspect-implements-aop.md` — 基于Aspect插件库实现切面编程
303
+ - `bpta-abckitts-implements-instrumentation.md` — 基于AbcKitTS实现字节码插桩
304
+ - `bpta-package-structure.md` — 程序包结构
305
+ - `bpta-desktop-shortcuts.md` — 桌面快捷方式
306
+ - `bpta-cross-module-reference.md` — Native侧跨HAR/HSP模块接口调用
307
+ - `bpta-app-icon-configuration.md` — 应用图标配置与开发
308
+ - `bpta-program-framework.md` — 程序框架
309
+ - `bpta-link-between-apps-overview.md` — 应用间跳转实践概览
310
+ - `bpta-social-share.md` — 社交分享跳转
311
+ - `bpta-ads-jump.md` — 广告跳转
312
+ - `bpta-special-text-recognition.md` — 特殊文本识别跳转
313
+ - `bpta-web-app-jump-and-pull-up.md` — Web和应用的跳转与拉起
314
+ - `bpta-form-kit.md` — 服务卡片
315
+ - `bpta-music-card.md` — 音乐服务卡片
316
+ - `bpta-card-update-and-data-interaction.md` — 卡片更新与数据交互
317
+ - `bpta-window-and-screen-management.md` — 窗口与屏幕管理
318
+ - `bpta-multi-window-practice.md` — 智慧多窗
319
+ - `bpta-2in1-window-shape.md` — PC/2in1异形窗口
320
+ - `bpta-input-method-framework.md` — 输入法
321
+ - `bpta-keyboard-layout-adapt.md` — 软键盘布局适配
322
+ - `bpta-custom-keyboard.md` — 自定义键盘
323
+ - `bpta-local-file.md` — 数据和文件
324
+ - `bpta-local-file-and-data-multithreaded-io.md` — 多线程操作密集型关系型数据库和文件读写
325
+ - `bpta-web-development.md` — ArkWeb
326
+ - `bpta-arkweb_rendering_framework.md` — ArkWeb渲染框架适配
327
+ - `bpta-render-web-using-same-layer-render.md` — 同层渲染原生组件
328
+ - `bpta-video-adaptation-based-web.md` — Web页面视频适配
329
+ - `bpta-cross-domain-solutions-for-web-pages.md` — Web页面跨域解决方案
330
+ - `bpta-web-interceptor.md` — Web组件拦截能力的使用
331
+ - **自由流转** (19)
332
+ - `bpta-hopping.md` — 自由流转概述
333
+ - `bpta-cross-end-migration.md` — 跨端迁移
334
+ - `bpta-continue-cast.md` — 应用接续概述
335
+ - `bpta-continue-data.md` — 应用接续数据迁移
336
+ - `bpta-application-continue-progess.md` — 常见接续最佳实践
337
+ - `bpta-multi-device-collaboration.md` — 多端协同
338
+ - `bpta-vdeocast.md` — 视频投播
339
+ - `bpta-audio-cast.md` — 音频投播
340
+ - `bpta-distribute-drag-cast.md` — 跨设备拖拽
341
+ - `bpta-unified-drag-and-drop.md` — 统一拖拽
342
+ - `bpta-distributed-pasteboard-cast.md` — 跨设备剪贴板
343
+ - `bpta-distributed-pasteboard.md` — 跨设备剪贴板常见场景
344
+ - `bpta-application-knock-video-share.md` — 碰一碰链接分享
345
+ - `bpta-application-knock-file-share.md` — 碰一碰文件分享
346
+ - `bpta-application-gesture-share.md` — 隔空传送快速分享
347
+ - `bpta-full-scenario-collaborative-development.md` — 典型全场景协同开发案例
348
+ - `bpta-collaboration-office.md` — 办公编辑全场景协同最佳实践
349
+ - `bpta-smartwatchnavigation.md` — 智能穿戴导航协同
350
+ - `bpta-continue.md` — 社交通讯全场景协同最佳实践
351
+ - **布局与弹窗** (18)
352
+ - `bpta-text-expand-collapse.md` — 文本展开折叠
353
+ - `bpta-improve-layout-performance.md` — 布局优化指导
354
+ - `bpta-common-list-flows.md` — 常见列表流
355
+ - `bpta-grid-drag-swap.md` — Grid网格元素拖拽交换
356
+ - `bpta-carousel-graphic-works.md` — 使用Swiper组件实现轮播图
357
+ - `bpta-picture-preview.md` — 图片预览器
358
+ - `bpta-customdialog-selection-and-development.md` — 自定义弹窗选型与开发
359
+ - `bpta-comment-reply-pop-up-window.md` — 评论回复弹窗
360
+ - `bpta-hadss_dialoghub.md` — 基于DialogHub的通用弹窗
361
+ - `bpta-waterflow-based-on-scrollcomponents.md` — 基于ScrollComponents实现瀑布流
362
+ - `bpta-waterflow-operations.md` — 常见瀑布流操作
363
+ - `bpta-grid-based-on-scrollcomponents.md` — 基于ScrollComponents实现网格
364
+ - `bpta-list-based-on-scrollcomponents.md` — 基于ScrollComponents实现长列表
365
+ - `bpta-development-scenarios-for-tabs.md` — Tabs选项卡常见开发场景
366
+ - `bpta-common-list-operations.md` — 常见列表操作
367
+ - `bpta-dialog-encapsulation.md` — 弹窗组件封装
368
+ - `bpta-rich-text-display.md` — 富文本显示的选型与开发
369
+ - `bpta-rich-text-editor.md` — 实现富文本编辑器
370
+ - **多端设备体验提升** (14)
371
+ - `bpta-cell-phone.md` — 手机
372
+ - `bpta-foldable-guide.md` — 双折叠应用开发
373
+ - `bpta-purax-guide.md` — 阔折叠应用开发
374
+ - `bpta-matext-guide.md` — 三折叠应用开发
375
+ - `bpta-tablet-pc.md` — 平板
376
+ - `bpta-pad-guide.md` — 平板应用开发
377
+ - `bpta-pc.md` — 电脑
378
+ - `bpta-pc-guide.md` — 电脑应用开发
379
+ - `bpta-mate-book-fold.md` — 折叠电脑应用开发
380
+ - `bpta-wear.md` — 穿戴
381
+ - `bpta-smartwatch.md` — 智能穿戴应用开发
382
+ - `bpta-lite-wearable-guide.md` — 轻量级智能穿戴应用开发
383
+ - `bpta-tv.md` — 智慧屏
384
+ - `bpta-matetv-guide.md` — 智慧屏应用开发
385
+ - **行业场景解决方案** (13)
386
+ - `bpta-news-reading.md` — 新闻阅读
387
+ - `bpta-news_homepage.md` — 首页信息流体验优化
388
+ - `bpta-reader-page-flip.md` — 阅读器翻页
389
+ - `bpta-audio-video.md` — 影音娱乐
390
+ - `bpta-smooth-switching.md` — 在线短视频流畅切换
391
+ - `bpta-short-video-base-adaptivevideo.md` — 基于adaptive_video的短视频适配
392
+ - `bpta-hmos-live-stream-solution.md` — 基于媒体能力实现直播单播功能
393
+ - `bpta-hmos-live-stream-audio-call.md` — 基于媒体能力实现直播连麦功能
394
+ - `bpta-landscape-and-portrait-development.md` — 视频类应用横竖屏切换
395
+ - `bpta-travel-navigation.md` — 出行导航
396
+ - `bpta-shared-bicycle.md` — 快捷骑行体验
397
+ - `bpta-social-communications.md` — 社交通讯
398
+ - `bpta-content-creation.md` — AI辅助图文内容编创
399
+ - **图形** (10)
400
+ - `bpta-graphic-drawing-practices.md` — 图形绘制
401
+ - `bpta-drawing-capability-improve-performance.md` — Drawing自绘制性能提升
402
+ - `bpta-add-watermark.md` — 水印添加
403
+ - `bpta-implement-timeline-based-on-canvas.md` — 基于Canvas实现录像回放时间轴
404
+ - `bpta-image-processing-practices.md` — 图像处理
405
+ - `bpta-fuzzy-scene-performance-optimization.md` — 图像模糊动效优化
406
+ - `bpta-background-blur.md` — 图像模糊高效使用
407
+ - `bpta-analysis-of-image-blurring.md` — 图像模糊卡顿问题分析
408
+ - `bpta-gpu-acceleration-practices.md` — GPU加速
409
+ - `bpta-maleoon-gpu-best-practices.md` — 马良GPU渲染优化
410
+ - **应用安全** (10)
411
+ - `bpta-app-privacy-protection.md` — 应用隐私保护
412
+ - `bpta-app-data-security.md` — 应用数据安全
413
+ - `bpta-harmony-application-security.md` — 应用安全编码实践
414
+ - `bpta-app-asset-protection-design.md` — 应用资产保护设计
415
+ - `bpta-app-code-ob.md` — 应用代码混淆
416
+ - `bpta-permission-application.md` — 应用权限申请
417
+ - `bpta-network-ca-security.md` — 网络连接安全配置
418
+ - `bpta-cross-platform-compatibility.md` — 加解密跨平台数据兼容性
419
+ - `bpta-recommended-use-of-device-id.md` — 设备标识使用推荐
420
+ - `bpta-arkweb-component-security.md` — ArkWeb组件安全开发
421
+ - **技术创新** (7)
422
+ - `bpta-smart-reach.md` — 智感握姿
423
+ - `bpta-spatiality-immersive.md` — 沉浸光感
424
+ - `bpta-risk-control-engine.md` — 星盾机密风控引擎
425
+ - `bpta-antipeep-protection.md` — 防窥保护
426
+ - `bpta-pre-connect.md` — 冷启网络预建链最佳实践
427
+ - `bpta-live-form-development-practice.md` — 互动卡片开发实践
428
+ - `bpta-live-streaming-optimization.md` — 弱网直播优化
429
+ - **主题与样式** (5)
430
+ - `bpta-dark-mode-adaptation.md` — 深色模式适配
431
+ - `bpta-page-brightness-settings.md` — 页面亮度设置
432
+ - `bpta-custom-font-settings.md` — 自定义字体设置
433
+ - `bpta-implementing-image-filters.md` — 基于colorFilter实现图片滤镜效果
434
+ - `bpta-implementing-image-resizable.md` — 基于resizable实现图片拉伸效果
435
+ - **网络** (4)
436
+ - `bpta-network-reconnection.md` — 应用网络重连
437
+ - `bpta-bluetooth-low-energy.md` — 低功耗蓝牙基础使用
438
+ - `bpta-file-transmission-based-on-sfft.md` — 基于SFFT的大文件高速并发传输
439
+ - `bpta-common-network-query.md` — 网络信息查询与连接管理
440
+ - **组件封装与复用** (4)
441
+ - `bpta-ui-dynamic-operations.md` — 组件动态创建
442
+ - `bpta-ui-component-encapsulation.md` — 组件封装
443
+ - `bpta-component-reuse.md` — 组件复用
444
+ - `bpta-component-reuse-issue-diagnosis-and-analysis.md` — 组件复用问题诊断分析
445
+ - **NDK开发** (4)
446
+ - `bpta-complex-type-pass.md` — 跨语言调用复杂参数传递
447
+ - `bpta-dynamic-link-library.md` — 三方动态链接库集成
448
+ - `bpta-thread-priority-setting.md` — 高负载场景线程优先级设置
449
+ - `bpta-native-sub-main-comm.md` — Native侧子线程与UI主线程通信
450
+ - **场景创新** (3)
451
+ - `bpta-game-prelaunch-practice.md` — 游戏预启动开发实践
452
+ - `bpta-always-on-market-watch.md` — 全链路盯盘开发实践
453
+ - `bpta-wavewheel-for-image-editor.md` — 实现修图软件的波轮菜单功能
454
+ - **动画与转场** (3)
455
+ - `bpta-fair-use-animation.md` — 动画使用指导
456
+ - `bpta-page-transition.md` — 页面间转场
457
+ - `bpta-one-shot-to-the-end.md` — 一镜到底动效
458
+ - **声明式语法** (3)
459
+ - `bpta-status-management.md` — 状态管理最佳实践
460
+ - `bpta-redundancy-refresh-guide.md` — 组件冗余刷新解决方案
461
+ - `bpta-global-state-management-state-store.md` — 基于StateStore的全局状态管理
462
+ - **手势与导航** (3)
463
+ - `bpta-multi-tab-practice.md` — 常见导航样式案例
464
+ - `bpta-hmrouter.md` — 基于HMRouter的页面跳转
465
+ - `bpta-gestures-practice.md` — 手势事件冲突解决方案
466
+ - **应用架构** (3)
467
+ - `bpta-app-architecture-overview.md` — 架构概览
468
+ - `bpta-layered-architecture-design.md` — 分层架构设计
469
+ - `bpta-modular-design.md` — 模块化设计
470
+ - **编译构建** (2)
471
+ - `bpta-custom-hvigor-plugin.md` — 定制hvigor插件
472
+ - `bpta-multi-target.md` — 多目标产物构建
473
+ - **应用服务** (2)
474
+ - `bpta-positioning.md` — 位置定位
475
+ - `bpta-lock-screen-immersive-live-window.md` — 锁屏沉浸实况窗
476
+ - **AI使能** (2)
477
+ - `bpta-intent-recommend-practice.md` — 意图框架习惯推荐场景
478
+ - `bpta-agent.md` — 智能体场景开发案例
479
+ - **测试框架** (1)
480
+ - `bpta-automated-testing-frameworks.md` — 自动化测试框架开发实践
481
+ - **概览** (1)
482
+ - `bpta-best-practices-overview.md` — 最佳实践概览
483
+ - **文档变更说明** (1)
484
+ - `changelog.md` — 最佳实践文档变更说明
485
+ - **应用质量概览** (1)
486
+ - `bpta-quality-overview.md` — 应用质量概览