oh-flutter 开源社区迁移公告：全新 atom-flutter 组织正式上线

发布日期：2026 年 7 月 1 日
生效日期：迁移完成后立即生效
旧组织：oh-flutter（鸿蒙系统 Flutter 开源库社区）
新组织：atom-flutter（鸿蒙系统 Flutter 开源库社区）

仓库迁移公告 oh-flutter 所有相关仓库已整体迁移至 atom-flutter 组织。旧仓库将不再维护，请及时更新远程地址和依赖引用。详情参见：迁移公告

概述

鸿蒙版 Flutter 社区迎来重要升级！为进一步规范社区治理、统一资源入口、提升开发者协作体验，社区已在 AtomGit 平台正式搭建 atom-flutter 专属组织，并完成 100 个核心仓库的全量迁移与整合。

本次迁移覆盖社区文档、三方库适配资源、三方插件库、示例项目及工具链等全量资源，为开发者提供更规范、高效、便捷的鸿蒙 Flutter 开发与协作环境。

一、迁移背景

1.1 为什么要迁移？

自 2025 年 9 月社区成立以来，鸿蒙版 Flutter 社区已在 AtomGit 平台积累了 100+ 个仓库，涵盖三方库鸿蒙化适配、社区文档、示例项目、查询工具等丰富资源，吸引了 114+ 位关注者与 28+ 位活跃贡献者参与共建。

随着社区生态持续扩张，为进一步实现：

• 统一品牌标识：采用更具辨识度的 atom-flutter 组织名称，与 AtomGit 平台深度协同
• 规范社区治理：建立统一的资源入口、Issue 反馈渠道与贡献流程
• 降低使用门槛：简化仓库查找、依赖引用与问题求助路径
• 保障生态稳定：建立标准化的版本管理与持续维护机制

社区决定将原 oh-flutter 组织下的全部仓库，整体迁移至全新 atom-flutter 组织。

1.2 atom-flutter 组织定位

atom-flutter 是致力于将 Flutter™ 生态适配到鸿蒙平台的开放社区组织，帮助具备 Flutter 技术栈的企业或个人开发者，快速将已上架的应用或即将开发的应用构建适配到鸿蒙平台。

社区理念：共建生态，各显其长

• 📝 文档贡献者：完善指南、优化模板、编写教程
• 💻 代码贡献者：适配三方库、修复问题、开发新功能
• 🎨 设计贡献者：优化界面、提升体验
• 🧪 测试贡献者：验证功能、发现问题
• 📢 推广贡献者：分享经验、布道技术

二、核心迁移详情

2.1 迁移范围总览

2.2 社区基础设施仓库

2.3 示例 / Demo 项目

2.4 重要说明

• ✅ 迁移后，所有提交记录、分支、标签、Issues 及 Pull Requests 将完整同步至 atom-flutter 组织
• ⚠️ oh-flutter 组织下的旧仓库将全面停止维护，不再接受新的 Issue、PR 与版本更新
• 🔄 迁移期间，部分旧地址可能保留临时重定向能力，但存在更新延迟风险，请尽快切换
• 📌 未来所有社区资源的统一入口、版本管理与贡献协作均在 atom-flutter 组织下进行

三、完整迁移仓库对照表（100 个）

下表按仓库类型排序：社区基础设施 → 三方库/插件（字母序）→ 示例项目

四、开发者快速操作指南（必看）

为确保项目正常编译、依赖更新与后续迭代，请所有开发者尽快完成以下操作：

4.1 更新 Git 远程仓库地址

已克隆旧仓库本地代码的开发者，直接执行以下命令替换远程地址，无需重新克隆项目：

# 通用格式
git remote set-url origin https://atomgit.com/atom-flutter/<仓库名>.git

# 示例：更新 docs 仓库
git remote set-url origin https://atomgit.com/atom-flutter/docs.git

# 验证是否更新成功
git remote -v

4.2 修正项目依赖引用

若 pubspec.yaml 中通过 Git 路径依赖引用了旧仓库，请批量替换组织路径：

# 旧地址（请替换）
# dependency_overrides:
#   some_plugin:
#     git:
#       url: https://atomgit.com/oh-flutter/some_plugin.git

# 新地址
dependency_overrides:
  some_plugin:
    git:
      url: https://atomgit.com/atom-flutter/some_plugin.git

批量替换命令（macOS / Linux）：

# 在项目根目录执行，将 oh-flutter 替换为 atom-flutter
find . -name "pubspec.yaml" -exec sed -i '' 's|atomgit.com/oh-flutter|atomgit.com/atom-flutter|g' {} +
find . -name "pubspec.lock" -exec sed -i '' 's|atomgit.com/oh-flutter|atomgit.com/atom-flutter|g' {} +

4.3 迁移 Issue 与 PR

• 旧仓库已停止维护，未解决的 Issue 和待合并的 PR 请在对应新仓库重新提交
• 迁移期间提交的 Issue / PR 将由维护团队在新仓库跟进处理

4.4 更新文档与外部链接

请检查并更新以下场景中引用的旧组织地址：

• README、Wiki、技术博客中的仓库链接
• CI/CD 流水线中的 Git Clone 地址
• 内部文档、培训材料中的引用链接
• 三方库查询网站（search）中的数据源配置

4.5 快速查询已适配三方库

• 访问 atom-flutter 组织主页
• 访问 Flutter-OH 三方库查询网站
• 在 AtomGit 搜索框检索插件名称，筛选 atom-flutter 组织资源

五、如何访问新仓库？

1. 直接点击上方迁移对照表中的新地址链接
2. 访问 atom-flutter 组织首页：https://atomgit.com/atom-flutter
3. 在 AtomGit 搜索框中输入原仓库名，筛选所属组织为 atom-flutter
4. 查看本迁移公告仓库：https://atomgit.com/atom-flutter/Notice

六、生态后续规划

本次仓库集中迁移，是鸿蒙版 Flutter 社区规范化、规模化发展的重要里程碑。后续社区将持续推进：

• 📦 三方库鸿蒙化适配补齐，持续更新 TPC-Resource 适配清单
• 📚 完善 docs 文档体系，降低新手入门门槛
• 🔧 优化 search 三方库查询工具，提升检索体验
• 🤝 社区贡献体系完善，开放更多新手任务与荣誉激励
• 🎯 丰富官方示例场景，覆盖更多行业落地案例

七、关键链接（建议收藏）

八、联系我们

如有迁移相关问题或建议，可通过以下渠道反馈：

• 📋 在 feedback 仓库提交 Issue
• 💬 加入社区交流群（详见 docs 文档）
• 📧 联系维护团队：xujg@gitcode.com

对于此次迁移带来的不便，我们深表歉意，感谢您的理解与支持！

欢迎广大开发者切换新仓库、积极参与社区共建，携手完善鸿蒙 Flutter 跨平台生态！ 🚀

声明：Flutter 及其相关徽标是 Google LLC 的商标。我们未得到 Google LLC 的认可或附属。