CPF-Flutter

CPF-Flutter

1、CPF-Flutter(Cross-Platform Framework Flutter) 是汇集 Flutter 中国社区的框架及三方插件,主要包含openHarmony适配的框架、Engine、官方插件以及主流的三方插件,帮忙开发者快速在openHarmony 开发Flutter应用。 2、CPF-Flutter由跨平台框架PMC下属的Flutter SIG主导,欢迎您使用及参与贡献。

README

Flutter for OpenHarmony (Flutter-OH)

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

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

License Flutter OH SDK Flutter OH Docs

跨平台框架技术选型

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

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

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

最新通知

📣 Flutter OH 3.41.9 Release 版本已发布,请从下方表格获取 SDK 体验使用。

稳定版本

下表为已发布并维护的 OpenHarmony 适配稳定版本,推荐基于版本 tag 获取。建议开发者优先使用最新稳定版本,以获得更完整的功能支持与持续的问题修复。

源社区版本 OpenHarmony 适配最新稳定版本 更早版本
Flutter Version Flutter Version Flutter Version
Flutter Version Flutter Version Flutter Version
Flutter Version Flutter Version Flutter Version
Flutter Version Flutter Version Flutter Version
Flutter Version Flutter Version Flutter Version

上述版本基于源社区版本扩展适配 OHOS平台,完整版本与分支策略详见 版本演进规划与分支策略;为获取最新社区修复,其他平台推荐使用源社区 Flutter SDK。

版本规划

适配版本按季度跟进源社区 Flutter 版本,力争将相对源社区的发布滞后从约 7 个月缩短至 4 个月:

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

以上时间为预估,实际发版视质量验收与交付规划可能微调;完整路线图详见 2026 Flutter-OH 路线图。

SDK 与引擎

仓库 说明
flutter_flutter 适配 OpenHarmony 的 Flutter SDK
flutter_engine 适配 OpenHarmony 的 Flutter Engine

3.35 及以上版本仅需 flutter_flutter(SDK 与 Engine 已合仓);3.27、3.22、3.7 版本的 Engine 另见 flutter_engine。

插件

仓库&资源 说明
flutter_packages 适配 OpenHarmony 的 Flutter 官方插件
三方库适配列表 适配 OpenHarmony 的社区三方库

示例与资源

仓库&资源 说明
开发文档 配套文档
flutter_samples 示例代码
问题定位 常见问题与排查指南
skills Flutter 鸿蒙开发与适配的 Skill

共建社区

Pinned
1.26 K

本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本,由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用,3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。

169

本仓库基于 Flutter 官方 samples 进行拓展,提供 OpenHarmony 平台适配示例及配套文档,覆盖应用开发、平台能力接入与工程实践。开发者可通过本仓库快速了解 OpenHarmony Flutter 开发流程,并参考示例实现细节进行实践与验证。

46

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

297

本仓库基于 Flutter 社区官方插件库 (flutter/packages) 进行扩展,新增对 OpenHarmony(鸿蒙)平台的兼容适配。通过本仓库,开发者可在 Flutter 应用中无缝集成常用插件,通过最小化业务改动获得完整的 OpenHarmony 原生能力支持。

61

可帮助开发者提升 Flutter 三方库鸿蒙适配及框架使用效率,提供环境配置、适配必要性检查、接口分析、Demo 生成、代码检查等技能,覆盖适配全流程。

Project Showcase

More >
  • rangers_applog_flutter_plugin是RangersAppLog封装后的flutter插件,支持埋点上报
    Dart
    31
    5
    MIT
    Updated at Jun 11
    Star
  • 基于 just_audio 的 OpenHarmony 适配版,功能丰富的音频播放器,支持 URL/本地文件/资源文件/字节流等多种来源播放
    Dart
    32
    42
    Updated at 2 hours ago
    Star
  • 基于 media_info 的 OpenHarmony 适配版,用于获取媒体文件(视频/音频)的详细信息
    Java
    30
    15
    NOASSERTION
    Updated at Aug 4
    Star
  • 本仓库基于 Flutter 官方 samples 进行拓展,提供 OpenHarmony 平台适配示例及配套文档,覆盖应用开发、平台能力接入与工程实践。开发者可通过本仓库快速了解 OpenHarmony Flutter 开发流程,并参考示例实现细节进行实践与验证。
    Dart
    169
    90
    NOASSERTION
    Updated at 17 minutes ago
    Star
  • 基于 flutter_phone_direct_caller 的 OpenHarmony 适配版,直接拨打电话插件
    ArkTS
    30
    8
    MIT
    Updated at Aug 28
    Star
  • 冒烟测试
    Python
    31
    3
    Updated at 1 hour ago
    Star
  • 基于 flutter_native_timezone 的 OpenHarmony 适配版,获取操作系统本地时区名称和可用时区列表
    ArkTS
    30
    12
    Apache-2.0
    Updated at Sep 8
    Star
  • 本仓库是 Flutter SDK 与 Flutter Engine 的 OpenHarmony 适配版本,由 CPF-Flutter 团队维护。开发者可使用熟悉的 Flutter 技术栈开发 OpenHarmony 应用,3.35.7 及以后的适配版本可基于本仓库源码构建支持 OpenHarmony 的 Flutter Engine。
    Dart
    1.26 K
    347
    BSD-3-Clause
    Updated at 16 hours ago
    Star
  • 生成设备唯一标识符,解决用户设备识别与风控问题(兼容Android ID/IDFA等平台差异)
    ArkTS
    31
    8
    MIT
    Updated at Aug 20
    Star
  • 用户可借助该项目在 Flutter 应用中查找设备上已安装的地图应用,并通过标记或导航功能启动。它支持多种主流地图,提供显示标记和导航方向的核心功能,适配 iOS 和 Android 平台。
    Dart
    30
    22
    MIT
    Updated at 22 days ago
    Star
More >
Achievements
13.24 K
Star
4.91 K
Fork
27.56 M
Download
Common Languages
Dart
Java
C++
Swift