文档开发者中心
我的

HarmonyOS 三方框架文档资料总结

浏览1W+发布于2026-06-13 01:14北京
本文章最后由 HarmonyOS技术支持 于 2026-11-04 01:43 编辑

       跨平台框架社区联合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

使用类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环境如何搭建

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/03_environment/OpenHarmony-flutter%E7%8E%AF%E5%A2%83%E6%90%AD%E5%BB%BA%E6%8C%87%E5%AF%BC.md

Flutter OH Engineg构建指导

介绍如何搭建Flutter OH Engine 编译环境

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/03_environment/Flutter-OH-engine%E6%9E%84%E5%BB%BA%E6%8C%87%E5%AF%BC.md

OpenHarmony设备运行指导

OpenHarmony设备运行指导

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/03_environment/OpenHarmony%E8%AE%BE%E5%A4%87%E8%BF%90%E8%A1%8C%E6%8C%87%E5%AF%BC.md

功能开发

 

 

 

 

 

 

 

 

 

 

 

 

在OpenHarmony应用中添加Flutter页面

 

介绍如何使用FlutterPage

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8%20FlutterPage.md

介绍如何使用混合开发添加跳转FlutterEntry

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8%E6%B7%B7%E5%90%88%E5%BC%80%E5%8F%91%E6%B7%BB%E5%8A%A0%E8%B7%B3%E8%BD%AC%20FlutterEntry.md

在OpenHarmony应用中使用Flutter Channel能力

介绍如何使用Flutter与OpenHarmony通信FlutterChannel

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8Flutter%E4%B8%8EOpenHarmony%E9%80%9A%E4%BF%A1%20FlutterChannel.md

与原生混合渲染

 

 

 

Flutter OHOS外接纹理适配简介

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/Flutter%20OHOS%E5%A4%96%E6%8E%A5%E7%BA%B9%E7%90%86%E9%80%82%E9%85%8D%E7%AE%80%E4%BB%8B.md

介绍如何使用多引擎FlutterEngineGroup

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8%E5%A4%9A%E5%BC%95%E6%93%8E%20FlutterEngineGroup.md

介绍如何使用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同层渲染方案适配切换指导

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/PlatformView%E5%90%8C%E5%B1%82%E6%B8%B2%E6%9F%93%E6%96%B9%E6%A1%88%E9%80%82%E9%85%8D%E5%88%87%E6%8D%A2%E6%8C%87%E5%AF%BC.md

开发Flutter静态库

 

 

 

介绍如何使用混合开发module

http://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8%E6%B7%B7%E5%90%88%E5%BC%80%E5%8F%91%20module.md

介绍如何使用hvigor插件方式编译flutter项目

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E4%BD%BF%E7%94%A8hvigor%E6%8F%92%E4%BB%B6%E6%96%B9%E5%BC%8F%E7%BC%96%E8%AF%91flutter%E9%A1%B9%E7%9B%AE.md

介绍如何开发package

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%BC%80%E5%8F%91package.md

介绍如何开发plugin

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%BC%80%E5%8F%91plugin.md

介绍如何开发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功能

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8LTPO%E5%8A%9F%E8%83%BD.md

OpenHarmony应用集成Flutter指导

介绍如何在已有的OpenHarmony应用里集成Flutter模块

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/OpenHarmony%E5%BA%94%E7%94%A8%E5%A6%82%E4%BD%95%E9%9B%86%E6%88%90Flutter.md

性能调优

 

 

 

 

 

 

 

性能分析定界指南

介绍如何在OpenHarmony平台进行性能分析定界

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/05_performance/%E6%80%A7%E8%83%BD%E5%88%86%E6%9E%90%E5%AE%9A%E7%95%8C%E6%8C%87%E5%8D%97.md

性能分析第一步-梳理线程顺序

介绍如何进行性能分析

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/05_performance/%E6%80%A7%E8%83%BD%E5%88%86%E6%9E%90%E7%AC%AC%E4%B8%80%E6%AD%A5-%E6%A2%B3%E7%90%86%E7%BA%BF%E7%A8%8B%E9%A1%BA%E5%BA%8F.md

性能分析-帧渲染跟踪

介绍如何进行帧渲染跟踪分析

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/05_performance/%E6%80%A7%E8%83%BD%E5%88%86%E6%9E%90-%E5%B8%A7%E6%B8%B2%E6%9F%93%E8%B7%9F%E8%B8%AA.md

