3.7 版后移除的已弃用 API

根据 Flutter 的弃用策略，3.7 稳定版发布后已到生命周期终点的已弃用 API 已被移除。

所有受影响的 API 都已编译到此主要资源中，以帮助迁移。还提供了一个快速参考表。

本节列出了按受影响类列出的弃用内容。

Flutter Fix 支持：是

GestureRecognizer.kind 在 v2.3 中已弃用。 请改用 GestureRecognizer.supportedDevices。

此更改会影响 GestureRecognizer 的所有子类：

• EagerGestureRecognizer
• ForcePressGestureRecognizer
• LongPressGestureRecognizer
• DragGestureRecognizer
• VerticalDragGestureRecognizer
• HorizontalDragGestureRecognizer
• MultiDragGestureRecognizer
• ImmediateMultiDragGestureRecognizer
• HorizontalMultiDragGestureRecognizer
• VerticalMultiDragGestureRecognizer
• DelayedMultiDragGestureRecognizer
• DoubleTapGestureRecognizer
• MultiTapGestureRecognizer
• OneSequenceGestureRecognizer
• PrimaryPointerGestureRecognizer
• ScaleGestureRecognizer

此更改允许识别手势的多个设备，而不是 kind 提供的单个选项。

迁移指南

迁移前的代码：

var myRecognizer = GestureRecognizer(
  kind: PointerDeviceKind.mouse,  
);

迁移后的代码：

var myRecognizer = GestureRecognizer(
  supportedDevices: <PointerDeviceKind>[ PointerDeviceKind.mouse ],
);

参考资料

API 文档：

• GestureRecognizer
• EagerGestureRecognizer
• ForcePressGestureRecognizer
• LongPressGestureRecognizer
• DragGestureRecognizer
• VerticalDragGestureRecognizer
• HorizontalDragGestureRecognizer
• MultiDragGestureRecognizer
• ImmediateMultiDragGestureRecognizer
• HorizontalMultiDragGestureRecognizer
• VerticalMultiDragGestureRecognizer
• DelayedMultiDragGestureRecognizer
• DoubleTapGestureRecognizer
• MultiTapGestureRecognizer
• OneSequenceGestureRecognizer
• PrimaryPointerGestureRecognizer
• ScaleGestureRecognizer

相关的 PR：

• 在 #81858 中弃用
• 在 #119572 中移除

Flutter Fix 支持：是

ThemeData 的 accentColor、accentColorBrightness、accentColorTextTheme、accentColorIconTheme 和 buttonColor 属性在 v2.3 中已弃用。

此更改使 ThemeData 更好地符合 Material Design 指南。它还通过依赖核心配色方案或各个组件主题来实现所需的样式，从而使主题设计更加清晰。

框架不再使用 accentColorBrightness、accentColorTextTheme、accentColorIconTheme 和 buttonColor。应删除引用。

ThemeData.accentColor 的用法应替换为 ThemeData.colorScheme.secondary。

迁移指南

迁移前的代码：

var myTheme = ThemeData(
  //...
  accentColor: Colors.blue,
  //...
);
var color = myTheme.accentColor;

迁移后的代码：

var myTheme = ThemeData(
  //...
  colorScheme: ColorScheme(
    //...
    secondary:Colors.blue,
    //...
  ),
  //...
);
var color = myTheme.colorScheme.secondary;

参考资料

• Accent 颜色迁移指南

API 文档：

• ThemeData
• ColorScheme

相关问题：

• #56639
• #84748
• #56918
• #91772

相关的 PR：

在以下版本中弃用：

• #92822
• #81336
• #85144

在以下版本中移除：

• #118658
• #119360
• #120577
• #120932

Flutter Fix 支持：是

在 v2.4 中，对 app bar 类及其主题进行了一些更改，以更好地符合 Material Design。当时弃用了一些属性，并且这些属性已被移除。

对于 AppBar、SliverAppBar 和 AppBarTheme：

• brightness 已被移除，并替换为 systemOverlayStyle
• textTheme 已被移除，并替换为 toolbarTextStyle 或 titleTextStyle。
• backwardsCompatibility 可以移除，因为它是一个针对这些属性的临时迁移标志。

