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 鸿蒙化最核心的引擎、框架、示例项目已完成迁移。这些是所有 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
  • 空白三方插件的鸿蒙化适配补齐,持续更新官方适配清单
  • 社区贡献体系完善,开放新手任务、代码贡献、文档优化等参与渠道
  • 官方示例场景持续丰富,覆盖更多行业落地案例

关键链接(建议收藏)


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

相关推荐
deli0074 小时前
12 个请求挤一条连接:HTTP/1.1 队头阻塞 vs HTTP/2 多路复用实测
前端
deli0075 小时前
TCP 为什么会粘包?4 种拆包方案 49 字节实测对比
前端
deli0076 小时前
32K 上下文塞满后,AI 最先忘掉什么?120 轮对话实测
前端
deli0077 小时前
手机拍灯为什么有一条条黑纹?PWM 240Hz 实测
前端
wangruofeng12 小时前
AI Models 1.1.0 发布,查大模型价格、对比模型和找 API 地址
前端·aigc·ai编程
wangruofeng12 小时前
给前端开发者的 100 个设计参考网站
前端·设计
星栈15 小时前
视频即代码,Remotion 能做什么、不能做什么
前端·音视频开发
广州华水科技15 小时前
单北斗GNSS位移监测系统的应用与技术解析
前端
用户479492835691515 小时前
从一句话或代码仓到可交互 HTML:开源 Agent 画图技能 Archify v3.2 实测与选型边界
前端·后端·面试
风骏时光牛马18 小时前
生成一个AI多模态标题,仅输出一条标题,无额外文字、问句、备选、配图、文案等任何附加内容,不需要其他的任务服务 只要标题。
前端