docs:基于 Flutter 技术的鸿蒙生态应用开发项目

Star0
0
代码
代码
Issues
Pull Requests
项目讨论
Wiki
分析
Star0
0

OpenHarmony-Flutter用于汇集、维护Flutter在OpenHarmony平台上适配的SDK、引擎与三方库。帮助应用开发者使用一套代码在OpenHarmony上进行应用开发。

分支1Tags0
文件最后提交记录最后更新时间
sig-minutes
docs:补充添加2026年第一次sig组会议纪要
4 个月前
OrganizationDescription.en.md
update: update organization description and README Signed-off-by: 坚果 <jianguo@nutpi.net>
4 个月前
OrganizationDescription.md
update: update development guide link in OrganizationDescription Co-Authored-By: AtomCode (GLM-5.1) <jianguo@nutpi.net> Signed-off-by: 坚果 <jianguo@nutpi.net>
4 个月前
README.md
docs: update README Signed-off-by: HHHxm2 <huangxingming2@huawei.com> AI[0%] Human Fixed[0%] Human[100%] AI Adopted[0%] Signed-off-by: HHHxm2 <huangxingming2@huawei.com>
2 个月前
ThirdpartyLibrarites.en.md
修改文档 Signed-off-by: dqh0334 <daiqinghui2@h-partners.com>
3 个月前
ThirdpartyLibrarites.md
修改文档 Signed-off-by: dqh0334 <daiqinghui2@h-partners.com>
3 个月前

Flutter for OpenHarmony

将 Flutter 开发体验完整带入鸿蒙生态（OpenHarmony / HarmonyOS）。基于官方 Flutter SDK 与自渲染 Engine 的 OpenHarmony 适配，让 Flutter 应用无缝运行于鸿蒙设备，性能接近原生。本仓库项目均由原 Flutter 官方社区 Fork 并扩展 OHOS 平台实现，建议应用在 OHOS 平台使用该组织项目版本产物编译，其余平台使用原社区版本产物编译。

仓库迁移公告：Flutter 鸿蒙化相关仓库已整体迁移至 CPF-Flutter 组织（本组织）。旧组织仓库将不再维护，请及时更新远程地址和依赖引用。详情参见：迁移公告

License Flutter OH SDK Flutter OH Docs

目录

项目简介

Flutter for OpenHarmony 是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 官方社区适配版本，由 OpenHarmony-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈（Dart 语言 + 自渲染引擎）开发 OpenHarmony / HarmonyOS 应用，亦可基于源码构建支持 OpenHarmony 的 Flutter Engine。

核心特性：

  • 使用 Dart 语言及 Flutter 生态组件直接构建鸿蒙应用，一套代码多端运行
  • 自渲染引擎（Impeller / Skia）独立绘制，性能接近原生，覆盖移动与桌面场景
  • 完整混合开发能力：FlutterPage、FlutterEntry、FlutterEngineGroup 多引擎、PlatformView 同层渲染
  • 支持纯 Flutter 应用与 Add-to-App 两种集成方式
  • 适配鸿蒙特有能力：多设备响应式 DPI、分栏布局、外接纹理、LTPO 等
  • BSD 协议开源，与上游 Flutter 版本持续对齐

快速链接

资源 地址
Flutter OH SDK 与 Engine 仓库 gitcode.com/CPF-Flutter/flutter_flutter
Flutter OH 开发示例与文档 gitcode.com/CPF-Flutter/flutter_samples
Flutter OH 三方库适配仓库 gitcode.com/CPF-Flutter/flutter_packages
OpenHarmony 平台已适配三方库列表 gitcode.com/CPF-Flutter/docs · ThirdpartyLibrarites
版本规划与分支策略 Flutter OH 版本规划 Wiki
Flutter 官方开发指南与 API 文档 docs.flutter.dev

跨平台框架技术选型

为破解原生开发痛点，行业持续迭代演进跨平台技术方案，主流框架已形成多元格局：

  • 基于 Web 技术的跨端方案：如 uni-app、Electron、各类小程序框架，延续 BS 架构优势并适配移动生态
  • React Native：通过 DSL 描述 UI 并采用原生组件渲染，提升性能与原生 API 调用体验
  • Flutter：以 Dart 语言与自渲染引擎为核心，实现接近原生的性能表现并覆盖移动与桌面场景
  • Kotlin Multiplatform（KMP）与 Compose Multiplatform（CMP）：以逻辑跨端为突破，叠加 UI 跨端能力，获得企业级开发者广泛认可

详情请参见：开源鸿蒙跨平台框架社区正式发布《跨平台框架白皮书》

版本规划与分支策略

稳定版本

推荐基于版本tag获取稳定版本，版本tag格式如下：

  • 3.7.12-ohos-X.X.X: 基于上游社区3.7.12分支适配OpenHarmony的X.X.X版本。
  • 3.22.1-ohos-X.X.X: 基于上游社区3.22.0分支适配OpenHarmony的X.X.X版本。
  • 3.27.5-ohos-X.X.X: 基于上游社区3.27.4分支适配OpenHarmony的X.X.X版本。
  • 3.35.8-ohos-X.X.X: 基于上游社区3.35.7分支适配OpenHarmony的X.X.X版本。

