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

相关推荐
龙佚1 小时前
抖动缓冲与播放控制:平滑播放的艺术
前端·架构
仿生狮子1 小时前
🎼 从文本到交互界面——GenUI 的中庸之道
前端·vue.js·markdown
wuhen_n1 小时前
LangChain 核心:Chain 链式调用实现复杂 AI 任务
前端·langchain·ai编程
往上跑山1 小时前
【Agentic RL / 强化学习 / OPD】OpenClaw-RL 源码阅读
前端
文心快码BaiduComate2 小时前
从个人效能到组织资产:文心快码企业版Agent Hub上线,提升团队AI编程效能
前端·后端·程序员
咖啡星人k2 小时前
从需求到交付:我用MonkeyCode的AI Agent完成了一个React数据看板
前端·人工智能·react.js·monkeycode
sxlishaobin2 小时前
linux 自动清除日志 脚本
linux·服务器·前端
ZC跨境爬虫2 小时前
跟着 MDN 学CSS day_37:(从文档流到粘性定位的底层原理)
前端·javascript·css·ui·html
IccBoY2 小时前
NVM超详细全解教程:解决Node版本冲突(Win/Mac/Linux安装+使用+踩坑合集)
前端·node.js