性能分析-滑动响应时延

介绍如何进行滑动响应时延分析

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/05_performance/%E6%80%A7%E8%83%BD%E5%88%86%E6%9E%90-%E6%BB%91%E5%8A%A8%E5%93%8D%E5%BA%94%E6%97%B6%E5%BB%B6.md

性能调优-图片加载

介绍如何进行图片加载内存分析

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/05_performance/%E6%80%A7%E8%83%BD%E8%B0%83%E4%BC%98-%E5%9B%BE%E7%89%87%E5%8A%A0%E8%BD%BD.md

性能调优-内存分析与优化实践

内存分析与优化实践

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/05_performance/%E6%80%A7%E8%83%BD%E8%B0%83%E4%BC%98-%E5%86%85%E5%AD%98%E5%88%86%E6%9E%90%E4%B8%8E%E4%BC%98%E5%8C%96%E5%AE%9E%E8%B7%B5.md

性能调优-毕昇编译器开PGO

介绍毕昇编译器如何开启PGO

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/05_performance/%E6%80%A7%E8%83%BD%E8%B0%83%E4%BC%98-%E6%AF%95%E6%98%87%E7%BC%96%E8%AF%91%E5%99%A8%E5%BC%80%E5%90%AFPGO.md

调试调测

 

调试dart代码

调试dart代码

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/06_debug/%E8%B0%83%E8%AF%95dart%E4%BB%A3%E7%A0%81.md

调试OpenHarmony应用/服务

调试OpenHarmony应用/服务

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides-V2/ohos-debugging-app-0000001545729889-V2

三方库接入

 

ohos平台适配flutter三方库指导

ohos平台适配flutter三方库指导

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/07_plugin/ohos%E5%B9%B3%E5%8F%B0%E9%80%82%E9%85%8Dflutter%E4%B8%89%E6%96%B9%E5%BA%93%E6%8C%87%E5%AF%BC.md

ohos平台已兼容库

ohos平台已兼容库

https://gitcode.com/CPF-Flutter/flutter_packages/blob/master/README.md#openharmony%E5%B9%B3%E5%8F%B0%E5%B7%B2%E5%85%BC%E5%AE%B9%E5%BA%93

场景化案例

 

稳定性问题场景案例

稳定性问题场景案例

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/Scenario_based_cases/stability-issue-scenarios.md

登录功能接入场景案例 

Flutter OH 应用接入华为一键登录

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/account-faq-18

FAQ

 

 

 

 

 

 

 

环境配置相关问题

环境配置相关问题

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/08_FAQ/%E7%8E%AF%E5%A2%83%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/08_FAQ/ohos%E5%BC%95%E6%93%8E%E4%BA%A7%E7%89%A9%E7%BC%96%E8%AF%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/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/08_FAQ/ohos%E8%BF%90%E8%A1%8C%E7%9B%B8%E5%85%B3%E9%97%AE%E9%A2%98.md

功能开发相关问题

功能开发相关问题

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/04_development/README.md

解析flutter相关的cppcrash堆栈

解析flutter相关的cppcrash堆栈

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/06_debug/%E8%A7%A3%E6%9E%90flutter%E7%9B%B8%E5%85%B3%E7%9A%84cppcrash%E5%A0%86%E6%A0%88.md

申请权限相关问题

申请权限相关问题

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/08_FAQ/%E7%94%B3%E8%AF%B7%E6%9D%83%E9%99%90%E7%9B%B8%E5%85%B3%E9%97%AE%E9%A2%98.md

规格说明

 

Flutter OpenHarmony化工程的目录结构

Flutter OpenHarmony化工程的目录结构

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/09_specifications/OpenHarmony-flutter%E5%8C%96%E5%B7%A5%E7%A8%8B%E7%9A%84%E7%9B%AE%E5%BD%95%E7%BB%93%E6%9E%84.md

更新Flutter插件项目结构

更新Flutter插件项目结构

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/09_specifications/%E6%9B%B4%E6%96%B0Flutter%E6%8F%92%E4%BB%B6%E9%A1%B9%E7%9B%AE%E7%BB%93%E6%9E%84.md

附录

 

Flutter OH 版本说明

Flutter-OH版本演进规划和分支策略

