文档开发者中心
我的
|

HarmonyOS 6

HarmonyOS 5

【SDK 版本兼容性】鸿蒙 Flutter SDK (dev 分支) Dart 版本过低 (2.19.6),导致无法使用 Flutter 3.0+ 版本的社区插件

问题描述

1. 环境信息

  • 操作系统: macOS 15.4 (Intel)

  • Flutter SDK: OpenHarmony-Sig / flutter_flutter (dev 分支)

  • 本地 Dart SDK: 2.19.6

  • DevEco Studio 版本: 6.1.0 Release

  • API 版本: API 10 / 11

2. 复现步骤

  1. 使用 fvm 或 git clone 接入 openharmony-sig 的 flutter_flutter 仓库 dev 分支。

  2. 创建或打开一个包含常规插件依赖(如 flutter_lints: ^3.0.0)的 Flutter 项目。

  3. 执行 flutter pub get。

3. 预期结果

项目能够正常解析依赖,并支持 Dart 3.x 语法及相关三方库。

4. 实际结果

依赖解析失败,报错信息显示:

Because [project_name] depends on flutter_lints >=3.0.0 which requires SDK version >=3.0.0 <4.0.0, version solving failed.

目前的 dev 分支 Dart SDK 固定在 2.19.6,远滞后于官方当前主流的 3.x 版本,导致大量依赖 Flutter 3.0 生态的插件无法集成,严重限制了存量 Flutter 项目向鸿蒙端迁移的效率。


改进建议

  1. 升级基座: 建议将 dev 分支的 Flutter 基座尽快升级至官方 3.10 或 3.22 以上版本。

  2. 多版本并行: 如果 API 10 必须绑定旧版 SDK,建议社区提供专门的 dev_v3 分支,用于适配 Dart 3.x 的项目需求。

点赞
收藏
回复
5
分享
举报
浏览360 发布于2026-05-08 06:40江苏
全部评论
最多点赞
最新发布
最早发布
|
技术支持

您好,目前已有支持3.0以上版本dart的flutter sdk,目前支持 3.7、3.22、3.27、3.35版本flutter,后续版本适配计划可以参考Flutter-OH版本演进规划和分支策略。
也有支持各版本的flutter_lints等三方库

3
2楼回复于2026-05-12 01:36 来自广东
  • 赤心Online

    Flutter 3.7.12-ohos-1.0.4 • channel dev • https://gitee.com/openharmony-sig/flutter_flutter.git

    Framework • revision fcd9993d96 (1 year, 3 months ago) • 2025-02-20 10:51:28 +0000

    Engine • revision 1a65d409c7

    Tools • Dart 2.19.6 • DevTools 2.20.0

    2026-06-05 05:43 来自浙江
  • 赤心Online

    您好,感谢您的耐心解答。但我发现我们之间对“版本”的理解存在一个核心技术错位:

    我反馈的根本问题不是 Flutter 的版本,而是 Dart SDK 的版本。

    1. 核心技术矛盾: 在 Flutter 官方生态中,Flutter 3.0+ 强绑定了 Dart 3.x。但是,目前你们仓库默认的 dev 分支,虽然可能魔改支持了部分 Flutter 3.x 的渲染特性,但其内部集成的 Dart SDK 依然被锁死在 2.19.6。

    2. 导致的灾难性后果: 现代 Flutter 社区的三方库(如 flutter_lints: ^3.0.0 及大量主流插件)在 pubspec.yaml 中都强制要求 sdk: ">=3.0.0 <4.0.0"。由于 dev 分支的 Dart 版本是 2.19.6,导致项目在执行 flutter pub get 时直接在环境检查阶段报错崩溃,根本无法引入任何现代社区生态。

    我的核心诉求是: 既然您提到官方已经支持了 Flutter 3.22 / 3.27 / 3.35,那么这些高版本分支里集成的 Dart SDK 是否已经真正升级到了 Dart 3.x(例如 Dart 3.22.x)?

    如果已经升级,请直接告诉我**具体哪一个 Git 分支名(或 Tag)**拥有 Dart 3.x 的环境?

    2026-06-05 05:44 来自浙江
  • 云帆扬回复赤心Online
    您好,可以下载各版本的flutter sdk进行查看,下载之后查看 flutter_flutter/bin/cache/dart-sdk/version即可查看配套的dart版本。
    flutter3.7.12对应2.19.6
    flutter3.22.0对应dart3.4.0
    flutter3.27.5对应dart3.6.2
    flutter3.35.7对应dart3.9.2
    2026-06-11 01:49 来自广东
学习了
1楼回复于2026-05-11 03:30 来自广东
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

目录 收起
问题描述
1. 环境信息
2. 复现步骤
3. 预期结果
4. 实际结果
改进建议
了解社区公约,与您携手共创和谐专业的开发者社区。