Flutter 鸿蒙化迎来＂大搬家＂

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_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 远程仓库地址

如果你已经克隆了旧仓库的本地代码，直接执行以下命令替换远程地址即可，无需重新克隆：

git remote set-url origin <新仓库地址>

Step 2：修正项目依赖引用

如果你的项目通过 Git 路径依赖引用了旧仓库资源，请将所有旧地址批量替换为 CPF-Flutter 新仓库地址，避免依赖拉取失败。

Step 3：迁移 Issue 与 PR

旧仓库已停止维护，未解决的 Issue 和待合并的 PR 需要在对应新仓库重新提交。不过 Engine 编译依赖仓库支持临时重定向，可以平滑过渡。

Step 4：查询已适配三方库

如需查找已鸿蒙化适配的 Flutter 插件，可直接访问 CPF-Flutter 组织主页（https://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 组织主页：https://atomgit.com/CPF-Flutter
• • Flutter 引擎仓库：https://atomgit.com/CPF-Flutter/flutter_engine
• • Flutter SDK 仓库：https://atomgit.com/CPF-Flutter/flutter_flutter
• • 官方示例仓库：https://atomgit.com/CPF-Flutter/flutter_samples

Flutter 鸿蒙生态正在加速成熟，你准备好了吗？欢迎在评论区分享你的看法和迁移过程中遇到的问题。