https://gitcode.com/CPF-Flutter/flutter_flutter/wiki/Flutter-OH%E7%89%88%E6%9C%AC%E6%BC%94%E8%BF%9B%E8%A7%84%E5%88%92%E5%92%8C%E5%88%86%E6%94%AF%E7%AD%96%E7%95%A5.md

Flutter OH 升级指导

介绍 Flutter OH 应用如何进行版本升级

https://gitcode.com/CPF-Flutter/flutter_samples/blob/master/ohos/docs/10_appendix/Flutter-OH%E7%89%88%E6%9C%AC%E5%8D%87%E7%BA%A7%E6%8C%87%E5%AF%BC.md

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

收藏
70
回复
331
分享
全部评论
authorIcon
youhao1999
感谢分享
回复于4 天前四川
authorIcon
匿名用户
很不错,很有用,学习了
回复于6 天前四川
authorIcon
AlexWu
感谢分享
回复于2026-11-02 23:46江苏
authorIcon
180******22
总结的真好
回复于2026-10-27 01:50广西
authorIcon
锦鲤附体
👍
回复于2026-10-25 00:39浙江
authorIcon
匿名用户
《跨平台框架白皮书》的发布,是鸿蒙生态从“单兵作战”走向“集团军协同”的关键里程碑。由22家单位、88位贡献者共同撰写,这一规模本身就证明了鸿蒙在跨平台领域的号召力已初具气候。白皮书涵盖React Native、Flutter、KMP等主流框架,意味着鸿蒙不再试图让开发者“二选一”或“推倒重来”,而是务实地提供了一套“兼容并蓄”的迁移与共存方案。
对于拥有大量存量代码的企业而言,这种策略极具吸引力。它降低了鸿蒙化的门槛,让开发者能复用现有技术栈,平滑过渡而非断崖式重构。尤其是RN和Flutter的深度适配文档,直接解决了“怎么改”、“怎么调”的痛点,将抽象的生态愿景转化为可执行的工程路径。
然而,文档的丰富度也侧面反映了生态的碎片化挑战。多框架并行虽能短期聚拢人气,但长期看,如何统一体验标准、避免性能损耗、防止维护割裂,将是社区必须面对的考题。白皮书是“地图”,但真正的“路况”还需开发者在实践中摸索。鸿蒙跨平台的下半场,将从“有没有”转向“好不好”,考验的是精细化运营与底层优化的硬功夫。
回复于2026-10-24 15:54广东
authorIcon
锦鲤附体
👍
回复于2026-10-24 04:22浙江
authorIcon
AlexWu
感谢分享
回复于2026-10-24 00:58湖北
authorIcon
littleguo
写得很清楚,受教了,期待更多鸿蒙实战内容
回复于2026-10-20 01:02北京
authorIcon
匿名用户
该帖展示了鸿蒙生态在跨平台框架整合上的务实姿态。由官方技术支持牵头,联合22家单位与88位贡献者共同撰写《跨平台框架白皮书》,涵盖React Native、Flutter、KMP等主流技术栈,这标志着鸿蒙不再试图“闭门造车”强推单一标准,而是选择拥抱现有开发者生态,通过提供多维度的技术参考与迁移路径,降低开发者的适配门槛。
这种“联合共建”的模式极具战略智慧。它承认了跨平台技术在当前开发流程中的不可替代性,并试图将鸿蒙原生能力(如方舟编译器、分布式特性)作为底层基座,向上兼容各类框架,而非取而代之。白皮书的发布不仅是文档的堆砌,更是生态信心的传递——告诉开发者:无论你用何种技术栈,鸿蒙都有对应的解决方案与官方背书。
然而,文档的完善只是第一步。真正的挑战在于后续的工具链支持、社区响应速度以及实际案例的落地效果。若能让开发者在迁移过程中真正感受到“一次开发,多端部署”的便利,而非陷入新的兼容性泥潭,鸿蒙方能将这份“白皮书”转化为实实在在的生态繁荣。
回复于2026-10-19 14:49广东
写评论
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。
发表
我要写文章
目录 收起
ReactNative
Flutter
KMP&CMP 资料
uni-app x/uni-app
Web 类三方框架
Taro
Weex
Cordova
Ionic
原生开源三方库
了解社区公约,与您携手共创和谐专业的开发者社区。