CPF-Flutter 组织上线,124个三方库集体迁移
如果你是一名 Flutter 鸿蒙开发者,这条消息还是非常重要的:OpenHarmony Flutter 生态刚刚完成了一次史无前例的"大搬家"。
官方在 AtomGit 平台正式搭建了 CPF-Flutter 专属组织,将原本分散在 openharmony-tpc、openharmony-sig、OpenHarmony-Flutter 等多个组织下的核心引擎、SDK、示例项目和 124 个三方插件库,全部集中迁移到了统一的新组织下。
这意味着什么?简单说:过去那种"找仓库像大海捞针"的日子,终于要结束了。
一、为什么要"搬家"?
先说说背景。Flutter 鸿蒙化适配工作从启动至今,相关资源一直分散托管在多个不同的组织下:引擎在 openharmony-tpc,三方库在 openharmony-sig,示例项目又在 OpenHarmony-Flutter。这是我起初做Flutter鸿蒙化非常头疼的一件事,项目一会东一会西,一会在Gitee上,一会在AtomGit上。
早期社区规模小的时候,这种分散管理还能勉强运转。但随着入局开发者数量持续增长,Flutter 鸿蒙化适配、插件开发、场景落地工作愈发常态化,问题就暴露出来了:
- 项目入口不统一,新手根本不知道该去哪找资源
- 资源查找成本高,一个插件可能要在好几个组织里翻找
- 问题反馈渠道零散,提个 Issue 都不知道该往哪提
- 版本维护不规范,不同仓库的更新节奏完全不同步
2026 年 1 月,OpenHarmony 正式成立了 Flutter SIG 工作组,以开放透明的协作模式统筹推进 Flutter 鸿蒙化的各项工作。这次 CPF-Flutter 组织的建立,正是 SIG 工作组规范化治理的第一步大动作。
二、迁移了什么?
本次迁移覆盖四大类全量资源,规模相当大:
1. 核心基础仓库(openharmony-tpc → CPF-Flutter)
Flutter 鸿蒙化最核心的引擎、框架、示例项目已完成迁移。这些是所有 OpenHarmony Flutter 应用开发的基础依赖,包括:

- flutter_engine:Flutter 引擎鸿蒙适配版
- flutter_flutter:Flutter SDK 框架鸿蒙适配版
- flutter_samples:官方示例项目
2. 全量三方插件库(openharmony-sig → CPF-Flutter)
这是本次迁移的重头戏。原托管在 openharmony-sig 组织下的 124 个 Flutter 三方适配库已整体迁入 CPF-Flutter 组织。目前官方已完成 39+ 主流插件的全版本适配,涵盖:
- 网络请求、本地存储、相机、音视频
- 路由导航、权限管理、UI 动画等高频组件
- 支持 Flutter 3.7、3.22、3.27、3.35、3.41 多版本适配
所有适配插件均已公示版本适配清单,开发者可以根据自己使用的 Flutter 版本按需选用。
三、开发者需要做什么?(操作指南)
⚠️ 注意:所有旧仓库将全面停止维护!
这意味着旧仓库不会再有版本更新和问题修复,所有开发者必须尽快切换到新仓库。以下是具体操作步骤:
Step 1:更新 Git 远程仓库地址
如果你已经克隆了旧仓库的本地代码,直接执行以下命令替换远程地址即可,无需重新克隆:
bash
git remote set-url origin <新仓库地址>
Step 2:修正项目依赖引用
如果你的项目通过 Git 路径依赖引用了旧仓库资源,请将所有旧地址批量替换为 CPF-Flutter 新仓库地址,避免依赖拉取失败。
Step 3:迁移 Issue 与 PR
旧仓库已停止维护,未解决的 Issue 和待合并的 PR 需要在对应新仓库重新提交。不过 Engine 编译依赖仓库支持临时重定向,可以平滑过渡。
Step 4:查询已适配三方库
如需查找已鸿蒙化适配的 Flutter 插件,可直接访问 CPF-Flutter 组织主页(atomgit.com/CPF-Flutter... AtomGit 搜索框检索插件名称,筛选 CPF-Flutter 组织资源即可。
四、我们的看法
作为长期关注 Flutter 鸿蒙生态的团队,我们认为这次迁移的意义远不止"换个仓库地址"这么简单。
首先,这是 Flutter 鸿蒙生态从"野蛮生长"走向"规范化治理"的标志性事件。 2026 年 1 月成立的 Flutter SIG 工作组,加上这次 CPF-Flutter 组织的建立,说明 OpenHarmony 官方正在认真对待 Flutter 生态的长期发展,而不是停留在实验阶段。
其次,124 个三方库的整体迁移和 39+ 主流插件的全版本适配,说明 Flutter 鸿蒙化的生态成熟度已经达到了一个新台阶。 从引擎到 SDK,从官方示例到三方插件,全链条资源已经形成闭环。
最后,结合此前公布的 Flutter-OH 2026 路线图------计划按季度发布版本,将与上游社区的平均滞后时间从约 7 个月缩短到 4 个月------我们可以看到,Flutter 鸿蒙生态正在加速追赶上游社区。对于正在做或准备做鸿蒙适配的 Flutter 开发者来说,现在是一个非常好的入场时机。
五、后续规划
据官方透露,Flutter SIG 工作组后续将依托 CPF-Flutter 组织持续推进以下工作:
- 多版本 Flutter 引擎与 SDK 的持续迭代适配,兼容最新 OpenHarmony 系统 API
- 空白三方插件的鸿蒙化适配补齐,持续更新官方适配清单
- 社区贡献体系完善,开放新手任务、代码贡献、文档优化等参与渠道
- 官方示例场景持续丰富,覆盖更多行业落地案例
关键链接(建议收藏)
- CPF-Flutter 组织主页:atomgit.com/CPF-Flutter
- Flutter 引擎仓库:atomgit.com/CPF-Flutter...
- Flutter SDK 仓库:atomgit.com/CPF-Flutter...
- 官方示例仓库:atomgit.com/CPF-Flutter...
Flutter 鸿蒙生态正在加速成熟,你准备好了吗?欢迎在评论区分享你的看法和迁移过程中遇到的问题。