最佳实践文档变更说明

2026年9月

[h2]新增文档

新增文档27篇。

场景创新

• 基于长时任务与实况窗的视频后台导出方案：介绍如何基于系统能力实现完整的后台视频导出方案。

行业场景解决方案

• 音频播放无声问题定位指导：介绍了hilog日志采集、hilog日志分析，并结合典型案例帮助开发者定位音频播放无声问题。

稳定性

• 地址越界故障模式概述：介绍了系统梳理常见故障场景、日志特征、分析步骤和修复方法。
• 内存释放后访问故障模式说明：本文结合HWASan（Hardware-assisted AddressSanitizer）、ASan（AddressSanitizer）和GWP-ASan（GWP-ASan Will Provide Allocation SANity）典型案例，介绍内存释放后访问的日志特征与定位方法。
• 文件句柄非法关闭故障模式说明：介绍了地址越界故障模式库中的文件句柄非法关闭故障模式说明。
• 未定义异常访问故障模式说明：结合典型案例，介绍定义异常访问故障模式问题的日志特征与定位方法。
• 数据竞争异常访问故障模式说明：结合典型案例，展示数据竞争异常访问问题的日志特征与定位方法。
• ArkTS内存泄漏故障模式概述：本文提供ArkTS OOM问题的分析与定位实践系列文章，旨在系统梳理典型故障场景与问题分析方法。
• GlobalHandle类型内存泄漏故障模式说明：本文旨在指导HarmonyOS应用开发者定位GlobalHandle类型的ArkTS内存泄漏问题。
• LocalHandle类型内存泄漏故障模式说明：本文旨在指导HarmonyOS应用开发者定位LocalHandle类型的ArkTS内存泄漏问题。
• VMRoot类型内存泄漏故障模式说明：本文旨在指导HarmonyOS应用开发者定位VMRoot类型的ArkTS内存泄漏问题。
• 申请超大对象导致OOM故障模式说明：本文旨在指导HarmonyOS应用开发者定位因单次申请超大对象导致的ArkTS OOM（Out of Memory，内存溢出）故障。
• 文件映射过大导致内存泄漏故障模式说明：介绍文件映射内存泄漏的几种常见根因，结合案例提供开发态与运维态的问题分析思路。
• 栈内存过大导致内存泄漏故障模式说明：本文旨在为开发者介绍栈内存过大的可能根因，并结合案例介绍开发态与运维态的问题分析思路。
• 组合使用过大导致内存泄漏故障模式说明：介绍了多类型内存组合过大导致的RSS内存泄漏问题提供分析思路和负向案例分析。
• 泛PSS内存泄漏故障模式概述：介绍了泛PSS内存泄漏问题分析与定位实践系列文章，旨在系统梳理泄漏常见根因与问题分析方法。
• 应用泛PSS内存泄漏故障模式说明：介绍了应用发生泛PSS内存泄漏的主要根因，并基于案例介绍开发态与运维态的问题分析思路。
• DMA内存泄漏故障模式概述：介绍了系统的DMA内存泄漏检测机制，并提供开发态与运维态的问题分析思路。
• 应用DMA内存泄漏故障模式说明：介绍了应用DMA内存泄漏的几种常见根因，并基于案例介绍开发态与运维态的问题分析思路。
• ASHMEM内存泄漏故障模式概述：介绍了系统的ASHMEM内存泄漏检测机制，并提供开发态与运维态的问题分析思路。
• 应用ASHMEM内存泄漏故障模式说明：介绍ASHMEM内存泄漏的常见根因，并结合案例，指导在开发态与运维态场景下的常见分析思路。
• 线程泄漏故障模式概述：介绍了系统的线程泄漏检测机制和开发态与运维态的问题分析思路。
• 应用线程泄漏故障模式说明：介绍线程泄漏的几种常见根因，并基于案例介绍开发态与运维态的问题分析思路。
• 句柄泄漏故障模式概述：介绍了句柄泄漏检测机制，并提供开发态与运维态的问题分析思路。
• 应用句柄泄漏故障模式说明：介绍了句柄泄漏的各种常见根因，并结合实际故障案例，分别讲解运维态与开发态的问题分析思路。
• 运维态高效处理DMA资源泄漏：介绍了在运维态下如何通过APMS平台和Operation Analyzer平台对DMA资源泄漏问题进行监控、分析、定位与修复的完整处理方法。
• 运维态高效处理线程泄漏：介绍了在运维态下如何通过应用质量管理（APMS）平台进行线程泄漏的监控、分析、定位与修复的整套处理方法。

[h2]优化文档

优化文档2篇。

行业场景解决方案

• 全屏短视频自适应缩放和沉浸：增加短视频自适应方案。

一次开发，多端部署

• 折叠屏悬停态：增加悬停态适配方案。

[h2]下线文档

下线文档33篇。

布局与弹窗

• Grid网格元素拖拽交换：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>列表与网格>Grid网格元素拖拽。
• 常见瀑布流操作：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>列表与网格>常见瀑布流操作。
• Tabs选项卡常见开发场景：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>组件布局>构建布局>选项卡 (Tabs)。

手势与导航

• 手势事件冲突解决方案：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发调试调优>UI开发常见问题>手势事件冲突常见问题。

动画与转场

• 动画使用指导：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>使用动画>优化动画性能。
• 一镜到底动效：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>使用动画>转场动画>共享元素转场 (一镜到底)。

主题与样式

• 基于colorFilter实现图片滤镜效果：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>媒体展示>基于colorFilter实现图片滤镜效果。
• 基于resizable实现图片拉伸效果：内容已迁移至指南应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>媒体展示>基于resizable实现图片拉伸效果。

应用框架

• TaskPool和Worker对比：内容已迁移至指南>应用框架>ArkTS（方舟编程语言）>ArkTS并发>多线程并发>TaskPool和Worker的对比。
• TaskPool使用规范：已迁移至指南>应用框架>ArkTS（方舟编程语言）>ArkTS并发>多线程并发>TaskPool使用规范。
• Native侧跨HAR/HSP模块接口调用：内容已迁移至指南>基础入门>开发基础知识>典型场景的开发指导>Native侧跨HAR/HSP模块接口调用。
• 社交分享跳转：内容已迁移至指南>应用框架>Ability Kit（程序框架服务）>应用间跳转>应用间跳转典型场景>社交分享跳转。
• 广告跳转：内容已迁移至指南>应用框架>Ability Kit（程序框架服务）>应用间跳转>应用间跳转典型场景>广告跳转。
• 特殊文本识别跳转：容已迁移至指南>应用框架>Ability Kit（程序框架服务）>应用间跳转>应用间跳转典型场景>特殊文本识别跳转。
• Web和应用的跳转与拉起：内容已迁移至指南>应用框架>Ability Kit（程序框架服务）>应用间跳转>应用间跳转典型场景>Web和应用的跳转与拉起。

媒体

• 音乐服务卡片：内容已迁移至指南>应用框架>Form Kit（卡片开发服务）>ArkTS卡片开发（推荐）>ArkTS卡片最佳实践>音乐服务卡片。
• 卡片更新与数据交互：内容已迁移至指南>应用框架>Form Kit（卡片开发服务）>ArkTS卡片开发（推荐）>ArkTS卡片最佳实践>卡片更新与数据交互。
• 自定义键盘：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>使用文本>自定义键盘。
• Web组件拦截能力的使用：内容已迁移至指南>应用框架>ArkWeb（方舟Web）>管理网页加载与浏览记录>Web组件拦截能力的使用。
• 长截图：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>UI系统场景化能力>长截图。
• 渲染视频画面：内容已迁移至指南>媒体>AVCodec Kit（音视频编解码服务）>音视频编解码>视频编解码典型场景实践>渲染视频画面。
• 基于Surface模式进行视频编码:内容已迁移至指南>媒体>AVCodec Kit（音视频编解码服务）>音视频编解码>视频编解码典型场景实践>基于Surface模式进行视频编码。
• 基于AVScreenCapture实现屏幕录制：内容已迁移至指南>媒体>Media Kit（媒体服务）>媒体开发指导(ArkTS)>媒体开发实践>基于AVScreenCapture实现屏幕录制（ArkTS）。
• HDR Vivid视频播放与录制开发实践：内容已迁移至指南>媒体>AVCodec Kit（音视频编解码服务）>音视频编解码>视频编解码典型场景实践>HDR Vivid视频播放与录制开发实践。
• HDR Vivid视频转码SDR视频开发实践：内容已迁移至指南>媒体>AVCodec Kit（音视频编解码服务）>音视频编解码>视频编解码典型场景实践>HDR Vivid视频转码SDR视频开发实践。
• 基于系统能力获取视频缩略图：内容已迁移至指南>媒体>Media Kit（媒体服务）>媒体开发指导(ArkTS)>媒体开发实践>基于系统能力获取视频缩略图。
• 基于Buffer模式进行视频转码：内容已迁移至指南>媒体>AVCodec Kit（音视频编解码服务）>音视频编解码>视频编解码典型场景实践>基于Buffer模式进行视频转码。

图形

• 图像模糊动效优化：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>使用动画>动画效果>模糊>对比动态模糊与静态模糊。
• 图像模糊高效使用：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>使用动画>动画效果>模糊>高效使用模糊。
• 图像模糊卡顿问题分析：内容已迁移至指南>应用框架>ArkUI（方舟UI框架）>UI开发 (ArkTS声明式开发范式)>使用动画>动画效果>模糊>模糊卡顿问题定位与指导。

NDK开发

• 三方动态链接库集成：内容已迁移至指南>NDK开发>构建NDK工程>三方动态链接库集成。
• 高负载场景线程优先级设置：内容已迁移至指南>系统>基础功能>Kernel Enhance Kit（内核增强能力）>内存管理 Purgeable Memory 开发指导>高负载场景线程优先级设置。

应用安全

• 应用代码混淆：内容已迁移至指南>应用框架>ArkTS（方舟编程语言）>ArkTS编译工具链>ArkGuard源码混淆工具>ArkGuard混淆实践指导。

2026年8月

[h2]新增文档

新增文档22篇。

行业场景解决方案

• 基于PixelMap实现图片编辑：介绍了如何使用PixelMap对图片进行编辑处理，如获取图片信息、裁剪、缩放、偏移、旋转、翻转、设置透明度、读写像素数据等。
• 基于PixelMap与Canvas实现图片编辑：介绍了如何基于PixelMap和Canvas实现图片编辑处理，如获取图片信息、裁剪、缩放、偏移、旋转、翻转、设置透明度、读写像素数据、图片水印添加等。
• 视频轻编辑开发实践：介绍了视频轻编辑基于媒体能力的典型场景，包括视频预览，添加文字/图片/背景音乐，视频裁剪、导出等。
• XComponent图形渲染常见问题定位指导：介绍了如何从XComponent渲染原理、图形渲染定位工具链、典型案例分析思路三个方面排查XComponent渲染时可能出现黑屏、卡顿等问题的定位排查指导。
• 听书解决方案：介绍了如何采用ArkTS和C++混合开发模式，使用OHAudio原生音频引擎实现高品质音频播放。

稳定性