版本规划

Flutter 版本 源社区发布时间 鸿蒙版本发布时间 间隔时间
Flutter 3.35 2025/08 2026/03 7个月
Flutter 3.41 2026/02 2026/06 4个月
Flutter 3.44 2026/05 2026/09 4个月
Flutter 3.47 2026/08 2026/12 4个月

注：以上时间为预估，实际发版可能会根据质量验收情况及交付规划微调。

详情请参见：Flutter OH 版本规划与分支策略

相关文档

Flutter OH 配套文档位于 flutter_samples 仓库，覆盖从快速入门到性能调优、调试调测的全流程实践。

三方库适配

flutter_packages 基于 Flutter 社区官方插件库（flutter/packages）扩展，新增对 OpenHarmony 平台的兼容适配。开发者可通过 Git 仓库引入适配后的插件，以最小化业务改动获得完整的 OpenHarmony 原生能力支持。

已适配核心三方库

按三方库聚合，列出每个 Flutter SDK 版本对应的推荐版本。链接指向对应的发布 Tag 或分支（无 Tag 的标为「分支」）。

序号 原库名 Flutter 3.7 Flutter 3.22 Flutter 3.27 Flutter 3.35
1 pigeon 14.0.0 21.2.0 * 25.3.2 26.1.5
2 file_selector 1.0.1 1.0.3 1.0.3 1.1.0
3 image_picker 1.0.4 1.1.2 1.1.2 1.2.1
4 animations — — 2.0.11 * 2.0.11 *
5 url_launcher 6.1.11 6.3.0 6.3.1 6.3.2
6 shared_preferences 2.2.2 2.3.2 2.5.3 2.5.4
7 path_provider 2.1.1 2.1.4 2.1.5 2.1.5
8 local_auth 2.1.6 2.3.0 2.3.0 3.0.0
9 camera 0.10.5+5 0.11.0+2 0.11.1 0.11.3
10 video_player 2.7.2 2.9.2 2.10.0 2.10.1
11 webview_flutter 4.4.2 4.8.0 4.13.0 4.13.0
12 in_app_purchase 3.1.11 3.2.0 3.2.3 3.2.3

注：* 表示该版本仅有 release 分支，未发布 Tag；— 表示该 Flutter SDK 版本下未提供适配版本。

另：webview_flutter-v4.4.4（4.4.4 版本）仅在 master 分支 维护。

完整三方库适配列表（含 dev/release 分支信息）：OpenHarmony 平台已适配三方库列表 三方库问题请在对应仓库提交 issue；三方库适配请求请至 CPF-Flutter/docs 提交 issue。

纯 Dart 三方库

以下三方库为纯 Dart 实现，无需平台适配，OpenHarmony 平台可直接使用：

css_colors、flutter_adaptive_scaffold、flutter_image、flutter_lints、flutter_markdown、flutter_migrate、go_router、go_router_builder、metrics_center、multicast_dns、palette_generator、pointer_interceptor、rfw、standard_message_codec、two_dimensional_scrollables、web_benchmarks、xdg_directories

引用方式

适配了 OpenHarmony 的三方库需通过 Git 仓库引入：

dependencies:
  path_provider:
    git:
      url: https://gitcode.com/CPF-Flutter/flutter_packages.git
      path: packages/path_provider/path_provider
      ref: provider-v2.1.5-ohos-1.0.0   # 推荐使用 tag

贡献指南

本仓库采用多分支管理策略，每个三方库版本都有对应的 dev 分支和 release 分支：

分支名 命名格式
dev 分支 br_<库名>-v<版本号>_ohos_dev
release 分支 br_<库名>-v<版本号>_ohos

贡献代码时请基于对应版本的 dev 分支 开发并提交 PR；release 分支为发布分支，不接受直接提交 PR。

问题定位

Flutter OHOS 平台的问题定位、稳定性修复与方法论，请参见 Flutter OHOS 问题定位导航。

Flutter OHOS 历史修复汇总

按 Flutter OHOS 版本（3.27 / 3.35 / 3.41）汇总 OHOS 平台已修复的稳定性问题，覆盖崩溃、冻屏、内存、键盘输入、渲染、PlatformView、窗口屏幕、手势鼠标、输入法文本、LTPO/帧率、Plugin/Channel 等 12 大类问题。数据来源于 flutter_flutter 与 flutter_engine 两个仓库，3.35 之前分仓维护，3.35 之后合仓。

👉 详情参见：Flutter OHOS 历史修复汇总

Skill 资源汇总

来源 链接
CPF-Flutter Skill 总仓库 gitcode.com/CPF-Flutter/skills
flutter_samples 文档配套 Skill docs/ohos/skills

更多常见问题请参见 FAQ

问题交流

Built with ❤️ by OpenHarmony Flutter 社区

项目介绍

OpenHarmony-Flutter用于汇集、维护Flutter在OpenHarmony平台上适配的SDK、引擎与三方库。帮助应用开发者使用一套代码在OpenHarmony上进行应用开发。

Markdown46提交数
定制我的领域
README
规则集