Flutter项目运行与APK打包失败，遇Theme相关编译错误求助

问题概述 #

本地运行并打包ecard项目为APK时，执行flutter build命令及运行代码均出现编译错误，核心问题是旧依赖包不兼容新版Flutter的Material Design API变更，具体错误点：

• TextTheme类无subtitle2、headline6属性
• ThemeData类无backgroundColor属性
• Theme构造函数不存在toggleableActiveColor命名参数

错误详情 #

/C:/Users/HP/AppData/Local/Pub/Cache/hosted/pub.dev/device_preview-1.1.0/lib/src/views/tool_panel/sections/section.dart:39:40: Error: The getter 'subtitle2' isn't defined for the class 'TextTheme'.
- 'TextTheme' 来自 'package:flutter/src/material/text_theme.dart' ('/D:/flutter/packages/flutter/lib/src/material/text_theme.dart')。
请尝试将名称更正为现有getter的名称，或定义名为'subtitle2'的getter或字段。
style: theme.textTheme.subtitle2?.copyWith(
^^^^^^^^^
/C:/Users/HP/AppData/Local/Pub/Cache/hosted/pub.dev/device_preview-1.1.0/lib/src/views/tool_panel/sections/settings.dart:56:34: Error: The getter 'backgroundColor' isn't defined for the class 'ThemeData'.
- 'ThemeData' 来自 'package:flutter/src/material/theme_data.dart' ('/D:/flutter/packages/flutter/lib/src/material/theme_data.dart')。
请尝试将名称更正为现有getter的名称，或定义名为'backgroundColor'的getter或字段。
color: toolbar.backgroundColor,
^^^^^^^^^^^^^^^
/C:/Users/HP/AppData/Local/Pub/Cache/hosted/pub.dev/device_preview-1.1.0/lib/src/views/tool_panel/sections/settings.dart:87:34: Error: The getter 'backgroundColor' isn't defined for the class 'ThemeData'.
- 'ThemeData' 来自 'package:flutter/src/material/theme_data.dart' ('/D:/flutter/packages/flutter/lib/src/material/theme_data.dart')。
请尝试将名称更正为现有getter的名称，或定义名为'backgroundColor'的getter或字段。
color: toolbar.backgroundColor,
^^^^^^^^^^^^^^^
/C:/Users/HP/AppData/Local/Pub/Cache/hosted/pub.dev/persistent_bottom_nav_bar-5.0.2/lib/neumorphic_package_by_serge_software/neumorphic_card.dart:57:57: Error: The getter 'backgroundColor' isn't defined for the class 'ThemeData'.
- 'ThemeData' 来自 'package:flutter/src/material/theme_data.dart' ('/D:/flutter/packages/flutter/lib/src/material/theme_data.dart')。
请尝试将名称更正为现有getter的名称，或定义名为'backgroundColor'的getter或字段。
final color = decoration.color ?? Theme.of(context).backgroundColor;
^^^^^^^^^^^^^^^
/C:/Users/HP/AppData/Local/Pub/Cache/hosted/pub.dev/device_preview-1.1.0/lib/src/views/theme.dart:31:11: Error: No named parameter with the name 'toggleableActiveColor'.
toggleableActiveColor: accentColor,
^^^^^^^^^^^^^^^^^^^^^
/C:/Users/HP/AppData/Local/Pub/Cache/hosted/pub.dev/device_preview-1.1.0/lib/src/views/theme.dart:54:11: Error: No named parameter with the name 'toggleableActiveColor'.
toggleableActiveColor: accentColor,
^^^^^^^^^^^^^^^^^^^^^
/C:/Users/HP/AppData/Local/Pub/Cache/hosted/pub.dev/device_preview-1.1.0/lib/src/views/tool_panel/tool_panel.dart:83:34: Error: The getter 'headline6' isn't defined for the class 'TextTheme'.
- 'TextTheme' 来自 'package:flutter/src/material/text_theme.dart' ('/D:/flutter/packages/flutter/lib/src/material/text_theme.dart')。
请尝试将名称更正为现有getter的名称，或定义名为'headline6'的getter或字段。
style: theme.textTheme.headline6?.copyWith(
^^^^^^^^^
/C:/Users/HP/AppData/Local/Pub/Cache/hosted/pub.dev/device_preview-1.1.0/lib/src/views/tool_panel/sections/subsections/device_model.dart:175:32: Error: The getter 'subtitle2' isn't defined for the class 'TextTheme'.
- 'TextTheme' 来自 'package:flutter/src/material/text_theme.dart' ('/D:/flutter/packages/flutter/lib/src/material/text_theme.dart')。
请尝试将名称更正为现有getter的名称，或定义名为'subtitle2'的getter或字段。
style: theme.textTheme.subtitle2?.copyWith(
^^^^^^^^^
Target kernel_snapshot failed: Exception

FAILURE: Build failed with an exception.

已尝试方案 #

曾参考Stack Overflow上关于"The getter 'accentColor' isn't defined for the class 'ThemeData'"的解决方案，但未解决当前问题。

解决方案 #

核心原因 #

错误源于新版Flutter（启用Material 3）移除了旧版Material Design的API，而项目依赖的device_preview:1.1.0、persistent_bottom_nav_bar:5.0.2未适配这些变更。

可选解决步骤 #

1. 降级Flutter到兼容版本

找到项目README或pubspec.yaml指定的Flutter版本，降级到旧版（如Flutter 3.7.x）：

• 执行命令：flutter downgrade 3.7.12
• 清理缓存：flutter clean
• 重新拉取依赖：flutter pub get
• 重新编译：flutter build apk

2. 升级依赖包到兼容版本

更新pubspec.yaml中的依赖到适配Material 3的最新版本：

# 修改pubspec.yaml中的依赖
device_preview: ^2.1.0
persistent_bottom_nav_bar: ^5.0.2 # 若该版本仍不兼容，可替换为其他维护中的底部导航库

• 执行更新：flutter pub upgrade
• 清理并拉取依赖：flutter clean && flutter pub get
• 重新编译

3. 手动修改依赖源码（临时应急）

若无法降级或升级，可临时修改缓存中的依赖代码（注意：flutter pub get后会被覆盖）：

• TextTheme属性替换：subtitle2 → bodySmall，headline6 → titleLarge
• ThemeData.backgroundColor替换：Theme.of(context).backgroundColor → Theme.of(context).colorScheme.background
• toggleableActiveColor参数：移除该参数，或通过colorScheme配置替代，例如：

  colorScheme: ColorScheme.fromSeed(seedColor: accentColor).copyWith(secondary: accentColor)
  

内容的提问来源于stack exchange，提问作者Aman Kumar