• 开发态快速定位应用崩溃：介绍了以内存越界访问为典型案例，构建数组越界示例工程。
• 运维态高效处理GPU内核泄漏：介绍了如何通过APMS智能分析平台定位问题的全部流程。
• 运维态高效处理FD资源泄漏：介绍了在运维态下如何通过应用质量管理（APMS）平台进行FD资源泄漏的监控、分析、定位与修复。
• 应用冻屏故障检测机制及规格说明：介绍了应用冻屏故障检测检测机制、日志规格、日志获取方式等。
• RSS内存泄漏故障模式概述：介绍了RSS内存泄漏概念、系统检测机制以及开发态和运维态的分析方法。
• NativeHeap堆过大导致内存泄漏故障模式说明：介绍了NativeHeap内存泄漏的可能根因，结合案例提供开发态与运维态的问题分析思路。
• 匿名映射过大导致内存泄漏故障模式说明：介绍匿名映射内存泄漏的可能根因，并结合案例为开发者介绍开发态与运维态的问题分析思路。
• GPU内存泄漏故障模式概述：介绍了RSS内存泄漏概念、系统检测机制以及开发态和运维态的分析方法。
• 单应用自渲染GPU内存泄漏故障模式说明：介绍了应用自渲染场景发生GPU内存泄漏的主要根因，并基于案例提供开发态与运维态的问题分析思路。
• ArkWeb V8 OOM故障模式概述：介绍了ArkWeb V8引擎OOM（Out Of Memory）问题的分析与定位实践。
• JS对象长期被JS持有导致内存泄漏故障模式说明：介绍了两种JS对象内存占用过高导致引擎OOM的问题场景。
• JSVM OOM故障模式概述：介绍了JSVM的JS引擎及其堆内存结构以及JS引擎内存初步分析方法。
• JS对象被Native持有导致内存泄漏故障模式说明：列举几种可能引发OOM的CPP代码，通过内存分析方法展示对应代码下的堆内存特征，并给出预防建议。
• JS对象长期被JS持有导致内存泄漏故障模式说明：列举几种可能引发OOM的JS代码，通过内存分析方法展示对应代码下的堆内存特征，并给出预防建议。
• 内存释放地址异常故障模式说明：本文结合HWASan（Hardware-assisted AddressSanitizer）、ASan（AddressSanitizer）典型案例，介绍内存释放地址异常问题的日志特征与定位方法。
• 内存越界访问故障模式说明：本文结合HWASan（Hardware-assisted AddressSanitizer）、ASan（AddressSanitizer）和GWP-ASan（GWP-ASan Will Provide Allocation SANity）典型案例，介绍堆、栈内存越界访问的日志特征与定位方法。
• 内存重复释放故障模式说明：本文结合HWASan（Hardware-assisted AddressSanitizer）、ASan（AddressSanitizer）和GWP-ASan（GWP-ASan Will Provide Allocation SANity）典型案例，介绍堆内存重复释放问题的日志特征与定位方法。

[h2]优化文档

优化文档7篇。

媒体

音频焦点管理解决方案：新增应用内短视频与VoIP通话焦点冲突问题小节，介绍应用内VoIP通话与短视频焦点冲突问题分析思路及解决方案。

一次开发，多端部署

• 页面布局场景：新增边看边评典型场景，优化双分栏判断逻辑与比例。
• 平行视界：平行视界2.0配置能力更新。
• 窗口方向：新增“使用多设备工具模块设置窗口旋转策略”章节，该章节介绍了多设备工具模块的组成和使用方法。
• 多设备新闻阅读界面：优化了《多设备新闻阅读界面》的成体架构，提供了新闻阅读类应用的工程管理、UX设计、界面开发、交互开发相关指导。

多端设备支持

• 电脑应用开发：新增梦露电脑硬件参数、产品示意图、手写笔适配内容。

性能

• 懒加载优化性能：新增混合布局列表。

2026年7月

[h2]新增文档

新增文档19篇。

行业场景解决方案

• 基于List和Scroller实现双向滚动列表：介绍了如何基于List组件和Scroller控制器，封装核心组件DualScrollTable（双向滚动列表组件），实现满足基础功能的双向滚动列表解决方案。
• K歌解决方案：介绍了如何基于AudioCapturer、AudioRenderer、AudioLoopback、AudioRoutingManager、AVPlayer开发一个K歌应用。

稳定性

• CppCrash故障检测机制及规格说明：介绍了CppCrash故障检测机制及规格说明，为开发者提供详细的维测日志以辅助故障定位。
• SIGSEGV无效内存访问故障模式说明：介绍了SIGSEGV无效内存访问故障模式说明，为开发者提供详细的问题定位及处理指导。
• SIGABRT进程主动终止故障模式说明：介绍了SIGABRT进程主动终止故障模式说明，为开发者提供详细的问题定位及处理指导。
• SIGBUS非法内存访问故障模式说明：介绍了SIGBUS非法内存访问故障模式说明，为开发者提供详细的问题定位及处理指导。
• SIGILL非法指令故障模式说明：介绍了SIGILL非法指令故障模式说明，为开发者提供详细的问题定位及处理指导。
• SIGTRAP断点或陷阱异常故障模式说明：介绍了SIGTRAP断点或陷阱异常故障模式说明，为开发者提供详细的问题定位及处理指导。
• 应用主线程阻塞故障模式说明：介绍了如何通过分析应用冻屏故障日志中的主线程堆栈，定位主线程阻塞类型的应用冻屏（AppFreeze）问题。
• 应用主线程繁忙故障模式说明：介绍了如何通过分析应用冻屏故障日志中的主线程堆栈，定位主线程繁忙类型的应用冻屏（AppFreeze）问题。
• ArkWeb GPU进程卡死故障模式说明：介绍了如何定位主线程阻塞在ArkWeb堆栈类型的应用冻屏（AppFreeze）问题。
• ArkWeb Render进程卡死故障模式说明：介绍了如何定位因render卡死导致的应用冻屏（AppFreeze）问题。
• 开发态快速定位ArkTS泄漏：介绍了如何通过常见泄漏场景和ArkTS内存泄漏分析案例，快速定位应用中的内存泄漏问题。
• 开发态快速定位DMA泄漏：介绍了如何通过高频泄漏场景和DMA内存泄漏分析案例快速定位应用DMA泄漏的问题
• 开发态快速定位Native泄漏：介绍了如何通过高频泄漏场景和Native内存泄漏分析案例，定位应用中的Native内存泄漏问题。
• 开发态快速定位AppFreeze冻屏：介绍了如何通过高频冻屏场景及分析案例，快速定位冻屏问题。
• 运维态高效处理应用崩溃：介绍了在运维态下如何通过APMS平台对应用崩溃事件进行标准化排查、分析、定位和修复的闭环流程。
• 运维态高效处理ArkTS泄漏：介绍了在运维态下如何通过APMS平台进行ArkTS泄漏事件的标准化排查、分析、定位和修复闭环流程。
• 运维态高效处理Native泄漏：介绍了在运维态下如何利用APMS平台完成Native内存泄漏的监控、分析、定位及修复全流程。
• 运维态高效处理应用冻屏：介绍了在运维态下如何通过APMS平台对应用冻屏事件进行标准化排查、分析、定位和修复的闭环流程。

[h2]优化文档

优化文档1篇。

自由流转

• 碰一碰文件分享：新增碰一碰精准分享章节。

[h2]下线文档

下线文档30篇。

组件封装与复用

• 组件动态创建：内容已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架）> UI开发 (ArkTS声明式开发范式) > 学习UI范式基本语法 > 自定义组件 > 自定义组件复用 > 自定义组件复用开发实践”。
• 组件封装：内容已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架）> UI开发 (ArkTS声明式开发范式) > 学习UI范式基本语法 > 自定义组件 > 自定义组件复用 > 自定义组件复用开发实践”。
• 组件复用：已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架）> UI开发 (ArkTS声明式开发范式) > 学习UI范式基本语法 > 自定义组件 > 自定义组件复用 > 组件复用问题诊断分析”。
• 组件复用问题诊断分析：内容已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架）> UI开发 (ArkTS声明式开发范式) > 学习UI范式基本语法 > 自定义组件 > 自定义组件复用 > 组件复用问题诊断分析”。

布局与弹窗

• 自定义弹窗选型与开发：内容已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架) > UI开发 (ArkTS声明式开发范式) > 使用弹窗 > 自定义弹窗选型与开发”。
• 常见列表流：内容已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架）> UI开发 (ArkTS声明式开发范式) > 列表与网格 > 常见列表流”。
• 文本展开折叠：内容已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架）> UI开发 (ArkTS声明式开发范式) > 使用文本 > 文本展开折叠”。
• 富文本显示的选型与开发：内容已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架）> UI开发 (ArkTS声明式开发范式) > 使用文本 > 富文本显示的选型与开发”。
• 布局优化指导：内容已迁移至“指南 > 应用框架 > ArkUI（方舟UI框架) > UI开发 (ArkTS声明式开发范式) > 组件布局 > 布局优化指导”。

动画与转场

• 页面间转场：指南中已有相似文档，详见页面转场动画 (不推荐)。

应用框架

• 同层渲染原生组件：内容已迁移至“指南>应用框架>ArkWeb（方舟Web）>同层渲染原生组件”。

网络

• 网络信息查询与连接管理：内容已迁移至“指南>系统>网络>Network Kit（网络服务）>连接网络>连接网络开发实践>网络信息查询与连接管理”。
• 应用网络重连：内容已迁移至“指南>系统>网络>Network Kit（网络服务）>连接网络>连接网络开发实践>应用网络重连”。

媒体

• 基于AVPlayer播放长视频实践：内容已迁移至“指南 > 媒体 > Media Kit（媒体服务）> 媒体开发指导(ArkTS) > 媒体开发实践 > 基于AVPlayer播放长视频实践”。
• 基于AVPlayer播放短视频实践：内容已迁移至“指南 > 媒体 > Media Kit（媒体服务）> 媒体开发指导(ArkTS) > 媒体开发实践 > 基于AVPlayer播放短视频实践”。
• 基于AVPlayer播放嵌入式短视频实践：内容已迁移至“指南 > 媒体 > Media Kit（媒体服务）> 媒体开发指导(ArkTS) > 媒体开发实践 > 基于AVPlayer播放嵌入式短视频实践”。
• 基于AVPlayer播放网络视频实践：内容已迁移至“指南 > 媒体 > Media Kit（媒体服务）> 媒体开发指导(ArkTS) > 媒体开发实践 > 基于AVPlayer播放网络视频实践”。
• 在线视频播放卡顿优化：内容已迁移至“指南 > 媒体 > Media Kit（媒体服务）> 媒体开发指导(ArkTS) > 媒体开发实践 > 在线视频播放卡顿优化”。
• 音画同步：内容已迁移至“指南 > 媒体 > AVCodec Kit（音视频编解码服务）> 音视频编解码开发实践 > 音画同步”。
• 图片获取与保存实践：内容已迁移至“指南 > 媒体 >Media Library Kit（媒体文件管理服务）> 图片获取与保存实践”。
• 自定义相机拍照：内容已迁移至“指南>媒体>Camera Kit（相机服务）>开发相机应用基础能力(ArkTS)>拍照(ArkTS)”。
• 自定义相机录像：内容已迁移至“指南>媒体>Camera Kit（相机服务）>开发相机应用基础能力(ArkTS)>录像(ArkTS)”。
• 自定义相机预览：内容已迁移至“指南>媒体>Camera Kit（相机服务）>开发相机应用基础能力(ArkTS)>预览(ArkTS)”。
• 相机预览花屏解决方案：内容已迁移至“指南>媒体>Camera Kit（相机服务）>开发相机应用基础能力(ArkTS)>相机预览花屏解决方案”。

NDK开发

