v3.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;

参考

• 强调色迁移指南

API 文档

• ThemeData
• ColorScheme

相关问题

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

相关 PR

在以下版本中弃用

• #92822
• #81336
• #85144

在以下版本中移除

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

Flutter Fix 支持：是

在 v2.4 中，对应用栏类及其主题进行了一些更改，以更好地符合 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.vsyc 已弃用。在 AnimatedSize 转换为其 State 混合了 SingleTickerProviderStateMixin 的 StatefulWidget 后，此属性不再需要。此更改是为了修复内存泄漏。

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

迁移指南

迁移前的代码

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

迁移后的代码

AnimatedSize(
  // ...
);

参考

API 文档

• AnimatedSize

在以下版本中弃用

• #80554
• #81067

在以下版本中移除

• #119186

稳定版本：3.10

除非另有说明，否则本网站上的文档反映了 Flutter 的最新稳定版本。页面最后更新于 2024 年 6 月 1 日。 查看源代码 或 报告问题。