此外，AppBarTheme.color 已被移除，并由 AppBarTheme.backgroundColor 替换。

迁移指南

迁移前的代码：

var toolbarTextStyle = TextStyle(...);
var titleTextStyle = TextStyle(...);
AppBar(
  brightness: Brightness.light,
  textTheme: TextTheme(
    bodyMedium: toolbarTextStyle,
    titleLarge: titleTextStyle,
  )
  backwardsCompatibility: true,
);
AppBarTheme(color: Colors.blue);

迁移后的代码：

var toolbarTextStyle = TextStyle(...);
var titleTextStyle = TextStyle(...);
AppBar(
  systemOverlayStyle: SystemOverlayStyle(statusBarBrightness: Brightness.light),
  toolbarTextStyle: toolbarTextStyle,
  titleTextStyle: titleTextStyle,
);
AppBarTheme(backgroundColor: Colors.blue);

参考资料

API 文档：

• AppBar
• SliverAppBar
• AppBarTheme

相关问题：

• #86127
• #70645
• #67921
• #67497
• #50606
• #51820
• #61618

在以下版本中弃用：

• #86198
• #71184

在以下版本中移除：

• #120618
• #119253
• #120575

Flutter Fix 支持：是

在 v2.3 中，SystemChrome.setEnabledSystemUIOverlays（用于设置设备系统级叠加层（如状态栏和导航栏）的静态方法）已被弃用，取而代之的是 SystemChrome.setEnabledSystemUIMode。

此更改允许设置与原生 Android 应用设计（如边缘到边缘）匹配的常用全屏模式。

仍然可以通过 SystemUiMode.manual 支持手动设置叠加层，而不是选择特定模式，允许开发人员传递与以前相同的叠加层列表。

迁移指南

迁移前的代码：

SystemChrome.setEnabledSystemUIOverlays(<SystemUiOverlay>[
  SystemUiOverlay.top,
  SystemUiOverlay.bottom,
]);

迁移后的代码：

SystemChrome.setEnabledSystemUIMode(
  SystemUiMode.manual,
  overlays: <SystemUiOverlay>[
    SystemUiOverlay.top,
    SystemUiOverlay.bottom,
  ],
);

参考资料

API 文档：

• SystemChrome

相关问题：

• #35748
• #40974
• #44033
• #63761
• #69999

在以下版本中弃用：

• #81303

在以下版本中移除：

• #11957

Flutter Fix 支持：是

在 v2.3 中，SystemNavigator.routeUpdated 已被弃用，取而代之的是 SystemNavigator.routeInformationUpdated。

此更改将所有内容移动到一个 API 中，而不是提供两种更新引擎关于当前路由的方法，如果创建了报告路由的 Navigator，则该 API 会单独选择单条目历史模式。

迁移指南

迁移前的代码：

SystemNavigator.routeUpdated(routeName: 'foo', previousRouteName: 'bar');

迁移后的代码：

SystemNavigator.routeInformationUpdated(location: 'foo');

参考资料

API 文档：

• SystemNavigator

相关问题：

• #82574

在以下版本中弃用：

• #82594

在以下版本中移除：

• #119187

Flutter Fix 支持：是

在 v2.2 中，AnimatedSize.vsync 已被弃用。在 AnimatedSize 转换为其 State 混合了 SingleTickerProviderStateMixin 的 StatefulWidget 后，此属性不再需要。此更改是为了修复内存泄漏。

应删除 vsync 的用法，因为 AnimatedSize 现在处理此属性。

迁移指南

迁移前的代码：

AnimatedSize(
  vsync: this,
  // ...
);

迁移后的代码：

AnimatedSize(
  // ...
);

参考资料

API 文档：

• AnimatedSize

在以下版本中弃用：

• #80554
• #81067

在以下版本中移除：

• #119186

稳定版发布：3.10

除非另有说明，否则本网站上的文档反映的是 Flutter 的最新稳定版本。页面最后更新于 2025-01-30。 查看源代码 或 报告问题。