• Native侧子线程与UI主线程通信：内容已迁移至“指南 > NDK 开发 > 编译工具链 > Native侧子线程与UI主线程通信”。
• 跨语言调用复杂参数传递：内容已迁移至“指南 > NDK 开发 > 编译工具链 > 跨语言调用复杂参数传递”。

应用安全

• 加解密跨平台数据兼容性：内容已迁移至“指南>系统>安全>Crypto Architecture Kit（加解密算法框架服务）>实现跨平台加解密数据兼容性”。
• 网络连接安全配置：内容已迁移至“指南>系统>网络>Network Kit（网络服务）>连接网络>连接网络开发实践>网络连接安全配置”。

稳定性

• 故障类型：文档内容下线。
• 日志规格：文档内容下线。

2026年6月

[h2]新增文档

新增文档10篇。

技术创新

• 智感握姿：介绍了如何在HarmonyOS应用中接入智感握姿能力，具体包括组件原生适配与自定义握持感知两种方案。
• 沉浸光感：介绍了如何在HarmonyOS应用中快速接入沉浸光感能力。包括沉浸光感的基础概念，首眼沉浸光感、自适应悬浮导航与智感握姿智能交互三大应用场景。
• 防窥保护：介绍了如何基于dlpAntiPeep能力，智能检测到旁窥风险时，系统对隐私数据的安全操作，从而保护用户安全隐私。
• 冷启网络预建链最佳实践：介绍了远场通信预键链特性在网络请求获取资源的原理及特点、实现流程和约束与限制。
• 星盾机密风控引擎：介绍了星盾机密风控引擎的功能原理及特点，如何在涉诈场景中应用和使用该特性的约束与限制。
• 弱网直播优化：介绍quic特性在弱网直播场景下原理及特点、实现流程和约束限制。
• 互动卡片开发实践：介绍了互动卡片的使用场景、开发方案和常见问题。

场景创新

• 实现修图软件的波轮菜单功能：介绍了如何使用波轮菜单SDK提供的完整的波轮菜单功能封装，实现在应用中集成波轮菜单功能的开发指导。
• 全链路盯盘开发实践：介绍了如何实现桌面盯盘、防窥保护、锁屏盯盘、待机屏保盯盘的功能开发。
• 游戏预启动开发实践：介绍了如何实现游戏预启动的功能开发。

[h2]优化文档

优化文档8篇。

媒体

• 音频焦点管理解决方案：优化文章描述和示例代码。

一次开发，多端部署

• 多设备音乐界面：文档架构调整，整篇优化。
• 多设备购物比价界面：文档架构调整，整篇优化。
• 多设备社区评论界面：文档架构调整，整篇优化；实现的一多社区评论界应用，补充适配三折叠、阔折叠、Hope、电脑。
• 多设备短视频界面：文档架构调整，整篇优化；增加了三折叠、阔折叠、电脑、智慧屏、智能穿戴的适配，增加视频播放、视频切换、展开评论区、短视频自适应等功能开发指导。

自由流转

• 常见接续最佳实践：更新流程图和部分设备运行动图，更新文章章节结构。
• 社交通讯全场景协同最佳实践：扩展垂域案例，增加碰一碰添加图片、碰一碰/隔空传送分享内容的功能。

稳定性

• 使用GWP-ASan检测内存错误：GWP-ASan常见案例完善，从代码实例、定位思路、修复建议等维度补充介绍各类异常检测类型。

[h2]下线文档

下线文档9篇。

应用框架

• 跨模块资源访问：文档已迁移至指南。
• Native侧实现文件访问：文档已迁移至指南。

网络

• 多网并发网络加速：文档已迁移至指南。

AI使能

• 基于RAG框架实现邮件智能问答：文档已迁移至指南。

编译构建

• GN构建工程配置HarmonyOS编译工具链：文档已迁移至指南。
• CMake构建工程配置HarmonyOS编译工具链：文档已迁移至指南。
• Make构建工程配置HarmonyOS编译工具链：文档已迁移至指南。
• Configure构建工程配置HarmonyOS编译工具链：文档已迁移至指南。
• 使用lycium工具快速编译三方库：文档已迁移至指南。

2026年5月

[h2]新增文档

新增文档3篇。

应用框架

• 基于AbcKitTS实现字节码插桩：介绍了在实际业务场景中，AbcKitTS的切面编程中的高频应用模式和基本使用方法。

性能

• Web帧率问题分析：介绍了三方应用在滑动时产生丢帧现象的常见原因，并提供了相应的解决方案。

稳定性

• JS Crash类问题案例：介绍了当前开发者所遇到的高频JS Crash故障案例。

2026年4月

[h2]自由流转目录结构变更

变更背景

为提升开发者使用体验，对全场景协同章节进行全面优化：指南中的自由流转迁移至最佳实践，与全场景协同章节相整合。

变更内容

• 将全场景协同更名为自由流转。
• 原指南中的自由流转内容下架，相关内容整合迁移至最佳实践 > 自由流转目录，并与最佳实践中原有的全场景协同内容合并。
• 最佳实践下的自由流转目录重新划分为跨端迁移、多端协同、典型全场景协同开发案例三部分，在原有内容基础上调整目录结构，并优化融合《自由流转概述》《应用接续概述》《应用接续数据迁移》《跨设备拖拽》《跨设备剪贴板》指南文章。
• 调整后，自由流转目录将在最佳实践板块下形成完整的知识体系架构，指导开发者全方位理解并实践自由流转开发。

[h2]新增文档

新增文档6篇。

• 媒体
• 基于Video组件播放长视频：介绍了如何基于Video组件实现长视频播放，实现基本播控、视频首帧显示、全屏播放、跳转播放、前台小窗播放、点击按钮选择倍速、长按视频倍速、循环播放、音量设置、接入播控中心等功能。
• 基于Video组件播放短视频：介绍了如何使用Video组件实现短视频播放，实现基础播控、自定义进度条、全屏播放、跳转播放、播放倍速调节、自动连播、音量设置及前后台状态感知等功能。

功耗

• 应用UI进程空跑问题分析：介绍了什么是应用UI进程空跑、应用UI进程空跑的分析思路和常见故障根因。
• 自渲染图层未使用硬件合成问题分析：介绍了如何实现自渲染图层使用硬件合成、问题定位和常见问题根因。
• 应用退后台禁止使用传感器问题分析：介绍了为何应用退后台禁止使用传感器和问题定位流程。

[h2]优化文档

优化文档3篇。

多端设备体验提升

• 阔折叠/阔直板应用开发：在原有Pura X阔折叠基础上，补充Puira X Max的相关开发指导。

一次开发，多端部署

• 多设备长视频界面：新增阔折叠、三折叠、PC和智慧屏适配，按照最新案例优化内容，简化功能描述。
• 窗口方向：分类介绍了18种窗口横竖屏旋转枚举的效果，以窗口旋转策略实现的高频场景为载体，帮助开发者选择更适合应用的窗口旋转模式。

[h2]删除文档

删除文档2篇。

媒体

• 音频播放交互场景：介绍在音乐播放器应用中，如何从应用与用户、播放设备以及其他应用的交互三方面入手，为应用带来灵活多样、符合用户直觉的交互体验的示例方案。
• 视频播放：介绍如何基于HarmonyOS能力快速实现视频播放应用。

2026年3月

[h2]新增文档

新增文档4篇。

全场景协同

• 社交通讯全场景协同最佳实践：介绍如何通过应用接续功能（实现不同设备间的快速切换）和跨设备互通功能，提升内容发布的便利性。
• 视频投播：介绍如何高效利用系统投播组件和接口实现视频投播。
• 音频投播：介绍如何高效利用系统投播组件和接口实现音频投播。
• 办公编辑全场景协同最佳实践：介绍如何插入其他设备的图文、切换设备继续编辑、分享协作。

2026年2月

[h2]新增文档

新增文档15篇。

应用框架

• 应用图标配置与开发：介绍了应用图标生成、配置、相关规范与常见开发场景。

媒体

• 管理音频输出设备开发实践：介绍了如何实现获取输出设备信息、切换输出设备、响应设备变更等场景，并对开发过程中的常见问题提供解决方案。
• 概述：介绍了多样化的音频播放的实现形式，为了帮助开发者快速了解音频播放功能，提供五种音频格式和业务场景快速选型。
• 基于AudioRender播放PCM音频：介绍了如何指导开发者使用AudioRender接口实现播放PCM音频的功能。
• 基于OHAudio播放PCM音频：介绍了如何指导开发者使用OHAudio接口实现播放PCM音频的功能。
• 基于AVPlayer播放格式化音频（ArkTS）：介绍了如何指导开发者使用AVPlayer的ArkTS API实现播放格式化音频的功能。
• 基于AVPlayer播放格式化音频（C++）：介绍了如何指导开发者使用AVPlayer的Native API实现播放格式化音频的功能。
• 基于SoundPool播放短音频：介绍了如何指导开发者使用SoundPool开发播放短音频功能。
• 概述：介绍了五个不同的音频格式和业务场景快速选型，并提供各个方案音频录制支持的能力对比。
• 基于AudioCapturer录制PCM音频（ArkTS）：介绍了基于AudioCapturer如何录制PCM音频，指导开发者基于不同的业务场景，使用AudioCapturer实现音频录制功能。
• 基于OHAudio录制PCM音频（C++）：介绍了基于OHAudio如何录制PCM音频，指导开发者实现基础录制。
• 基于AVRecorder录制格式化音频（ArkTS）：介绍了在ArkTS侧基于AVRecorder如何录制格式化音频，指导开发者实现基础录制。
• 基于AVRecorder录制格式化音频（C++）：介绍了在C/C++侧基于AVRecorder如何录制格式化音频，指导开发者实现基础录制。
• 基于AVScreenCapture录制音频：介绍了如何基于AVScreenCapture录制音频，指导开发者实现基础录制。

性能

• 高性能Protobuf解析：介绍了以TurboTransProtobuf框架为核心，围绕Protobuf序列化和反序列化的典型场景，包括其使用要点及性能优势。

[h2]优化文档

优化文档3篇。

媒体

• 基于AudioRender播放PCM音频：新增低功耗音频播放场景。

一次开发，多端部署

• 响应式布局：新增断点环境介绍。

行业场景解决方案

• 视频类应用横竖屏切换：由横竖屏切换文章优化生成，新增通过页面跳转实现横竖屏切换章节。

2026年1月

[h2]新增文档

新增文档10篇。

主题与样式

• 基于colorFilter实现图片滤镜效果：介绍了如何基于原始图像，使用colorFilter属性实现复古、反色、增强饱和度及美白等常见滤镜效果，并详细解析colorFilter的4x5 RGBA转换矩阵和颜色滤波器两种使用方式。
• 基于resizable实现图片拉伸效果：介绍了如何使用resizable属性实现图片拉伸效果，例如聊天消息气泡和可拉伸占位图两个典型场景。

媒体

• 基于AudioRender和AudioCapturer实现音频波形动画：介绍了如何基于AudioRender和AudioCapturer实现音频波形动画，例如实现音频播放和音频录制的波形。
• 管理音频输入设备开发实践：介绍了音频输入设备的管理，指导开发者实现获取输入设备信息、切换输入设备、响应设备变更等场景，并提供开发过程中常见问题的解决方案。
• 基于Audio能力实现音频耳返：介绍了如何基于AudioLoopback和OHAudio实现音频耳返。

图形

• 图像模糊卡顿问题分析：介绍了图像模糊卡顿问题检测、分析和优化方案。

一次开发，多端部署

• 多设备适配屏幕差异：介绍了如何适配多设备屏幕差异和如何适配折叠设备屏幕。

