共建鸿蒙 Flutter 生态！三方库查询平台邀你同行

今天要和所有 Flutter-OH 开发者分享一个好消息——我们搭建了专属的鸿蒙版 Flutter 三方库查询平台！在这里，你能快速检索适配鸿蒙系统的各类三方库，轻松搞定文件操作、权限管理、动画效果等开发需求，让项目开发效率翻倍～

生态的繁荣离不开每一位开发者的助力，诚邀你一起为平台添砖加瓦，贡献自己的优质三方库，让更多人受益！以下是具体贡献指南：

如何贡献三方库？

1. Fork 仓库

1. 访问 oh-flutter/search^[1] 仓库
2. 点击右上角「Fork」按钮，将仓库复制到你的账号下

2. 克隆仓库到本地

git clone https://gitcode.com/你的用户名/search.gitcd search

3. 创建新分支

git checkout -b feature/add-your-library-name

4. 添加三方库信息

文档位置

• 中文版：在 pages/Doc/zh/thirdParty/ 目录下创建 your-library-name.md
• 英文版：在 pages/Doc/en/thirdParty/ 目录下创建 your-library-name.md

👉 参考示例目录：https://atomgit.com/oh-flutter/search/tree/main/pages/Doc/zh/thirdParty^[2]

命名规范

• 中英文文件名必须一致（如 flutter_permission_handler.md）
• 文件名使用小写字母+下划线，与库名对应

内容模板（参考 template.md）

---# 基础信息（必填）pub_name: your-library-name          # 库名author: your-name                     # 作者/团队desc: 库的核心功能描述（简洁明了）     # 功能简介readme: https://gitcode.com/...      # 文档地址（推荐GitCode链接）homepage: https://your-site.com      # 库官网（可选）repository: https://gitcode.com/...  # 源码仓库地址license: MIT                          # 开源协议（如MIT、Apache-2.0）# 版本与平台（必填）flutter_version: 3.22.0-ohos         # 适配Flutter版本harmony_version: API20+              # 适配鸿蒙版本（格式：APIxx+）dart_version: 3.8                    # Dart版本Platform: ['Android', 'iOS', 'OHOS'] # 支持平台列表min_flutter_version: 3.22.0-ohos     # 最低兼容Flutter版本（可选）min_harmony_version: API12           # 最低兼容鸿蒙版本（可选，格式：APIxx）# 用户交互与社区（可选）issue_link: https://gitcode.com/.../issues  # 问题反馈链接share_link: https://...                      # 分享链接# 知识库（可选）tags: ['标签1', '标签2', 'Flutter', '鸿蒙']  # 分类标签（便于检索）tutorial_link: https://...                   # 使用教程链接---

5. 字段填写说明

必填字段（缺一不可）

• pub_name：三方库包名（需与实际发布名称一致）
• author：作者姓名或开发团队名称
• desc：简洁描述库的核心功能（无需冗长，突出亮点）
• readme：文档地址（优先提供可直接访问的 GitCode 文档链接）
• flutter_version：适配的鸿蒙版 Flutter 版本（如 3.27.4-ohos）
• harmony_version：适配鸿蒙系统版本（严格遵循 APIxx+格式，如 API20+）
• Platform：支持的平台数组（格式固定为['Android', 'iOS', 'OHOS']，按需增减）

可选字段（丰富库信息）

• 开源协议、Dart 版本、最低兼容版本等，按实际情况填写
• 标签（tags）建议包含功能关键词（如「权限管理」「文件选择」），提升检索精准度
• 教程链接（tutorial_link）可帮助其他开发者快速上手

格式注意事项

• 所有冒号均为英文冒号:，不可使用中文冒号：
• 数组类型字段（Platform、tags）需用[]包裹，元素用英文逗号分隔
• 版本号格式需统一，鸿蒙版本严格遵循「API+数字」规范

共建生态，期待你的加入！

鸿蒙 Flutter 生态的繁荣，始于每一个像你一样的开发者。你贡献的不仅是一个库、一行配置，更是为整个开发者社区种下的一棵树，未来它将为无数项目提供荫蔽。

现在就有一个极佳的起点：为了快速丰富平台内容，我们正系统性地整理官方及社区的优秀资源。你可以从以下两个核心任务中选择你感兴趣的库，开始你的第一次贡献：

• 整理鸿蒙官方适配库：https://atomgit.com/openharmony-sig/flutter_packages
• 收录 pub.dev 上的鸿蒙相关包：https://pub.dev/packages?q=ohos

你的贡献，将获得双重认可：

1. 社区荣誉：你的名字将作为贡献者被永久记录，你编写的使用指南将帮助全球开发者。
2. 实质奖励：成功将上述仓库中的三方库信息添加至本平台，并撰写对应使用介绍文章，即可获得京东卡以示感谢（具体细则可进群咨询，后续会发布征文细节）。

这不仅是整理信息，更是在绘制鸿蒙 Flutter 的“能力地图”。让我们从共享知识开始，逐步走向协同创新。

如果你对流程有任何疑问，或有关于平台建设的任何奇思妙想，欢迎随时与我们交流。一个人的代码可能解决一个问题，但一群人共建的生态能定义一个未来。

🚀 立即行动，从 Fork 仓库开始，成为鸿蒙 Flutter 生态的重要奠基人！

（有意参与或有任何疑问，欢迎通过项目仓库的 Issues 或讨论区联系我们。）

项目地址：https://atomgit.com/oh-flutter/search