flutter升级导致的旧项目的运行环境问题排查记录

首先先明确下可以运行的大致的环境信息:
java17
gradle7.6.4

Flutter 3.24.5 • channel stable • https://github.com/flutter/flutter.git
Framework • revision dec2ee5c1f (11 months ago) • 2024-11-13 11:13:06 -0800
Engine • revision a18df97ca5
Tools • Dart 3.5.4 • DevTools 2.37.3

开发IDE: VS Code

事情起因就是flutter在新项目使用时，如何你的flutter有最新版本了，
就会建议你更新，但是你如果通过flutter upgrade命令进行更新后，
因flutter sdk不同版本会有语法改动，就会导致旧项目构建失败或启动不起来。

这时就需要排查构建工具(如Gradle)、JDK、Flutter、Dart、依赖库版本等。

问题一：Error: A value of type 'CardThemeData' can't be assigned to a variable of type 'CardTheme'.

Flutter/PubCache/hosted/pub.flutter-io.cn/getwidget-4.0.0/lib/components/card/gf_card.dart:118:43: Error: A value of type 'CardThemeData' can't be assigned to a variable of type 'CardTheme'.
 - 'CardThemeData' is from 'package:flutter/src/material/card_theme.dart' ('Flutter/SDK/flutter_windows_3.27.1-stable/flutter/packages/flutter/lib/src/material/card_theme.dart').
 - 'CardTheme' is from 'package:flutter/src/material/card_theme.dart' ('Flutter/SDK/flutter_windows_3.27.1-stable/flutter/packages/flutter/lib/src/material/card_theme.dart').
    final CardTheme cardTheme = CardTheme.of(context);
                                          ^
Target kernel_snapshot_program failed: Exception

错误原因
这是由于flutter版本升级了，第三方库getwidget库不兼容新版本的语法导致的问题。
解决方法：降级Flutter版本或者升级getwidget库版本。

问题二：VS Code配置项目的开发环境

打开设置页面：文件 -> 首选项 -> 设置

配置Flutter SDK位置：
image
点击在settings.json中编辑后，
在打开的json文件里，添加上自己的sdk目录，如

{
    ...,
    "java.import.gradle.java.home": "C:\\JDK\\OracleJDK\\jdk-17.0.2",
    "java.home": "C:\\JDK\\OracleJDK\\jdk-17.0.2",
    "dart.flutterSdkPath": "E:\\Flutter\\SDK\\flutter_windows_3.24.5-stable\\flutter"
}

建议使用Android Studio/jbr的Java sdk，省去额外安装 JDK 的麻烦，又能保证与 Android 构建工具链完全兼容。
如："java.import.gradle.java.home": "C:/Program Files/Android/Android Studio/jbr"

附录

posted @ 2025-10-23 10:22  星小梦  阅读(7)  评论(0)    收藏  举报