行业场景解决方案

• 基于媒体能力实现直播连麦功能：介绍了客户端开播侧的音视频流解码播放技术实现方案。

测试框架

• 自动化测试框架开发实践：介绍了单元测试框架和UI测试框架的实现，旨在帮助开发者了解和掌握自动化测试框架的开发流程与实现细节。

性能

• 并行化性能优化：介绍了如何使用TaskPool和Sendable来进行并行化改造，从而提升性能。

[h2]优化文档

优化文档5篇。

媒体

• 自定义相机拍照：新增使用音量键拍照章节和使用音量键拍照的开发步骤。
• HDR Vivid视频播放与录制开发实践：由HDR Vivid视频录制、播放与转码文档拆分生成。
• HDR Vivid视频转码SDR视频开发实践：由HDR Vivid视频录制、播放与转码文档拆分生成。

性能

• 运行效率提高：新增路径展开实践场景。
• 操作延时触发：新增模块化lazy-import、动态import实践场景。

[h2]删除文档

删除文档1篇。

媒体

• 生态应用相机实现系统级相机体验：本文针对三方相机开发场景，基于HarmonyOS提供的相机开放能力，实现系统相机级别的效果和能力，比如分辨率、动图、视频防抖、连续变焦等。

2025年12月

[h2]新增文档

新增文档7篇。

应用框架

• Web组件拦截能力的使用：介绍三种基于Web组件的拦截方案，并提供各方案在典型应用场景中的实例，帮助开发者更好地掌握ArkWeb拦截能力的选择和使用。

媒体

• 音质切换开发实践：介绍了音质切换功能的实现，如何在AVPlayer和AudioRenderer之间实现切换播放。
• 图片合成视频开发实践：以图库图片合成视频场景为例，介绍了图片解码、图片数据编码、视频生成的主要步骤，并给出开发过程中常见问题的分析思路和解决方案。

应用安全

• ArkWeb组件安全开发：介绍了在安全的Web资源访问、恰当的权限管控、确保敏感数据传输安全三种典型开发场景下，如何系统性提升应用的整体安全水平。

性能

• 高性能JSON解析：介绍了围绕JSON序列化和反序列化的典型场景，包括TurboTransJSON框架的使用要点及性能优势。
• JsLeakWatcher开发实践：本文介绍如何使用JsLeakWatcher工具检测js对象泄漏。
• 内存泄漏定制能力开放使用指导：本文介绍如何使用MallocDispatchTable进行内存泄漏维测。

[h2]优化文档

优化文档6篇。

网络

• 低功耗蓝牙基础使用：新增了BLE扫描过滤器的使用，新增自动重连功能，新增常见问题说明，优化了蓝牙数据传输部分的交互流程以及接口调用的前后顺序说明。

媒体

• 音画同步：新增音画同步功能开发流程图、新增音画同步本地视频，网络视频，录制视频三种开发场景介绍。
• 自定义相机预览：新增预览人脸检测章节，介绍了预览流人脸检测信息。

一次开发，多端部署

• 多设备工程部署与发布：优化DevEco的版本截图和新增多设备工程部署的注意事项。
• 窗口沉浸式：新增自由窗口标题栏沉浸示例。
• 音频焦点管理解决方案：新增应用内多音频流焦点处理章节，新增移动端和电脑端音频焦点默认策略差异介绍，短视频滑动漏音增加代码介绍。

2025年11月

[h2]新增文档

新增文档1篇，为图形模块。

图形

• 基于Canvas实现录像回放时间轴：介绍了如何实现TimeBarView时间轴组件，并结合“滑动时间轴控制视频播放”的核心场景，阐述TimeBarView组件的使用方法。

[h2]优化文档

优化文档3篇。

媒体

• HDR Vivid视频录制、播放与转码：HDR转码SDR补充原理说明，新增AVCodec转码。

一次开发，多端部署

• 页面布局场景：合并《分栏布局》、《分级导航》内容，增加类小红书方案，聊天详情页到商品链接页跳转，并实现从双栏显示修改为单栏显示的最佳实践方式。
• 多设备股票类界面：重写文档，从概述、UX设计、工程管理、窗口适配、界面开发、自选股页面、股票详情页方面介绍多设备股票类界面应用。

[h2]删除文档

删除文档2篇。

一次开发，多端部署

• 分栏布局：优化文档标题名称，新增常见问题章节——如何实现应用在手机设备竖屏状态下单栏显示，横屏状态下双栏显示？
• 分级导航：本文提供分级导航栏的多端适配方案及指导，解决一多开发实现导航栏内的分级效果问题。

2025年10月

[h2]新增文档

新增文档2篇，为媒体和全场景协同。

媒体

• 基于Surface模式进行视频编码：介绍了通过NativeWindow来传递编码的输入数据，使用AVCodec提供的视频编码能力实现视频编码的过程。

全场景协同

• 隔空传送快速分享：介绍应用如何实现隔空传送分享文件与链接。

[h2]优化文档

优化文档2篇。

一次开发，多端部署

• 多设备交互：重新优化了多设备交互大纲设计，增加多种交互设备交互方式。

多端设备支持

• 智能穿戴应用开发：优化了目录结构，重构文档大纲。

2025年9月

[h2]新增文档

新增文档13篇，为组件封装与复用、应用框架、媒体、布局与弹窗、全场景协同、多端设备支持和行业场景解决方案。

组件封装与复用

• 组件复用问题诊断分析：以列表组件为例，介绍组件复用常见问题的分析与解决方案。

应用框架

• Web页面跨域解决方案：介绍了基于ArkWeb拦截器和Cookies管理能力实现Web页面跨域，快速解决实际项目中的跨域难题。

网络

• 多网并发网络加速：介绍了多网并发的机制原理与基本开发流程，结合大文件分片传输和多文件并发传输两个实际应用场景介绍多网并发能力的适配方案。

媒体

• 基于AVPlayer基础播控实践：介绍了如何基于AVPlayer系统播放器实现视频播放、暂停、跳转播放、静音播放、循环播放、窗口缩放模式设置、倍速设置、音量设置等基本开发场景。
• 基于AVPlayer播放长视频实践：介绍了如何基于AVPlayer系统播放器实现长视频播放。
• 基于AVPlayer播放短视频实践：介绍了如何实现基本播控能力、焦点管理、前后台感知、横竖屏切换和旋转感知和短视频列表流畅切换场景。
• 基于AVPlayer播放嵌入式短视频实践：介绍如何基于AVPlayer系统播放器实现嵌入式短视频播放。
• 基于AVPlayer播放网络视频：介绍如何基于AVPlayer系统播放器实现网络视频播放。
• 渲染视频画面：介绍了视频解码后渲染视频画面的三种方式，包括基于XComponent渲染、基于OpenGL渲染和基于Vulkan渲染。

布局与弹窗

• 实现富文本编辑器：介绍了如何使用RichEditor组件，在内容发布场景中实现自定义表情、@好友、添加话题等功能，并提供示例代码详细拆解细节逻辑，如@好友如何被视为一个整体，编辑器中内容如何获取并归一化处理等。

全场景协同

• 音频投播：介绍了如何高效利用系统投播组件和接口实现音频投播。

多端设备支持

• 智慧屏应用开发：介绍了Mate TV智慧屏的设备特点、参数、设计规范、窗口、界面、功能开发等。

行业场景解决方案

• 基于媒体能力实现直播单播功能：介绍了如何基于系统的媒体底座能力实现媒体直播系统的解决方案。包括开播端的音视频采集与编码、看播端的流媒体播放与音画同步等技术方案。

[h2]优化文档

优化文档6篇。

多端设备支持

• 三折叠应用开发：优化原有大纲结构，新增硬件说明、相机参数说明以及常见问题，增加了XTs的部分内容。
• 电脑应用开发：在原有的PC/2in1文档的基础上优化重写，介绍电脑设备特点，参数，设计规范，和窗口、界面、功能开发等。

性能

• 点击响应时延分析：新增使用AppAnalyzer工具检测和分析点击响应时延。
• 点击完成时延分析：新增使用AppAnalyzer工具检测和分析点击完成时延。
• 应用冷启动时延优化：新增章节应用冷启动时延检测与分析，介绍了体检工具AppAnalyzer检测应用冷启动时延的操作步骤及问题分析。
• 图片资源加载优化：新增非预置图片资源加载优化章节等内容。

2025年8月

[h2]新增文档

新增文档5篇，包括布局与弹窗和多端设备支持。

布局与弹窗

• 富文本显示的选型与开发：介绍了高亮显示的超链接文本、自定义表情、图标与文本的组合元素、自定义的图文元素四个场景的富文本信息的效果实现。

网络

• 网络信息查询与连接管理：介绍了常用的网络信息查询与连接管理功能实现，包括获取网络类型、检查网络可用性、监听网络状态变化、查询Wi-Fi及蜂窝网络信息等

多端设备支持

• MateBook Fold折叠电脑应用开发：介绍了折叠电脑的设备特点、参数、设计规范、窗口、界面、功能开发等。

全场景协同

• 跨设备剪贴板：介绍了跨设备剪贴板如何通过全场景协同能力同步剪贴板内容，实现手机、PC/2in1、平板等设备间的无缝数据互通。
• 碰一碰文件分享：介绍应用如何实现碰一碰文件分享。

[h2]优化文档

优化文档3篇。

一次开发，多端部署

• 分栏布局：优化文档标题名称，新增常见问题章节——如何实现应用在手机设备竖屏状态下单栏显示，横屏状态下双栏显示？

多端设备支持

• 平板应用开发：整篇文档内容优化，介绍了平板设备特点、参数、设计规范、窗口、界面、功能开发等。
• 双折叠应用开发：整篇文档内容优化，介绍了折叠屏设备特点、参数、设计规范、窗口、界面、功能开发等。

2025年7月

[h2]应用质量目录结构变更

[h2]新增文档

新增文档50篇，包括布局与弹窗、主题与样式、媒体、应用质量概览、性能、功耗和稳定性。

布局与弹窗

• 常见瀑布流操作：介绍了瀑布流常见操作，帮助开发者高效构建自己想要的瀑布流效果。
• 常见操作列表：介绍列表滚动、列表排版、列表数据更新、列表拖拽等常见功能，通过实现一个简单聊天列表的案例，来介绍常见列表操作以及对应的代码实现。
• Tabs选项卡常见开发场景：介绍了abs选项卡常见开发场景，包括多层嵌套的Tabs、自定义Tabs样式、Tabs数据加载和动态变更显示的Tabs等。
• 基于ScrollComponents实现网格：介绍了如何基于ScrollComponents实现网格，实现跨页面复用、加速首屏渲染、下拉刷新等场景。
• 基于ScrollComponents实现长列表：介绍了如何基于ScrollComponents实现长列表，实现组件高性能复用、分组布局复用、跨页面复用、加速首屏渲染、下拉刷新等场景。
• 弹窗组件封装：介绍了如何通过使用UIContext中获取到的PromptAction对象来实现自定义弹窗工具类的封装，来实现弹窗组件封装开发。

主题与样式

• 自定义字体设置：介绍了基于ArkUI提供的字体控制能力，如何实现自定义字体显示文本、自定义字体恢复为系统字体、字体大小跟随系统设置、字体大小不跟随系统设置等功能。

媒体

