开源鸿蒙跨平台开发全景解读：框架有哪些、进度到哪了、该怎么学、能共建什么
开源鸿蒙跨平台开发全景解读：框架有哪些、进度到哪了、该怎么学、能共建什么
这两年大家聊鸿蒙化，聊得最多的是"原生应用怎么迁"；但从 2025 年下半年开始，一个更值得关注的赛道在快速成型——跨平台框架的鸿蒙化。Flutter、React Native、KMP/CMP、Cordova、Ionic、Electron，甚至仓颉语言原生的 CJMP，都已经有组织化的适配体系和可下载的版本。
这篇文章基于 2026 年 9 月 5 日对 AtomGit 上 13 个组织的全量数据采集，把四件事一次讲清楚：
- 开源鸿蒙跨平台开发的框架全景；
- 各框架的适配进度与最新版本；
- 每个组织下该重点看哪些仓库；
- 开发者怎么学、能共建什么。
一、全景：五类技术路线 + 一个三方库底座
先把地图铺开。AtomGit 上的跨平台版图可以概括为"五类路线 + 一个底座 + 一层社区"：
| 技术路线 | 组织 | 规模（仓库数 · Star） | 一句话定位 |
|---|---|---|---|
| 自绘引擎（Dart + Skia/Impeller） | CPF-Flutter | 373 仓 · 3054★ | Flutter SDK + Engine 的 OpenHarmony 适配 |
| 原生渲染（React + Fabric） | CPF-RN | 286 仓 · 1947★ | React Native for OpenHarmony（RNOH） |
| 逻辑 + 声明式 UI（Kotlin/Compose） | CPF-KMP-CMP | 74 仓 · 1118★ | 把 KMP / CMP 开发体验带入鸿蒙 |
| 仓颉自研 | CJMP | 20 仓 · 331★ | 仓颉语言原生跨平台框架，自研引擎 |
| Web 混合 / 桌面 | CPF-Cordova、CPF-Ionic、CPF-Electron | 82 / 49 / 1 仓 | WebView 混合与 Electron 桌面路线 |
| 三方库底座 | CPF-ApplicationTPC | 166 仓 · 1642★ | 应用与三方库鸿蒙化的公共底座 |
| 开发者运营社区 | hxa-atpc / hxa-flutter / hxa-rn / oh-flutter / oh-tpc | 559 仓 | 三方库鸿蒙化的"群众路线" |
怎么理解这个结构？ CPF-*（Cross Platform Framework）各组织负责"框架本身能不能在鸿蒙上跑"；CPF-ApplicationTPC 和各社区负责"框架之上跑应用所需要的三方库"；CJMP 则是一条更长期的路线——用仓颉语言从引擎层开始自研。
二、生态数据：13 个组织，1610 个仓库，8461 Star
把 13 个组织的公开仓库全量拉一遍（AtomGit API GET /orgs/{org}/repos，2026-09-05），得到这张图：
几个值得记住的数字：
- 总量：13 个组织、1610 个公开仓库、8461 Star；其中 8 个框架组织 1051 仓 / 8267★，5 个运营社区 559 仓 / 194★。
- 头部仓库：flutter_flutter 单仓 ★1167，是整个跨平台版图的绝对顶流；ohos_react_native ★403、tpc_c_cplusplus ★109、CJMP/Engine ★101。
- 梯队分明：Flutter、RN 是第一梯队（千星组织）；ApplicationTPC、KMP-CMP 是高速成长期（千星左右、仓库增速快）；Cordova/Ionic/Electron 是稳定维护期；CJMP 最年轻但增速可观。
口径说明：仓库数与 Star 为采集时点数据，会随时间自然增长；本文所有数字的采集与复核过程见文末"数据与出处"。
三、逐条路线看：进度到哪了、重点仓库是哪些
3.1 Flutter：五条版本线并行，跟进上游提速到 4 个月
flutter_flutter 是 Flutter SDK 与 Engine 的 OpenHarmony 适配版，开发体验与官方 Flutter 一致：
flutter create --platforms [ohos,android,ios] MyApp
flutter build hap --release --target-platform ohos-arm64
版本进度（git tag 实测，2026-09-05）：
| 版本线（tag） | 基于上游 | 状态 |
|---|---|---|
| 3.41.10-ohos-1.0.1 | 3.41.9 | 最新稳定线 |
| 3.35.8-ohos-1.0.4 | 3.35.7 | 稳定维护（主仓当前基线） |
| 3.27.5-ohos-1.0.8 | 3.27.4 | 长期维护 |
| 3.22.4-ohos-1.1.5 | 3.22 分支 | 长期维护 |
| 3.44.9+ohos-0.0.1-canary1 | 3.44 | 预览（Canary） |
更有价值的是官方 README 里给出的版本规划表：Flutter 3.35 的鸿蒙版滞后上游 7 个月（2025/08 → 2026/03），3.41 缩短到 4 个月（2026/02 → 2026/06），3.44 保持 4 个月（2026/05 → 2026/09），3.47 已规划 2026/12 跟进。"追欠账"阶段结束，进入随上游版本列车滚动的节奏，这是衡量一条适配线成熟度最硬的指标。
重点仓库：flutter_flutter（SDK+Engine）、flutter_packages ★262（官方插件库鸿蒙扩展）、flutter_samples（示例 + 环境搭建/构建/升级文档入口）、docs（三方库适配列表）、skills（AI 适配技能）。
三方库生态：官方适配列表已收录 262 个已适配库、110 个适配中，覆盖权限、UI 组件、媒体、位置等领域，每个库都标注了 3.7 / 3.22 / 3.27 / 3.35 各版本线的推荐配套。
3.2 React Native：四条版本线并行维护，存量应用有保障
ohos_react_native（RNOH）为 React Native 添加 OpenHarmony 平台支持，完整支持 Fabric 新架构。版本线上，最新 v0.84.3（2026-08-11），同时 v0.82.33 / v0.77.74 / v0.72.143 三条旧线长期维护——存量 RN 应用无论停在哪个版本，都有对应的鸿蒙化路径。
稳定版获取采用 npm dist-tag 机制，与上游命名习惯对齐：
npm install @react-native-oh/react-native-harmony@0.84-stable
重点仓库：ohos_react_native（框架核心，文档覆盖设计/开发/调测/调优/运维全流程）、usage-docs（三方库接入指南，中英双语）、rn_multidevice_layout_scenepkg ★31（折叠屏/平板多设备适配）、rntpc_* 系列（svg、webview、tts、safe-area-context 等三方库适配）。
一个容易被忽略的亮点：RNOH 的语料已进入 Gemini、DeepSeek、GLM 等主流 AI 模型——把报错堆栈 + RNOH 版本 + 设备型号喂给 AI，就能得到质量不错的根因分析。
3.3 KMP / CMP：2026 年内走完 beta → 1.0 正式版
CPF-KMP-CMP 的目标是把 Kotlin Multiplatform 与 Compose Multiplatform 的开发体验带入鸿蒙：一套 Kotlin 代码编译为 Android / iOS / HarmonyOS 三端产物。
版本进度（这是 2026 年最重要的里程碑之一）：
- KMP v2.2.21-1.0.0 正式版 ＋ CMP v1.9.2-1.0.0 正式版（beta1 0.3.0 → beta2 0.4.0 → 1.0.0，一年内完成三级跳）
- 运行要求 HarmonyOS API 17+，开发环境 Windows / macOS / Linux
重点仓库：docs ★65（文档中心，含贡献指南与 pre-commit 死链检查）、compose-multiplatform-core ★44（CMP UI 核心）、kotlin ★43（编译器与工具链）、akinterop ★37（Kotlin Native ↔ ArkTS 互操作）、kmp-cmp-example ★34（官方示例工程，入门最佳起点）、ohos-kmp-toolchain ★25（Android Studio 插件：模板/构建/推包）。
工具链体验是这条路线的卖点：在 Android Studio 里装 Kotlin + KMP 插件 + 离线 KMP 工具链插件，Gradle Sync 后直接运行到鸿蒙模拟器/真机。
3.4 CJMP：仓颉原生跨平台，从 0 到 1
CJMP（Cangjie MultiPlatform）是版图里唯一的"自研引擎 + 仓颉前端"路线，定位是"支持 UI + 逻辑的高性能跨平台开发框架，多 UI 前端支持"。当前进度：OpenSDK v0.2.2（2026-05-09 发布，Windows / macOS 分支可下载），Engine release-v0.2.3。
它的仓库体系值得完整看一遍：Engine（多前端适配层 / UI 组件 / 渲染管线 / 图形引擎 / 执行引擎 / 平台适配层）、CJFrontend（仓颉 UI 前端）、SystemLibs（统一抽象系统能力接口，三端一致 API）、Tools / IDE-Plugins / DevTools / Test / OpenSDK / Build / Manifest，以及 Community（SIG 例会材料公开）。
两个前瞻性信号：一是 AI 原生——VibeCoding 仓提供 AI IDE 配置（MCP / Skills / Rules），AIDev 沉淀可复用协作规范，从第一天就为 AI 编程环境设计；二是治理开放——SIG 例会材料在 Community 仓公开，外部开发者可以旁听、认领任务。适合关注长期趋势的开发者提前布局。
3.5 Web 系三条路径：Cordova / Capacitor / Electron
| 路线 | 核心仓 | 最新版本（tag 实测） | 基于上游 | 上游最新 |
|---|---|---|---|---|
| Cordova | cordova-openharmony | 14.0.1-ohos-14.0.2-release（2026-07-23） | cordova-android@14.0.1 | 15.1.0 |
| Ionic / Capacitor | openHarmony-capacitor | 2.1.15-ohos-2.1.16-release（2026-07-18） | @capacitor/android@8.0.0 | — |
| Electron | Electron | v37.2.1（2026-04-20） | Electron 37 | 44.2.0 |
几个细节：cordova-openharmony 的接口与 Cordova Android/iOS 版本兼容（npm 包 @cordova-ohos/ohos）；openHarmony-capacitor 要求 OpenHarmony 5.0+，底层是 C/C++ 自研实现 + 自研 Socket TCP/IP 栈解决跨域访问，支持 ArkTS 与 C/C++ 双侧插件开发；Electron 路线 34 / 37 双线维护，OHOS 全量 API 索引 1294 个 API、66 个模块，自编译门槛较高（Ubuntu 22.04、200G 磁盘、32G 内存）。
3.6 三方库底座：所有路线共享的生态层
CPF-ApplicationTPC 解决的是"框架之上"的问题——166 个仓库、1642 Star，图片、网络、视频、图表、WebRTC 等常用能力的大量鸿蒙化实现都出自这里，无论你用哪条跨平台路线。
- tpc_c_cplusplus ★109：C/C++ 三方库交叉编译适配框架 lycium，覆盖 cmake / configure / make 三种构建方式，是 C/C++ 库鸿蒙化的标准工具；
- 明星库：ImageKnife ★81（图像加载缓存）、openharmony_tpc_samples ★76（可直接使用的示例集）、ohos_ijkplayer ★54（视频播放）、ohos_webrtc ★44（实时通信）、aki ★38（JS ↔ C/C++ 绑定）、ohos_axios ★35、lottieArkTS ★34、ohos_mpchart ★32。
加上 hxa-* / oh-* 五个运营社区（559 仓），构成了三方库鸿蒙化的批量生产线——这也是个人开发者参与共建门槛最低的入口。
四、一页看全：版本进度总表
| 路线 | 鸿蒙最新版本 | 基于上游 | 上游最新 | 说明 |
|---|---|---|---|---|
| Flutter | 3.41.10-ohos-1.0.1（另有 3.44.9 canary） | 3.41.9 等 5 条线 | 3.47.2 | 3.47 鸿蒙版规划 2026/12 |
| RN | v0.84.3（2026-08-11） | RN 0.84 | 0.87.1 | 0.72/0.77/0.82 长期维护 |
| KMP | v2.2.21-1.0.0 正式版 | Kotlin 2.2.21 | 2.4.10 | beta→1.0.0 于 2026 年内完成 |
| CMP | v1.9.2-1.0.0 正式版 | CMP 1.9.2 | 1.12.0 | HarmonyOS API 17+ |
| CJMP | OpenSDK v0.2.2 / Engine v0.2.3 | 自研（仓颉） | — | 2026-05 发布 SDK |
| Cordova | 14.0.1-ohos-14.0.2-release | cordova-android 14.0.1 | 15.1.0 | 接口兼容 Android/iOS |
| Capacitor | 2.1.15-ohos-2.1.16-release | @capacitor/android 8.0.0 | — | OpenHarmony 5.0+ |
| Electron | v37.2.1 | Electron 37 | 44.2.0 | 34/37 双线维护 |
从这份数据里读出三个信号：
- 跟上上游的速度在变快。Flutter OH 的跟进间隔从 7 个月缩短到 4 个月，3.44 canary 已发出——鸿蒙化从"追历史欠账"进入"随版本列车滚动"阶段。
- KMP/CMP 一年内走完 0 → 1.0。工具链（Android Studio 插件）、互操作（akinterop）、渲染（fusion-render）配套齐全，进入可用、可投产阶段。
- 仓颉原生路线从 0 到 1。唯一的自研引擎路线，SDK 已可下载，SIG 例会公开，且原生内置 AI 协作资产。
怎么选？ 存量 Flutter / RN 应用优先跟进对应版本线升级；新项目逻辑复用优先选 KMP，想要声明式 UI + Kotlin 选 CMP；Web 团队低成本迁移走 Cordova / Capacitor；桌面场景用 Electron；愿意与框架共同成长的看 CJMP。
五、怎么学：每条路线的入口、文档与示例
- Flutter：从 flutter_samples 的
docs/ohos/getting-started环境搭建开始 → 应用构建指南 → 查 docs/ThirdpartyLibrarites.md 选库（262 个已适配）→ 升级指南。 - RN：ohos_react_native 的
docs/zh-cn（环境搭建 → 编译构建）→ SDK 版本配置指导 → usage-docs 接三方库 → 性能调优与稳定性分析方法。 - KMP/CMP：装 Android Studio（JDK 17）+ Kotlin/KMP 插件 + KMP 工具链插件 → 跑通 kmp-cmp-example → 通读 docs（入门 → UI 开发 → 深入开发）→ akinterop 互操作。
- CJMP / TPC：CJMP/Docs 的应用开发者与框架开发者两条快速入门 → OpenSDK 下载 → C/C++ 库走 tpc_c_cplusplus 的 lycium 交叉编译 → 抄 openharmony_tpc_samples 的示例。
六、一起共建：开发者可以参与的 6 件事
- 三方库适配：从 hxa-* / oh-* 社区认领未适配库；Flutter 侧参照 skills 仓的 AI 适配技能，RN 侧参照 usage-docs 接入指南，成果登记进官方适配列表。
- Issue 反馈与修复：flutter_flutter / ohos_react_native / compose-multiplatform-core 都接受 issue 与 PR；RNOH 提供了稳定性与性能问题的标准分析方法论。
- 案例与示例：把迁移经验沉淀为示例——kmp-cmp-example、openharmony_tpc_samples、flutter_samples 都接受案例共建。
- 文档与翻译：CPF-KMP-CMP/docs 有明确贡献指南；usage-docs 中英双语需要翻译共建。
- AI 协作资产：CPF-Flutter/skills、CPF-RN/skills、CJMP 的 VibeCoding（MCP / Skills / Rules）与 AIDev——贡献你的 AI 编程工作流，这是最年轻的共建方向。
- SIG 例会与社区：跨平台框架 SIG 例会材料与纪要在 CJMP/Community 公开，旁听和认领任务的最直接入口。
社区已于 2026 年 6 月发布《跨平台框架白皮书》（22 家单位、87 位贡献者）；本系列直播 + 文章 + 电子书的内容共建也已启动，欢迎认领后续选题。
七、 引用
- 版本号：以各仓库 git tag 与官方 README 版本章节为准（flutter_flutter README 版本规划、RNOH README、CPF-KMP-CMP/docs README、CJMP/Docs README、CJMP/OpenSDK 版本表）；
- Flutter 三方库数据：官方适配列表表格行统计（已适配 262 / 适配中 110）；
- 上游版本：Flutter 官方 releases（stable 3.47.2）与 facebook/react-native、JetBrains/kotlin 等仓库 releases；
- Electron 说明：文中 v37.2.1 为 CPF-Electron/Electron 仓库最新 tag；活动推荐矩阵中的 v40.1.0 为另一口径，两者不冲突。
一站式 AI 云服务平台
更多推荐
3
0- 0
已为社区贡献1条内容
所有评论(0)