跨平台框架社区联合22家单位88位贡献者共同撰了《跨平台框架白皮书》,该白皮书于2026年6月在开源社区正式发布,其内容涵盖React Native、Flutter、KMP&CMP等多种跨平台框架的技术架构、演进历史、适用场景和企业案例等多方面内容,为开发者选型提供多维度的技术参考。跨平台框架白皮书下载地址:https://atomgit.com/ OpenHarmony-CrossPlatformFramework/community/tree/main/guides
ReactNative
| 一级模块 | 二级模块 | 主要功能 | 链接 |
| 框架介绍 | 框架介绍 | 介绍 RNOH 框架定位、适用场景与整体能力 | 框架介绍 |
| 架构介绍 | 架构介绍 | 介绍 RNOH 架构、核心模块与启动流程 | 架构介绍 |
| 版本说明
| 当前版本 | 查看当前 main 文档对应的 RN / RNOH 版本、配套 IDE、SDK、ROM 和最低 API 要求 | 版本说明 |
| Release Note | 查看当前 RNOH 版本发布信息、配套版本与变更说明 | RNOH v0.84.1 | |
| 版本路线图 | 查看 RNOH 社区版本规划、支持矩阵和版本特征 | roadmap | |
| 0.72.x 分支 | RN 0.72.x 对应 0.72-main、0.72-stable、0.72-hotfix | 0.72-main | |
| 0.77.x 分支 | RN 0.77.x 对应 0.77-main、0.77-stable、0.77-hotfix | 0.77-main | |
| 0.82.x 分支 | RN 0.82.x 对应 0.82-main、0.82-stable、0.82-hotfix | 0.82-main | |
| 0.84.x 分支 | RN 0.84.x 当前以 main 文档和社区公告为准 | main 文档 | |
| 环境搭建
| 环境搭建 | 介绍 DevEco Studio、Node.js、hdc、npm/ohpm、签名和工程运行配置 | 环境搭建 |
| SDK版本配置指导 | 介绍 HarmonyOS SDK 版本选择与配置要求 | SDK版本配置指导 | |
| 示例工程索引 | 汇总 RNOH Sample 工程,便于按场景验证能力 | 示例工程索引 | |
| 功能开发
| 功能开发 | 介绍 RNOH 功能开发主流程 | 功能开发 |
| RN应用鸿蒙化开发指南 | 介绍 RNJS 工程、鸿蒙 Native 工程、bundle、依赖安装和运行链路 | RN应用鸿蒙化开发指南 | |
| RN Native接入 | 介绍如何在 ArkTS 原生侧接入 RNOH | RN-Native接入 | |
| RN JS打包 | 介绍 RN JS bundle 打包、加载和多 bundle 场景 | RN-JS打包 | |
| API接口说明 | 介绍 RNOH 原生侧核心 API | API接口说明 | |
| 两端通讯 | 介绍 RN JS 侧与 ArkTS 原生侧通信方式 | 两端通讯 | |
| Codegen | 介绍 RNOH Codegen 使用方式 | Codegen | |
| 自定义TurboModule | 介绍如何创建自定义 TurboModule | TurboModule | |
| 自定义组件 | 介绍如何创建自定义 Fabric 组件和 ArkTS 组件 | 自定义组件 | |
| ArkTS与CPP之间通信 | 介绍创建 TurboModule 或组件时 ArkTS 与 C++ 之间的通信 | ArkTS与CPP之间通信 | |
| C-API组件混合方案 | 介绍 C-API 组件与 ArkTS 组件混合使用方式 | C-API组件混合方案的使用 | |
| Autolinking | 介绍 RNOH 三方库和自定义模块自动链接配置 | Autolinking | |
| 性能调优
| 性能调优 | 介绍 RNOH 性能分析与优化方法 | 性能调优 |
| 内存优化指导 | 介绍内存优化、后台 GC、JSVM 调参等方法 | 内存优化指导 | |
| 调试调测 | 调试调测 | 介绍 Metro 热加载、DevTools、日志和调试工具 | 调试调测 |
| 三方库接入 | 三方库接入 | 查看 RNOH 兼容三方库列表和接入指导 | RNOH三方库接入指南 |
| 常见开发场景
| 常见开发场景 | 汇总沙箱加载、字体、三方库、权限、页面跳转等开发场景 | 常见开发场景 |
| 场景化最佳实践 | 汇总 RN 应用鸿蒙化开发实践案例 | 场景化最佳实践 | |
| FAQ
| FAQ总览 | 查看 RNOH 常见问题入口 | |
| 编译类FAQ | 查看编译构建相关问题 | 编译类FAQ | |
| 运行类FAQ | 查看运行时相关问题 | 运行类FAQ | |
| 定位定界指导类FAQ | 查看问题定位与定界方法 | 定位定界指导类FAQ | |
| 规格类FAQ | 查看规格限制和兼容性问题 | 规格类FAQ | |
| 使用类FAQ | 查看 API、属性和使用方式问题 | 使用类FAQ | |
| 版本升级
| 版本升级指导 | 介绍 RNOH 版本升级流程和注意事项 | 版本升级指导 |
| RN升级适配整理 | 汇总 RN 版本升级需要开发者适配的内容 | RN升级需要开发者适配整理 | |
| 上游社区不兼容变更 | 汇总 React Native 上游不兼容变更 | 上游社区不兼容变更 | |
| 社区反馈 | Issues | 提交 RNOH 文档、使用和运行问题 | GitCode Issues |
Flutter
| 一级模块 | 二级模块 | 主要功能 | 链接 |
| 框架介绍 |
| 介绍Flutter框架 | https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/01_framework/README.md |
| 架构介绍 |
| Flutter架构概览 | https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/02_architecture/README.md |
| 环境搭建
| OpenHarmony版Flutter环境搭建指导 | 介绍OpenHarmony版Flutter环境如何搭建 | |
| Flutter OH Engineg构建指导 | 介绍如何搭建Flutter OH Engine 编译环境 | ||
| OpenHarmony设备运行指导 | OpenHarmony设备运行指导 | ||
| 功能开发
| 在OpenHarmony应用中添加Flutter页面
| 介绍如何使用FlutterPage | |
| 介绍如何使用混合开发添加跳转FlutterEntry | |||
| 在OpenHarmony应用中使用Flutter Channel能力 | 介绍如何使用Flutter与OpenHarmony通信FlutterChannel | ||
| 与原生混合渲染
| Flutter OHOS外接纹理适配简介 | ||
| 介绍如何使用多引擎FlutterEngineGroup | |||
| 介绍如何使用PlatformView | https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/do cs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8PlatformView.md | ||
| PlatformView同层渲染方案适配切换指导 | |||
| 开发Flutter静态库
| 介绍如何使用混合开发module | ||
| 介绍如何使用hvigor插件方式编译flutter项目 | |||
| 介绍如何开发package | |||
| 介绍如何开发plugin | |||
| 介绍如何开发FFI plugin | https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/do cs/04_development/%E5%BC%80%E5%8F%91FFI%20plugin.md | ||
| 开发LTPO指导 | 介绍如何使用LTPO功能 | ||
| OpenHarmony应用集成Flutter指导 | 介绍如何在已有的OpenHarmony应用里集成Flutter模块 | ||
| 性能调优
| 性能分析定界指南 | 介绍如何在OpenHarmony平台进行性能分析定界 | |
| 性能分析第一步-梳理线程顺序 | 介绍如何进行性能分析 | ||
| 性能分析-帧渲染跟踪 | 介绍如何进行帧渲染跟踪分析 | ||
| 性能分析-滑动响应时延 | 介绍如何进行滑动响应时延分析 | ||
| 性能调优-图片加载 | 介绍如何进行图片加载内存分析 | ||
| 性能调优-内存分析与优化实践 | 内存分析与优化实践 | ||
| 性能调优-毕昇编译器开PGO | 介绍毕昇编译器如何开启PGO | ||
| 调试调测
| 调试dart代码 | 调试dart代码 | |
| 调试OpenHarmony应用/服务 | 调试OpenHarmony应用/服务 | ||
| 三方库接入
| ohos平台适配flutter三方库指导 | ohos平台适配flutter三方库指导 | |
| ohos平台已兼容库 | ohos平台已兼容库 | ||
| 场景化案例
| 稳定性问题场景案例 | 稳定性问题场景案例 | |
| 登录功能接入场景案例 | Flutter OH 应用接入华为一键登录 | https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/account-faq-18 | |
| FAQ
| 环境配置相关问题 | 环境配置相关问题 | |
| ohos引擎产物编译相关问题 | ohos引擎产物编译相关问题 | ||
| ohos应用编译相关问题 | ohos应用编译相关问题 | https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/08_FAQ/ohos-build-faq.md | |
| ohos代码开发相关问题 | ohos代码开发相关问题 | https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/08_FAQ/ohos%E4%BB%A3%E7%A0%81%E5%BC%80%E5%8F%91%E7%9B%B8%E5%85 %B3%E9%97%AE%E9%A2%98.md | |
| ohos运行相关问题 | ohos运行相关问题 | ||
| 功能开发相关问题 | 功能开发相关问题 | https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/README.md | |
| 解析flutter相关的cppcrash堆栈 | 解析flutter相关的cppcrash堆栈 | ||
| 申请权限相关问题 | 申请权限相关问题 | ||
| 规格说明
| Flutter OpenHarmony化工程的目录结构 | Flutter OpenHarmony化工程的目录结构 | |
| 更新Flutter插件项目结构 | 更新Flutter插件项目结构 | ||
| 附录
| Flutter OH 版本说明 | Flutter-OH版本演进规划和分支策略 | |
| Flutter OH 升级指导 | 介绍 Flutter OH 应用如何进行版本升级 |
KMP&CMP 资料
文档入口:https://developer.huawei.com/consumer/cn/blog/topic/03228093828012444
uni-app x/uni-app
文档入口:https://developer.huawei.com/consumer/cn/forum/topic/0207227455441220120
Web 类三方框架
Taro
文档入口:https://docs.taro.zone/docs/harmony/
Hybrid 容器方案:https://docs.taro.zone/docs/harmony/hybrid
Weex
文档入口:https://github.com/alibaba/weex/blob/master/ohos/docs/weex鸿蒙化指导文档.md
Cordova
文档入口:https://gitcode.com/CPF-Cordova/cordova-openharmony/blob/master/README.md
Ionic
文档入口:https://gitcode.com/CPF-Ionic/openHarmony-capacitor/blob/main/README.md
原生开源三方库
文档入口:https://gitcode.com/openharmony-tpc/docs
QT框架:
开源QT编译脚本和脚本说明:https://gitcode.com/qtforohos/Build
商业QT使用说明文档:https://wiki.qt.io/Qt_for_OpenHarmony/zh
Electron框架:
开发指导:https://developer.huawei.com/consumer/cn/forum/topic/0204189796759316140?fid=0109140870620153026
Chromium/CEF:
Chromium开发指导:https://developer.huawei.com/consumer/cn/forum/topic/0201189795100784164?fid=0109140870620153026
CEF开发指导:https://developer.huawei.com/consumer/cn/forum/topic/0204189797656362142?fid=0109140870620153026








