• 基于Buffer模式进行视频转码：介绍了视频编解码的基本概念、Buffer模式下的视频编解码原理，并详细介绍了视频转码的实现方案和开发步骤。
• 基于AVScreenCapture实现屏幕录制：介绍如何基于AVScreenCapture实现对屏幕的录制功能，主要包括三种实现方案：ArkTS侧录屏存文件，Native侧录屏存文件，Native侧录屏转码流。
• 自定义相机预览：介绍了自定义相机预览部分由基础到进阶的开发实践。
• 自定义相机拍照：以自定义相机为例，介绍基础拍照、参数配置、分段式拍照、HDR Vivid拍照以及动图拍摄等功能。
• 自定义相机录像：以自定义相机为例，介绍相机设备的创建与调用、录像的启动与停止、以及输出处理的完整流程。

应用质量概览

• 应用质量概览：介绍了DFX知识体系一站式地图，包括基础能力、场景化知识地图、常用术语和相关主题。

性能

• 内存基础知识：介绍了内存基础知识相关的术语定义、分配规则、内存布局等。
• 分析ArkTS/JS内存：介绍了应用ArkTS/JS内存的占用分析，包括如何基于IDE工具如何拆解内存占用。
• 分析native内存：介绍了应用native内存的占用分析，包括如何基于IDE工具如何拆解内存占用。
• 分析内核态内存：介绍了应用内核态内存的占用分析，包括如何基于IDE工具如何拆解内存占用。
• 分析任务执行超时问题：介绍了任务执行超时问题的分析方法。

功耗

• 场景功耗测试：介绍了开发态的功耗场景化检测方法。
• 功耗基础质量测试：介绍了开发态的功耗基础质量检测方法。
• 运行态功耗检测：介绍了运行态功耗检测方法，主要基于HiAppEvent订阅功耗领域相关系统事件。
• CPU高负载分析：介绍了CPU高负载分析方法，包括日志获取、分析思路和分析步骤。
• 前台不可见动效问题分析：介绍了前台不可见动效问题分析方法。
• Vsync低功耗优化：介绍了Vsync低功耗优化案例。
• Buffer低功耗优化：介绍了Buffer低功耗优化案例。

稳定性

• 地址越界检测能力概述：介绍了各种地址越界检测的检测工具优劣势和使用场景。
• 地址越界经典问题类型：介绍了地址越界典型问题类型，包括heap-use-after-free、stack-use-after-return和overflow。
• 地址越界检测工具原理：介绍地址越界类问题检测的底层原理，包括Asan检测原理、HWAsan检测原理、MemDebug检测原理和GWP-Asan检测原理。
• 适配常见问题：介绍应用在适配地址越界检测的常见问题。
• 地址越界类问题检测方法：介绍了基于HiAppEvent订阅地址越界的系统事件。
• 资源泄漏类问题检测方法：介绍了资源泄漏类问题中运行态检测的差异部分。
• 应用冻屏类问题检测方法：介绍了基于HiAppEvent订阅应用冻屏的系统事件。
• 应用崩溃问题检测方法：介绍了基于HiAppEvent订阅应用崩溃的系统事件。
• 应用被查杀问题检测方法：介绍了应用发生主线程堵塞和被系统管控查杀两种场景下因为SIGKILL信号导致的查杀的监控。
• 地址越界类问题分析方法：介绍了地址越界问题检测能力、地址越界问题定位分析思路。
• 资源泄漏类问题分析方法：介绍了资源泄漏问题的相关分析方法。
• 应用冻屏问题排查方法：介绍应用冻屏的问题的定位步骤与思路。
• CppCrash类问题分析方法：介绍了如何获取CppCrash日志、如何查看日志以及如何分析问题。
• JS Crash类问题分析方法：介绍了JS Crash类问题的问题定位思路和异常定位信息增强工具说明。
• 应用被查杀类问题分析方法：介绍了应用被异常查杀的日志获取与分析思路和分析步骤。
• 地址越界类问题优化建议：介绍了地址越界类问题的编码过程的优化建议。
• 资源泄漏类问题优化建议：介绍了内存泄漏问题优化建议、ashmem/ION泄漏问题优化建议、句柄泄漏问题优化建议和线程泄漏问题优化建议。
• 应用冻屏类问题优化建议：介绍了应用冻屏类问题的优化建议。
• CppCrash类问题优化建议：介绍了CppCrash类问题优化建议。
• JS Crash类问题优化建议：介绍了JS Crash类问题优化建议。
• 地址越界类问题案例：本文按照地址越界类问题分析方法的流程展开，以实际案例的形式指导开发者如何从CppCrash日志出发，分析、定位，修复地址越界问题。
• 资源泄漏类问题案例：本文按照资源泄漏分析方法的流程展开，以实际案例的形式指导开发者如何从泄漏维测日志出发，分析、定位具体泄漏点。
• 应用冻屏类问题案例：介绍了ThreadBlock类问题案例、APP_INPUT_BLOCK类典型案例、LIFECYCLE_TIMEOUT类典型案例和资源高负载类典型案例。
• CppCrash类问题案例：介绍了如何分析并修复CppCrash问题。
• JS Crash类问题案例：介绍了高频的JS Crash故障案例，包括TypeError类案例和Error类案例。

[h2]优化文档

优化文档17篇。

组件封装与复用

• 组件封装：补充常见问题，优化组件公共样式封装、自定义组件封装场景。

布局与弹窗

• 使用Swiper组件实现轮播图：在图文作品轮播的基础上优化实现轮播图的叠加效果场景，并新增两个常见问题。

应用框架

• 应用切面编程设计：优化了补充插桩统计调用次数和namespace相关内容

性能

• 启动耗时类问题检测方法：新增启动耗时类问题的运行态检测说明。
• 滑动丢帧类问题检测方法：新增滑动丢帧类问题的运行态检测说明。
• 主线程超时类问题检测方法：新增主线程超时类问题的运行态检测说明。

功耗

• 不可见组件低功耗建议：优化了案例、分析方法等。

稳定性

• 稳定性概览：针对稳定性章节结果变化，优化概览描述。
• 使用Asan检测内存错误：对部分检测配置进行更新。
• 使用HWAsan检测内存错误：对部分检测配置进行更新。
• 使用GWP-Asan检测内存错误：对部分检测配置进行更新。
• 稳定性故障类型及日志规格说明：对本章节的日志类型及规格，链接到指南对应章节，本章节不做具体介绍。
• APM能力建设：增加对当前支持的系统事件的链接，链接到指南相关章节。
• JS内存泄漏问题检测方法：新增JS内存泄漏问题检测方法文档，从原有资源泄漏问题检测章节拆分对应内容独立为一篇文章。
• Native内存泄漏问题检测方法：新增Native内存泄漏问题检测方法文档，从原有资源泄漏问题检测章节拆分对应内容独立为一篇文章。
• 文件句柄泄漏类问题检测方法：新增文件句柄泄漏问题检测方法文档，从原有资源泄漏问题检测章节拆分对应内容独立为一篇文章。
• 线程泄漏类问题检测方法：新增线程泄漏问题检测方法文档，从原有资源泄漏问题检测章节拆分对应内容独立为一篇文章。

[h2]删除文档

2025年6月

[h2]一次开发，多端部署目录结构变更

[h2]目录结构变更

变更背景

为了提升开发者的使用体验，对最佳实践的目录结构进行优化。按照界面、功能、多设备、AI、安全、质量等维度对最佳实践文档进行重新分类。

变更内容

最佳实践结构目录优化调整：全文由架构设计、功能开发、工具使用和文档变更说明四个类型拆分为架构设计、界面开发、功能开发、多设备开发、AI使能、应用安全、应用质量、工具使用和文档变更九大类。变更前后如下图所指示。

变更效果

图1 最佳实践目录变更前后对比

[h2]新增文档

新增文档32篇，包括概览、组件封装与复用、布局与弹窗、应用服务、一次开发，多端部署、全场景协同、多端设备支持、行业场景解决方案和AI使能。

概览

• 最佳实践概览：介绍了最佳实践的八大架构内容简介，引导开发者快速查找所需内容。

组件封装与复用

• 组件复用：介绍了同一列表和多个列表内组件复用开发场景，帮助开发者更好地理解复用机制，进而优化应用性能。

布局和弹窗

• 文本展开折叠：介绍了如何使用系统自带模块，实现纯文本和富文本的展开、折叠功能。
• 自定义弹窗选型与开发：介绍了弹窗的基本类型、不同类型弹窗的特性、主要推荐的弹窗类型及能力支持情况、弹窗的使用建议等内容。
• 基于ScrollComponents实现瀑布流：介绍了基于ScrollComponents实现瀑布流的原理、使用场景及实现步骤。

应用服务

• 锁屏沉浸实况窗：介绍了锁屏沉浸实况窗的实现原理和场景开发。

一次开发，多端部署

• 一次开发，多端部署概览：介绍了“一次开发，多端部署”（后文中简称为“一多”）的定义、目标等，同时从体验设计、页面开发、功能开发等角度，端到端的给出了指导，帮助开发者快速开发出适配多种类型设备的应用。
• 从一个例子开始：通过一个天气应用，介绍一多应用的整体开发过程，包括UX设计、工程管理及调试、页面开发等。
• 多设备体验设计：介绍了如何设计支持一多的应用开发。
• 窗口模式：介绍了如何在多设备窗口模式下进行开发，包括全屏、分屏、自由悬浮窗口。
• 窗口方向：介绍了窗口的概念、使用场景、开发案例和常见问题。
• 布局概述：介绍了什么是自适应布局和响应式布局。
• 响应式布局：介绍了实现响应式布局的四种响应式布局能力，以及如何实现响应式布局效果。
• 页面布局场景：从页面布局场景的角度，通过对应的典型布局场景演示不同横向断点下界面的展示效果，介绍如何在多设备上实现跨端布局开发。
• 组件布局场景：介绍了响应式组件中常用的属性如何在一多适配体系中动态调整，以适应不同的显示需求。
• 窗口沉浸式：介绍沉浸式开发的实现原理，并分析在多设备场景下不同窗口形态（全屏、分屏、悬浮窗、自由窗）和窗口方向下的适配问题和解决方案。
• 屏幕类型布局场景：介绍了不同屏幕类型维度开发多设备界面时常用的响应式布局方法。
• 自适应布局：介绍了针对常见的开发场景，方舟开发框架提炼的七种自适应布局能力，包括拉伸能力、均分能力、占比能力、缩放能力、延伸能力、隐藏能力和折行能力。
• 相机硬件差异：介绍如何将手机相机页面（含预览、拍摄和查看照片功能）适配至双折叠、阔折叠、三折叠和平板等多种设备形态。
• 多设备资源文件：介绍了应用资源和系统资源对颜色、字体、间距、图片等资源的处理方式。
• 多设备设置界面：介绍如何使用自适应布局能力和响应式布局能力适配不同尺寸窗口。
• 多设备功能开发：介绍应用如何解决设备系统能力差异的兼容问题。
• 多设备工程部署与发布：介绍如何使用DevEco Studio进行多设备应用开发。

全场景协同

• 社交通讯全场景协同最佳实践：介绍如何通过应用接续功能（实现不同设备间的快速切换）和跨设备互通功能，提升内容发布的便利性。
• 视频投播：介绍如何高效利用系统投播组件和接口实现视频投播，帮助开发者提升开发效率。
• 碰一碰视频分享：介绍了在视频分享场景中，如何实现碰一碰快速分享视频的原理与开发步骤。
• 智能穿戴导航协同：介绍了手机与智能穿戴设备通过通信协作实现地图导航的技术方案，主要包含了智能穿戴设备协同导航的体验设计、方案设计、界面开发及功能开发。

多端设备支持

