Flutter 2.5中AppBarTheme brightness已废弃，如何用colorScheme实现对应功能

什么是ColorScheme #

ColorScheme是Flutter Material设计规范下的统一颜色管理体系，包含一组语义化的颜色角色（比如主色、背景色、文本色等），全局配置后所有Material组件都会默认继承对应语义的颜色，解决了旧版本中各个组件单独配置颜色属性导致的样式不统一、属性冗余的问题。

具体实现方法 #

原来AppBarTheme的brightness属性作用是控制AppBar的明暗模式：设置为Brightness.dark时AppBar使用深色背景+浅色文字/icon，设置为Brightness.light时使用浅色背景+深色文字/icon，现在可以通过以下两种方式实现相同效果：

全局配置场景 #

适用于整个应用统一AppBar明暗风格的情况：

旧写法（已废弃）：

ThemeData(
  appBarTheme: AppBarTheme(
    brightness: Brightness.dark,
  ),
)

新写法：

ThemeData(
  // 全局配置颜色方案的明暗模式，AppBar会自动继承该配置
  colorScheme: ColorScheme.fromSeed(
    seedColor: Colors.blue, // 替换为你的应用主色
    brightness: Brightness.dark, // 对应原来的brightness设置
  ),
  // 不需要额外配置AppBarTheme的brightness，如需单独调整AppBar颜色可从colorScheme取色
  appBarTheme: AppBarTheme(
    backgroundColor: Theme.of(context).colorScheme.surface,
    foregroundColor: Theme.of(context).colorScheme.onSurface,
  ),
)

单个AppBar单独配置场景 #

适用于部分页面AppBar需要单独设置明暗风格的情况：

import 'package:flutter/services.dart';

AppBar(
  // 单独设置当前AppBar的背景和前景色，对应原brightness.dark效果
  backgroundColor: Colors.grey[900],
  foregroundColor: Colors.white,
  // 搭配systemOverlayStyle调整状态栏图标明暗
  systemOverlayStyle: SystemUiOverlayStyle.light,
)

注意事项 #

• 如需在代码中获取当前页面的明暗模式，可使用Theme.of(context).colorScheme.brightness替代原来读取AppBarTheme.brightness的写法。
• 兼容Material 2的项目可以直接使用ColorScheme.light()或ColorScheme.dark()快速生成对应明暗的颜色集，无需完整适配Material 3样式。

内容的提问来源于stack exchange，提问作者Zena Radwan