苏公安网备 32011402010933号
对于拥有大量存量代码的企业而言,这种策略极具吸引力。它降低了鸿蒙化的门槛,让开发者能复用现有技术栈,平滑过渡而非断崖式重构。尤其是RN和Flutter的深度适配文档,直接解决了“怎么改”、“怎么调”的痛点,将抽象的生态愿景转化为可执行的工程路径。
然而,文档的丰富度也侧面反映了生态的碎片化挑战。多框架并行虽能短期聚拢人气,但长期看,如何统一体验标准、避免性能损耗、防止维护割裂,将是社区必须面对的考题。白皮书是“地图”,但真正的“路况”还需开发者在实践中摸索。鸿蒙跨平台的下半场,将从“有没有”转向“好不好”,考验的是精细化运营与底层优化的硬功夫。
这种“联合共建”的模式极具战略智慧。它承认了跨平台技术在当前开发流程中的不可替代性,并试图将鸿蒙原生能力(如方舟编译器、分布式特性)作为底层基座,向上兼容各类框架,而非取而代之。白皮书的发布不仅是文档的堆砌,更是生态信心的传递——告诉开发者:无论你用何种技术栈,鸿蒙都有对应的解决方案与官方背书。
然而,文档的完善只是第一步。真正的挑战在于后续的工具链支持、社区响应速度以及实际案例的落地效果。若能让开发者在迁移过程中真正感受到“一次开发,多端部署”的便利,而非陷入新的兼容性泥潭,鸿蒙方能将这份“白皮书”转化为实实在在的生态繁荣。