• 智能穿戴应用开发：介绍了智能穿戴设备的体验标准、界面开发和功能开发，分析其开发过程中的关键问题，并提出优化建议与解决方案，以提升用户体验。

行业场景解决方案

• 全屏短视频自适应缩放和沉浸：介绍adaptive_video支持的短视频页面开发适配场景。
• 阅读器翻页效果：介绍了上下翻页、覆盖翻页和仿真翻页的实现原理和开发步骤。

AI使能

• 智能体场景开发案例：介绍如何基于智能问答场景和音频播放场景，在小艺智能体平台上快速搭建智能体并适配相应需求场景。
• 基于RAG框架实现邮件智能问答：介绍了知识库构建、LLM部署与调用和RAG会话如何实现以及如何基于RAG框架实现邮件系统的智能问答。

[h2]删除文档

删除文档7篇。

全场景协同

• 应用接续提升内容发布体验：该文档内容已并入社交通讯全场景协同最佳实践中。

应用框架

• 组件复用场景与方法详解：该内容已并入组件复用中。
• 全局自定义组件复用实现：该内容已并入组件复用中。

网络

• 基于RCP的网络请求开发实践：该内容已并入指南。
• 网络管理与状态监听开发实践：该内容已并入指南。

一次开发，多端部署

• 一多断点开发实践：文档内容优化，由响应式布局替换
• 一多窗口适配：文档内容优化，由窗口模式、窗口方向、窗口沉浸式三篇替换

2025年5月

[h2]新增文档

新增文档9篇，包括核心技术理念、特性解决方案、应用框架和图形。

核心技术理念

• 多设备游戏界面：介绍“一多”游戏类应用在开发过程中的关键场景实现方案，包括如何从U型设计、页面开发两个角度实现手机、平板和折叠屏三种形态的功能开发。

特性解决方案

• 三折叠应用开发：介绍了如何从体验标准、窗口适配和典型布局场景三个角度实现三折叠的开发事项。
• 平板应用开发：从布局设计、窗口适配和交互体验三个方面介绍开发平板应用过程中的常见问题，并提供推荐的解决方案或开发指导，以满足用户的最佳体验。
• 电脑应用开发：从布局设计、窗口适配、交互体验和特殊事项四个方面介绍开发PC/2in1应用时的常见问题，并提供推荐的解决方案或开发指导，以确保最佳用户体验。

应用框架

• 应用间跳转实践概览：介绍应用间跳转的常用场景和分类。以社交分享跳转、广告跳转、特殊文本识别跳转3种典型场景为例，介绍了如何使用应用间跳转提升用户体验。
• 社交分享跳转：介绍了如何通过App Linking技术实现社交分享的智能跳转逻辑、直达应用市场和延迟链接优化跳转体验。
• 广告跳转：介绍了利用App Linking技术实现广告跳转的完整流程，包括从广告展示到应用或网页的高效拉起，以及如何处理未安装应用情况下的延迟跳转。
• 特殊文本识别跳转：介绍了如何在社交应用中通过识别并标记文字中的特殊文本（如链接、日期、电话号码等），来实现自动跳转相关应用。

图形

• 图像模糊高效使用：介绍背景模糊技术在应用场景中的高效应用方法。

[h2]删除文档

删除文档2篇。

特性解决方案

• 平板和PC/2in1开发实践：将原来的一篇文章拆分成平板与PC/2in1两篇。

应用框架

• 应用间跳转场景开发实践：该文档已拆分优化为应用间跳转实践概览、社交分享跳转、广告跳转、特殊文本识别跳转四篇。

2025年4月

[h2]新增文档

2025年3月

[h2]新增文档

新增文档2篇，包括特性解决方案和应用质量。

特性解决方案

• 阔折叠/阔直板应用开发：介绍了如何在应用程序中实现手机分屏功能。包括手机分屏功能的适用场景、实现原理等内容。

应用质量

• 不可见组件低功耗建议：介绍了如何优化应用程序以减少设备功耗的建议和指导。

[h2]删除文档

删除文档2篇。

特性解决方案

• 手机上下分屏开发实践：介绍如何在手机上实现应用的分屏显示，包括分屏模式的概念、分屏模式的适配要求、分屏模式的开发流程以及分屏模式的测试方法等内容。

应用质量

• 使用UBSan检测未定义行为：介绍了使用ubsan（Undefined Behavior Sanitizer）进行代码检测的方法和技巧。

2025年2月

[h2]目录结构变更

变更背景

为了更好地满足开发者在不同阶段的多样化需求，提升开发者的使用体验，对最佳实践目录结构进行了优化调整。最佳实践的目录结构从按照功能领域进行划分，优化为按照开发者旅程的维度进行分类。

无论是初学者还是有经验的开发者，都能够依据自身的开发进程快速定位到所需的最佳实践内容，更加直观地获取全面的指导信息，从而提高开发效率，加速HarmonyOS项目的开发进程。

变更内容

为了提升开发者的使用体验，对最佳实践的目录结构进行优化。

最佳实践结构目录优化调整：全文分为架构设计、功能开发、工具使用和文档变更说明四个类型。为给予开发者更好的文档阅读和使用体验，最佳实践按照架构设计、功能开发和工具使用三大类重新编排目录。变更前后如下图所指示：

变更效果

通过此次变更，实现了以下效果：

• 与开发指南和API文档架构相互对应，使得开发者能够快速定位所需文档位置，提高查找效率。
• 增加业务类型分类，使得最佳实践内容架构更加清晰，可有效降低开发者文档查找混乱，难以查询到所需文档的问题。
• 增加文档变更节点，使开发者可以明确感知到最佳实践文档的所有变更，包括文档新增、下线等，帮助用户了解最佳实践的发展历程。

[h2]新增文档

新增文档2篇，包括媒体和文档变更说明。

媒体

• 图片获取与保存实践：介绍HarmonyOS上常见的获取图片的方式、获取后读取图片信息、以及将图片保存在本地的操作。

文档变更说明

• 最佳实践文档变更说明：以月为维度，汇总最佳实践文档更新下架或架构变更信息，提升开发者内容更新感知。

[h2]删除文档

删除文档2篇。

应用质量

• 符号表归档：介绍release模式下调试信息文件的归档配置、路径等内容。

应用架构

• 应用导航设计：介绍应用程序导航设计的相关内容。内容涵盖了导航结构的设计、导航元素的选择和布局、导航交互的设计等方面。

2025年1月

[h2]新增文档

2024年12月

[h2]新增文档

新增11篇文章，包括HarmonyOS特征、业务场景与解决方案、功耗性能、安全和功能开发模块。

HarmonyOS特征

• 折叠屏悬停态：介绍折叠屏悬停态的三种实现方式，并根据其特点给出各自的适用场景。包括FoldStack、FoldSplitContainer和自定义实现悬停态。
• 多设备交互：介绍一多开发过程中涉及到的常见交互事件，包含系统已提供默认实现的交互归一事件适配，以及需要开发者自行进行设计与代码实现的交互操作：焦点导航事件适配、键盘快捷键事件适配。
• 统一拖拽：介绍几种典型拖拽场景及其具体实现方案，包括拖拽图像增加水印、自定义拖拽背板图、AI识别拖拽内容、分屏拖拽、跨设备拖拽和拖入小艺和中转站。

业务场景与解决方案

• 音乐服务卡片：介绍了以音乐服务卡片场景为例，如何实现音乐播控、歌单推荐、心动歌词三种服务卡片，包括卡片设计和功能开发，以及开发中常见的一些问题。

功耗性能

• 高效利用HWC的低功耗设计：介绍如何使系统能够充分发挥HWC的能效优势，降低对应操作场景的功耗，提升操作流畅性。

安全

• 加解密跨平台数据兼容性：介绍数据编码格式差异以及加解密算法使用差异导致加解密失败的可能原因，并提供相应的解决方案。

功能开发

• 一镜到底动效：介绍一镜到底的实现原理和两个典型场景案例。
• 卡片更新与数据交互：介绍如何在应用程序中实现卡片更新和数据交互的指导和建议。
• 相机预览花屏解决方案：介绍相机预览花屏的实现原理、场景案例。效果比对和常见问题，并提供相应的示例代码，助力开发者高效解决问题。
• 多线程操作密集型关系型数据库和文件读写：介绍如何使用多线程操作密集型关系型数据库和文件读写，包括TaskPool和Sendable的实现原理和使用方法。

2024年11月

[h2]性能目录结构优化

变更内容

• 优化“性能分析”章节，拆分部分内容到“性能最佳实践导读”和“性能检查”章节。
• 优化“性能分析”和“性能优化”目录结构，精细化子目录分类。
• 原“常见性能优化场景”章节更名为“性能场景优化案例”，修改文档标题，提升查找的准确性和效率。
  图3 最佳实践性能目录变更对比
  

[h2]新增文档

新增29篇文章，包括性能、安全、功能开发和工具开发模块。

开发工具

• 定制hvigor插件：介绍如何使用hvigor插件开发自定义功能，包括插件的基本结构、开发流程、插件的注册和调用等。
• 多目标产物构建：介绍多目标应用开发的相关内容。包括如何设计和构建多目标应用、如何处理不同目标设备的适配和优化、如何处理多目标应用的资源管理等方面的内容。

[h2]优化文档

[h2]删除文档

2024年10月

[h2]归一化模板

针对系统级解决方案和场景化解决方案进行重新设计。从本期开始，新增的最佳实践内容均会采用新的内容结构进行呈现。存量内容会在后续陆续进行完成优化。

[h2]新增文档

新增文档29篇，包括HarmonyOS特征、性能、功耗、安全、功能开发和工具开发。

HarmonyOS特征

• 分栏布局：介绍如何使用多列布局来创建响应式网页，涵盖了使用CSS Grid和Flexbox等技术来实现多列布局的方法，并提供了一些常见的布局模式和技巧。
• 应用接续提升内容发布体验：介绍在开发应用程序时，如何正确地管理和释放应用程序与其他设备或服务之间的连接，以提高应用程序的性能和稳定性。

性能

• Web加载完成时延分析：介绍Web页面的加载流程及关键Trace点、性能分析工具、加载完成时延分析方法、并总结了常见导致加载完成时延过高的原因与解决方案。
• 图片资源加载优化：介绍纹理压缩的概念、原理和优势，并提供了一些在开发过程中使用纹理压缩的最佳实践建议。通过使用纹理压缩，开发者可以减少纹理资源的大小，提高应用程序的性能和加载速度。

功耗

• 音乐播放场景低功耗规则：介绍在华为设备上实现高质量音乐播放的最佳实践，包括音频焦点管理、音频输出选择、音频格式支持、音频播放控制等方面的内容。
• 导航定位场景低功耗规则：介绍如何实现低功耗的导航场景，包括实现的规则、开发步骤和调测验证。
• 静态场景低功耗规则：介绍如何在静态场景下实现低功耗，包括实现的规则、开发步骤和示例场景。
• 视频场景编解码低功耗规则：介绍如何在视屏场景编解码中实现低功耗，包括实现的规则、开发步骤和调测验证。
• 视频场景弹幕绘制低功耗规则：介绍视频弹幕的最佳实践方法。文档中包含了视频弹幕的定义、特点以及在不同场景下的应用案例。此外，文档还提供了视频弹幕的实现步骤和技术要点，帮助开发者更好地理解和应用视频弹幕技术。
• 视频场景ROM低功耗建议：介绍视频场景ROM（Read-Only Memory）如何实现低功耗的建议，包括设计原则、开发流程、测试。
• 视频场景图层低功耗建议：介绍视频场景图层功能如何实现低功耗的建议，包括设计原则、开发流程、测试。
• 视频场景Wi-Fi加载低功耗建议：介绍视频场景Wi-Fi加载功能如何实现低功耗的建议，包括开发流程和调测验证。
• 网络资源低功耗建议：介绍网络资源下载如何实现低功耗的建议和开发流程。

安全

• 应用权限申请：介绍在开发过程中如何正确处理和申请权限，以确保应用程序的安全性和用户体验。

功能开发

• 应用间跳转场景开发实践：介绍ArkTS页面拉起已安装应用的相关场景，包括拉起指定应用、拉起指定应用并获取返回结果、拉起指定类型应用、拉起系统应用。
• Web和应用的跳转与拉起：介绍ArkWeb页面跳转以及拉起应用相关的知识，包括ArkWeb页面与ArkTS页面互相跳转、ArkWeb页面指定应用跳转、ArkWeb页面指定类型跳转和ArkWeb页面跳转系统应用页面。
• Native侧实现文件访问：介绍三种Native侧访问文件的实现方案，包括访问应用沙箱内文件、访问应用资源文件和访问系统公共目录文件。
• 组件复用场景与方法详解：介绍组件复用的场景和方法。详细说明了什么是组件复用，为什么要进行组件复用，以及如何在开发过程中实现组件复用。
• Image白块解决方案：介绍如何应用沙箱提前缓存，减少Image白块出现时长的优化方案。
• 使用Swiper组件实现轮播图：介绍如何通过Swiper组件来动态展示图片，实现图文作品合集轮播和实现轮播图片叠加的效果。
• 评论回复弹窗：介绍弹窗组件的选型以及最终方案、软键盘和表情面板切换的适配、和编辑区域主要细节功能这三种评论列表上层弹出的场景实现。
• 常见导航样式案例：介绍如何在应用程序中使用底部、顶部和侧边多标签功能，以提供更好的用户体验和功能。
• 智慧多窗：介绍悬浮窗/分屏布局适配方案，以及智慧多窗开发过程中的一些常见问题以及解决方案，来帮助开发者快速适配智慧多窗布局开发，提升用户使用体验。
• 网络管理与状态监听开发实践：介绍网络管理中网络连接管理、网络信息查询和网络状态监听等。帮助开发者了解网络管理中常用的查询方式和如何进行网络状态变化的监听。
• 视频播放：介绍如何基于HarmonyOS能力快速实现视频播放应用。
• 在线视频播放卡顿优化：介绍如何解决在线视频播放过程中可能遇到的卡顿问题。
• 音画同步：介绍如何通过第三方视频播放应用正确获取并使用音频相关信息来保证播放时的音视频同步。
• 水印添加：介绍水印添加的基本原理以及掌握开发的流程与细节。包括页面上添加水印、图片上添加水印和PDF文档添加水印。

开发工具

• 使用lycium工具快速编译三方库：介绍如何在Linux环境下，使用lycium工具通过ohos sdk快速编译openssl三方库源码。

[h2]删除文档

删除文档1篇。

业务场景与解决方案

• 阅读器翻页效果实现

2024年9月

[h2]新增文档

新增文档7篇，包括HarmonyOS特征、功能开发和开发工具。

HarmonyOS特征：

• 多设备断点开发实践：介绍如何通过横向断点和纵向断点，让开发者可以结合窗口宽度与高度两个维度去适配HarmonyOS的1+8设备，解决多设备UX布局问题。通过该方法，开发者无需关注设备类型，即可达到多设备的自适应UI布局效果。

功能开发：

• 高负载场景分帧渲染：介绍如何在转场场景和滑动场景中实现高负载组件渲染的方法。包括实现原理、解决思路和开发步骤等。
• 相机分段式拍照性能优化：介绍如何在相机Shot2See场景中实现分段式拍照Shot2See的完成时延低于单段式拍照。
• 音频播放交互场景：介绍在音乐播放器应用中，如何从应用与用户、播放设备以及其他应用的交互三方面入手，为应用带来灵活多样、符合用户直觉的交互体验的示例方案。
• Drawing自绘制性能提升：介绍如何通过绘图能力来提高性能的方法。文档中详细解释了绘图能力的重要性，以及如何使用绘图能力来优化应用程序的性能。

• 意图框架习惯推荐场景：介绍如何通过意图接入来开发“音乐播放”场景。

开发工具：

• Configure构建工程配置HarmonyOS编译工具链：介绍如何使用Configure构建工程配置HarmonyOS编译工具链，包括Configure构建三方库适配流程、环境准备和编译三方库。

[h2]删除文档

删除文档1篇。

功能开发

• 瀑布流页面滑动性能解决方案

2024年8月

[h2]新增文档

新增13篇文章，包括HarmonyOS特征、业务场景与解决方案、性能、安全、功能开发和工具开发模块。

HarmonyOS特征

• 多设备商务办公界面：介绍“一多”在实际开发中的应用。主要包含入口、备忘录、笔记汇总、笔记、日历等典型页面，并分别从UX设计、架构设计、页面开发三个角度给出推荐的参考样例。

业务场景与解决方案

• 在线短视频流畅切换：介绍在应用程序中实现平滑切换的最佳实践和技巧。它涵盖了平滑切换的定义、原则和目标，以及在设计和开发过程中应该考虑的关键因素。

性能

• 调优工具合集：介绍调优的工具集合。
• 点击完成时延分析：介绍点击完成时延相关分析工具，点击完成时延问题定位流程以及常见问题根因分析。
• 跨线程序列化耗时问题分析：介绍如何使用DevEco Studio新增主线程序列化和反序列化检测能力分析跨线程序列化耗时问题，包括工具介绍和案例分析。

功能开发

• 全局自定义组件复用实现：介绍全局自定义组件的重用。文档中详细说明了如何创建和使用全局自定义组件，以及如何在不同页面之间共享和重用这些组件。通过使用全局自定义组件，开发者可以提高代码的复用性和可维护性，从而加快应用开发的速度。
• 瀑布流页面滑动性能解决方案：介绍瀑布流页面滑动相关的性能优化解决方案。
• 基于HMRouter的页面跳转：介绍HMRouter路由框架的使用，包括页面跳转、弹窗提示、转场动效、数据加载、维测场景等。
• 软键盘布局适配：介绍软键盘的弹出收起和监听、软键盘避让机制和软键盘避让常见问题，以帮助开发者了解软键盘的弹出和收起的控制、避让机制以及软键盘常见问题的解决方法。
• 同层渲染原生组件：介绍什么是同层渲染，Web组件首次加载原生组件的方案比对和性能收益比对和列表滑动场景性能收益比对。

• 马良GPU渲染优化：介绍如何在马良（Maleoon）GPU上达到最佳的性能表现，只针对Maleoon GPU的优化实践，帮助开发者高效完成渲染任务。

开发工具

• CMake构建工程配置HarmonyOS编译工具链：介绍如何在Linux环境下，使用CMake构建工具通过ohos sdk编译cJSON三方库源码，生成ohos平台三方库的so及二进制文件。
• Make构建工程配置HarmonyOS编译工具链：介绍如何在Linux环境下，使用Make构建工具通过ohos sdk编译bzip2三方库源码，生成ohos平台三方库的so及二进制文件。

[h2]删除文档

删除文档1篇。

功能开发

• 使用AOT进行性能优化

2024年7月

[h2]新增文档

新增11篇文章，包括业务场景与解决方案、性能、运维和功能开发模块。

业务场景与解决方案

• 折叠屏应用开发：介绍折叠屏的概述、UX体验标准、应用开发指导和多设备的应用案例等。

性能

• Web点击响应时延分析：介绍如何通过分析点击响应延迟来优化网站性能，提高用户体验。包括点击响应延迟的定义、影响因素以及如何进行分析和优化。

• Swiper组件加载丢帧优化：介绍Swiper性能优化的相关方法。包括懒加载、缓存数据项、提前加载数据和组件复用等。

运维

• 崩溃监测实践：介绍如何使用HiAppEvent订阅崩溃事件和使用HarmonyOS开发者中心崩溃服务进行崩溃监测。
• 应用埋点：介绍如何进行应用埋点开发，包括埋点分类、埋点方案介绍、如何上传埋点数据等。

功能开发

• 高负载场景线程优先级设置：介绍在开发过程中如何合理地设置线程的优先级，以提高应用程序的性能和稳定性。通过调整线程的优先级，可以确保关键任务得到优先处理，从而提高应用的响应速度和用户体验。
• 主线程耗时操作优化：介绍开发过程中常见的冗余操作，常见的高频回调场景以及其他主线程优化思路。
• 自定义弹窗选型与开发：介绍自定义对话框开发的实践方法。提供了详细的步骤和示例，帮助开发者了解如何使用开发工具和技术来创建自定义对话框。
• 手势事件冲突解决方案：介绍手势触发的基本流程，执行原理、如何响应手势事件、如何解决冲突问题等。主要包括事件响应链收集、手势响应优先级、手势响应控制和常见手势冲突问题。

• 基于RCP的网络请求开发实践：介绍RCP与HTTP的区别，如何使用RCP实现基础的网络请求、多表单提交、双向证书校验、DNS的相关设置、请求与响应拦截和捕获有关HTTP请求/响应流。

• 图像模糊动效优化：介绍如何在模糊场景下进行的性能优化，内容包括了对模糊场景的定义和分类，以及在这些场景下的性能优化技巧和注意事项。

2024年7月12日

[h2]新增文档

新增16篇文章，包括HarmonyOS特征、业务场景与解决方案、功耗和功能开发模块。

HarmonyOS特征

• 多设备便捷生活界面：本文分别从UX设计、架构设计、页面开发三个角度给出符合“一多”的参考样例，介绍“一多”便捷生活应用在开发过程中的最佳实践。

业务场景与解决方案

• 阅读器翻页效果实现：已下架。
• AI辅助图文内容编创：介绍主要实现社交通讯类应用的图文内容编创流程，在该过程中接入自由流转、服务互动等HarmonyOS特性能力。
• 快捷骑行体验：介绍共享租赁、即时配送等应用场景的解决方案，以共享单车为案例，如何使用实况窗、地图导航、原生扫码等技术，为消费者的整个骑行流程带来更好的体验。

功耗

• 后台任务合理使用：介绍在应用程序中使用后台任务的重要性和好处，并提供了一些实用的建议和示例代码。通过合理使用后台任务，开发者可以提高应用程序的性能和用户体验，同时避免一些常见的问题和错误。
• 控制后台进程CPU使用率：介绍什么是控制后台进程CPU使用率、约束与调测验证。
• 蓝牙资源合理使用：介绍如何合理使用蓝牙资源、蓝牙的约束与示例。
• 网络资源合理使用：介绍如何合理使用网络资源、约束与示例。
• 音频资源合理使用：介绍如何合理使用音频资源、约束与示例。
• GPS资源合理使用：介绍如何合理使用GPS资源、约束与示例。
• 传感器资源合理使用：介绍如何合理使用传感器资源、约束与示例。
• 后台上传下载合理使用：介绍如何合理使用上传下载资源、约束与示例。
• 后台音频播放合理使用：介绍如何合理使用音频播放、约束与示例。
• 后台定位导航服务合理使用：介绍如何合理使用定位导航服务、约束与示例。
• 后台系统资源合理使用：介绍如何合理使用系统资源、约束与示例。

功能开发

• 组件嵌套优化：本文通过原理概念、优化场景和实践数据对比三个角度，详细介绍组件嵌套的优化，着重从优化场景角度为开发者阐明组件嵌套的优化场景以及优化策略。
• 视频类应用横竖屏切换：介绍横竖屏功能的开发过程中需要关注的内容，包括窗口旋转策略的选择、常用应用类型的横竖屏开发和常见的横竖屏开发问题。

• 生态应用相机实现系统级相机体验：本文针对三方相机开发场景，基于HarmonyOS提供的相机开放能力，实现系统相机级别的效果和能力，比如分辨率、动图、视频防抖、连续变焦等。

2024年5月

[h2]新增文档

新增7篇文章，包括HarmonyOS特征、业务场景与解决方案、性能、功耗和功能开发模块。

HarmonyOS特征

• 多设备地图导航界面：详细解释了多行程导航的概念、设计原则和实施步骤，并提供了示例代码和注意事项。通过阅读该文档，开发者可以了解如何在应用程序中实现多行程导航功能，以提升用户体验和功能完整性。

业务场景与解决方案

• 首页信息流体验优化：本文主要面向于新闻类页面开发人员，指导开发者从零开始构建一个新闻类的首页面。主要包含地址选择、tabs和tabContent切换的动态图标和流畅动效、下拉刷新上拉加载、首页feed流等常见功能的实现及流畅体验。

性能

• 应用内存占用优化：介绍如何在开发过程中进行内存优化，以提高应用程序的性能和效率。文档中包含了内存优化的原则、技巧和工具，帮助开发者更好地管理和优化应用程序的内存使用。

功耗

• 基于LTPO的低功耗设计：介绍LTPO技术的原理、特点以及应用场景和优势。通过阅读该文档，开发者可以了解如何在自己的应用中充分利用LTPO技术，提升用户体验并节省能源消耗。

功能开发

• 使用AOT进行性能优化：已下线。
• 组件复用：介绍如何使用组件复用机制提升应用帧率。
• 懒加载优化性能：介绍如何通过懒加载技术来优化网页性能，提高用户体验。详细介绍懒加载的原理、实现方式和注意事项，并提供了示例代码和最佳实践建议。

2024年4月

[h2]新增文档

新增9篇文章，包括HarmonyOS特征、性能、安全、运维和功能开发模块。

HarmonyOS特征

• 多设备音乐界面：介绍如何将“一次开发，多端部署”应用到音乐播放器的实际开发过程中，包括架构设计、UX设计和页面开发。
• 多设备旅行订票界面：介绍“一多”在旅行订票垂类开发中的应用，包括首页、时间选择页、查询车票页、填写购票信息页、提交订单页等11个典型页面开发案例。

性能

• 性能分析简介：介绍调优的方法、常用的工具，便于开发者可以更好地分析和解决应用程序中的性能问题，提升用户体验，实现应用程序的高效稳定运行。

• 瀑布流加载丢帧优化：介绍如何进行流水线性能优化的方法和技巧。文档中包含了详细的步骤和示例，帮助开发者在开发过程中提高应用程序的性能和效率。
• Grid组件加载丢帧优化：介绍如何提高网格性能的方法，包括减少布局层次、使用合适的布局管理器、使用ViewHolder模式、使用异步加载等。
• 应用包体积优化：介绍如何减小应用程序包的大小。包括使用资源压缩、代码混淆、资源合并等技术，以及减少不必要的依赖和资源文件等建议。

安全

• 应用代码混淆：介绍在开发应用程序时如何进行代码混淆的方法和技巧。包含了代码混淆的定义、原理和常见的混淆技术，以及如何使用混淆工具进行代码混淆的步骤和注意事项。

运维

• CppCrash类问题分析方法：提供了关于如何在C++开发中处理崩溃和异常的指导，以及一些常见的最佳实践建议。它涵盖了崩溃的原因、调试技巧、日志记录和错误处理等方面的内容，旨在帮助开发者更好地处理和解决C++程序中的崩溃问题。

功能开发

• ArkWeb渲染框架适配：介绍ArkWeb渲染框架的特点、使用方法和最佳实践，帮助开发者更好地利用该框架进行Web应用开发。

2024年3月

[h2]新增文档

新增12篇文章，包括HarmonyOS特征、架构、性能、安全、功能开发和开发工具模块。

HarmonyOS特征

• 多设备股票类界面：介绍“一多”在股票类应用开发中的应用。主要包含首页、资讯、自选股、个股详情、行情等9个典型页面。
• 多设备移动支付界面：介绍“一多”在移动支付应用开发中的应用。主要包含支付、收款、扫码等。

架构

• 应用导航设计：介绍应用程序导航设计的相关内容。内容涵盖了导航结构的设计、导航元素的选择和布局、导航交互的设计等方面。
• 应用并发设计：介绍应用在并行任务方案设计过程中，可能会遇到的典型场景以及对应的推荐设计方案，同时给出了方案的关键点及参考案例。
• 应用切面编程设计：介绍对应接口的基本原理，并针对以上业务场景，具体说明怎么利用运行时插桩的接口完成对类方法的埋点和加日志功能。

性能

• Web加载性能优化：介绍Web页面加载优化、JSBridge和同层渲染的优化方式。
• 应用冷启动时延优化：介绍应用冷启动流程、识别启动缓慢问题和提升应用冷启动速度，来帮助开发者提升应用的冷启动速度，避免卡顿感。
• 文件上传下载优化：介绍两种常见的上传下载传输和网络请求的关键技术：数据压缩和断点续传，可减少宽带占用，提高传输效率，从而达到提升数据交换性能。

安全

• 应用资产保护设计：介绍应用在资产保护方案设计过程中，可能会遇到的典型场景以及对应的推荐设计方案，同时给出了方案的关键点及参考案例。

功能开发

• 组件封装：介绍公用组件封装、弹窗组件封装和组件工厂类封装的业务场景，并具体说明了各场景及其实现方案。
• 组件动态创建：介绍如何在用户界面中实现动态操作，设计和实现具有动态操作功能的用户界面。包括使用动态数据绑定、使用动态样式和主题、使用动态布局等。

开发工具

• GN构建工程配置HarmonyOS编译工具链：介绍如何在GN工程中配置HarmonyOS工具链，然后通过HarmonyOS工具链编译出可以在HarmonyOS环境下使用的三方库。

2024年1月

[h2]新增文档

新增9篇文章，包括HarmonyOS特征、性能、安全和功能开发模块。

HarmonyOS特征

• 多设备短视频界面：介绍如何将“一次开发，多端部署”使用到短视频应用的实际开发过程中，包括首页、商品分类页、商品详情页、商品支付页、咨询客服页、直播间页等。
• 多设备购物比价界面：介绍如何将“一次开发，多端部署”使用到购物比价应用的实际开发过程中，包括架构设计、UX设计和页面开发。
• 多设备新闻阅读界面：介绍如何将“一次开发，多端部署”使用到新闻阅读应用的实际开发过程中，包含首页推荐、热门新闻、新闻详情、刷新闻、精选发现等。
• 多设备图片美化界面：介绍如何将“一次开发，多端部署”使用到图片美化应用的实际开发过程中，包含相册，大图预览，图片编辑功能。

• 华为视频接入播控中心和投播实践：已下线。

性能

• 性能体验设计：介绍如何设计流畅的应用程序。包括减少应用程序的启动时间、优化界面渲染、合理使用内存和网络资源等方面的建议。

• 感知流畅优化：介绍如何通过优化应用程序的性能和交互体验，提高用户对应用程序的感知流畅度。其中包括了减少卡顿、提高响应速度、优化动画效果等方面的建议和技巧。

安全

• 应用安全编码实践：介绍如何保护应用程序免受安全威胁。包括应用程序的数据保护、用户隐私保护、网络安全、代码安全等方面的内容。

功能开发

• UI组件性能优化：介绍如何优化UI组件的性能，包括减少布局层级、使用合适的动画效果、优化图片加载、避免过度绘制等。

2023年11月

[h2]新增文档

新增11篇文章，包括HarmonyOS特征、性能、功耗、安全和功能开发模块。

HarmonyOS特征

• 多设备即时通讯界面：介绍如何将“一多”使用到即时通讯应用的实际开发过程中，包括架构设计、UX设计和页面开发。
• 多设备社区评论界面：介绍社区评论行业应用作为典型案例介绍“一多”在实际开发中的应用，主要包括关键布局能力的功能及实现。
• 多设备银行理财界面：本文从架构设计、UX设计、页面开发三个角度，以银行理财应用作为典型案例详细介绍“一多”在实际开发中的应用。具体功能主要包含首页推荐、产品专题、产品详情、产品对比、收益明细等。

性能

• 点击响应时延分析：介绍点击响应优化的方法和技巧，包括性能优化的重要性、优化的目标、优化的方法和技巧等。

功耗

• 省电和深色模式下低功耗设计：介绍关于如何在暗模式下优化应用程序的电池寿命的指导和建议。包括暗模式的概述，以及在设计和开发过程中需要考虑的关键因素，如颜色选择、图标设计、背光控制等。

安全

• 应用隐私保护：介绍开发者在应用开发过程中如何保护用户隐私的指导和建议。包括隐私政策的编写、数据收集和使用、权限管理、数据安全等方面的内容。
• 应用数据安全：介绍关于如何保护应用程序中的数据安全的指导和建议。包括使用加密算法保护敏感数据、使用安全存储保护数据、使用安全传输保护数据等。

功能开发

• ArkTS高性能编程：介绍开发过程中的一些高性能的写法和建议，包含变量声明、属性的访问、数值计算、数据结构的使用以及函数声明与使用等。
• TaskPool和Worker对比：介绍TaskPool和Worker的概念、使用场景以及如何选择适合的方案。通过比较TaskPool和Worker的特点和优势，帮助开发者更好地理解和应用这两种技术，以提高工作效率和性能。
• 状态管理最佳实践：介绍状态管理的概念、原则和实施方法，包括状态管理的重要性、状态管理的基本原则、常见的状态管理模式和框架，以及实现状态管理的具体步骤和示例代码。
• 动画使用指导：介绍合理使用动画的技巧和方法，包含了一些关于动画设计原则、性能优化、交互设计和可访问性等方面的建议和技巧。

2023年9月

[h2]新增文档

新增8篇文章，包括HarmonyOS特征、架构、性能和功能开发模块。

HarmonyOS特征

• 多设备长视频界面：本文分别从UX设计、工程管理、页面开发和功能开发四个角度给出符合“一多”的参考样例，介绍“一多”长视频应用在开发过程中的最佳实践。

架构

• 架构概览：介绍应用程序架构的重要性，以及如何设计和构建可扩展、可维护和高效的应用程序架构。
• 分层架构设计：介绍逻辑模型、开发模型和部署模型的应用分层架构设计规则。
• 模块化设计：介绍什么是模块化设计、为什么在软件开发中采用模块化设计和如何实施模块化设计。

性能

• 帧率问题分析：介绍丢帧问题原理、思路分析、常见丢帧问题及优化建议。

• 长列表加载丢帧优化：介绍了长列表加载场景下，如何使用懒加载、缓存列表项、动态预加载、组件复用及布局优化来优化列表渲染时间、页面滑动帧率和应用内存占用，从而提升性能和用户体验。

功能开发

• 布局优化指导：介绍如何提高布局性能，包括使用CSS Grid和Flexbox进行灵活布局、减少DOM元素的数量、合理使用CSS样式和动画、优化图片加载等。
• 页面间转场：介绍在开发网页时如何实现流畅的页面过渡效果，包括如何使用动画、过渡效果和预加载等技术来优化页面过渡。