Contents

v2.10 后移除的已弃用 API

Contents

摘要
变更
时间线

根据 Flutter 的弃用策略，在 2.10 稳定版发布后达到生命周期末端的已弃用 API 已被移除。

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

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

Flutter Fix 支持：是

maxLengthEnforced 在 v1.25 中已弃用。

请改用 maxLengthEnforcement。如果 maxLengthEnforced 为 true，则替换为 MaxLengthEnforcement.enforce。如果 maxLengthEnforced 为 false，则替换为 MaxLengthEnforcement.none。此更改允许指定超出原始二元选择的更多行为，并添加 MaxLengthEnforcement.truncateAfterCompositionEnds 作为附加选项。

以下所有类都具有相同的 API 更改：

TextField
TextFormField
CupertinoTextField

迁移指南

提供深入迁移指南

迁移前的代码：

dartconst TextField textField = TextField(maxLengthEnforced: true);
const TextField textField = TextField(maxLengthEnforced: false);
final lengthEnforced = textField.maxLengthEnforced;

const TextFormField textFormField = TextFormField(maxLengthEnforced: true);
const TextFormField textFormField = TextFormField(maxLengthEnforced: false);
final lengthEnforced = textFormField.maxLengthEnforced;

const CupertinoTextField cupertinoTextField = CupertinoTextField(maxLengthEnforced: true);
const CupertinoTextField cupertinoTextField = CupertinoTextField(maxLengthEnforced: false);
final lengthEnforced = cupertinoTextField.maxLengthEnforced;

迁移后的代码：

dartconst TextField textField = TextField(maxLengthEnforcement: MaxLengthEnforcement.enforce);
const TextField textField = TextField(maxLengthEnforcement: MaxLengthEnforcement.none);
final lengthEnforced = textField.maxLengthEnforcement;

const TextFormField textFormField = TextFormField(maxLengthEnforcement: MaxLengthEnforcement.enforce);
const TextFormField textFormField = TextFormField(maxLengthEnforcement: MaxLengthEnforcement.none);
final lengthEnforced = textFormField.maxLengthEnforcement;

const CupertinoTextField cupertinoTextField = CupertinoTextField(maxLengthEnforcement: MaxLengthEnforcement.enforce);
const CupertinoTextField cupertinoTextField = CupertinoTextField(maxLengthEnforcement: MaxLengthEnforcement.none);
final lengthEnforced = cupertinoTextField.maxLengthEnforcement;

参考

API 文档：

相关问题：

问题 67898

相关 PR：

在 #68086 中弃用
在 #98539 中移除

Flutter Fix 支持：是

VelocityTracker 的默认构造函数在 v1.22 中已弃用。

应改用 VelocityTracker.withKind()。这允许为跟踪器指定 PointerDeviceKind。VelocityTracker.kind 的先前默认值为 PointerDeviceKind.touch。

迁移指南

迁移前的代码：

dart

final VelocityTracker tracker = VelocityTracker();

迁移后的代码：

dartfinal VelocityTracker tracker = VelocityTracker.withKind(PointerDeviceKind.touch);

参考

API 文档：

相关 PR：

在 #66043 中弃用
在 #98541 中移除

Flutter Fix 支持：否

DayPicker 和 MonthPicker 小部件在 v1.15 中首次弃用，然后在 v1.26 中扩展。

它们已被一个全面的小部件 CalendarDatePicker 替换。

这些小部件使用 showDatePicker 方法显示。此方法在此版本之前已迁移为显示新的 CalendarDatePicker，因此它们的最终移除不应需要进一步的操作。

参考

设计文档：

Material 日期选择器重新设计

API 文档：

相关问题：

问题 50133

相关 PR：

在 #50546 中弃用
在 #98543 中移除

Flutter Fix 支持：否

FlatButton、RaisedButton 和 OutlineButton 小部件在 v1.20 中首次弃用，然后在 v1.26 中扩展。

它们被新的按钮 TextButton、ElevatedButton 和 OutlinedButton 替换。这些新的小部件还使用新的关联主题，而不是通用的 ButtonTheme。

旧小部件	旧主题	新小部件	新主题
`FlatButton`	`ButtonTheme`	`TextButton`	`TextButtonTheme`
`RaisedButton`	`ButtonTheme`	`ElevatedButton`	`ElevatedButtonTheme`
`OutlineButton`	`ButtonTheme`	`OutlinedButton`	`OutlinedButtonTheme`

迁移指南

提供详细样式的深入迁移指南

迁移前的代码：

dartFlatButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

RaisedButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

OutlineButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

迁移后的代码：

dartTextButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

ElevatedButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

OutlinedButton(
  onPressed: onPressed,
  child: Text('Button'),
  // ...
);

参考

设计文档：

新的 Material 按钮和主题

API 文档：

相关 PR：

在 #59702 中添加新的 API
在 #73352 中弃用
在 #98546 中移除

Flutter Fix 支持：否

以下 Scaffold 的 SnackBar 方法在 v1.23 中已弃用。

showSnackBar
removeCurrentSnackBar
hideCurrentSnackBar

应改用 ScaffoldMessenger 的同名方法。默认的 ScaffoldMessenger 已在每个 MaterialApp 中创建。

迁移指南

提供深入迁移指南

迁移前的代码：

dartScaffold.of(context).showSnackBar(mySnackBar);
Scaffold.of(context).removeCurrentSnackBar(mySnackBar);
Scaffold.of(context).hideCurrentSnackBar(mySnackBar);

迁移后的代码：

dartScaffoldMessenger.of(context).showSnackBar(mySnackBar);
ScaffoldMessenger.of(context).removeCurrentSnackBar(mySnackBar);
ScaffoldMessenger.of(context).hideCurrentSnackBar(mySnackBar);

参考

设计文档：

ScaffoldMessenger 设计

视频内容：

API 文档：

相关问题：

相关 PR：

在 #64101 中添加新的 API
在 #67947 中弃用
在 #98549 中移除

Flutter Fix 支持：是

RectangularSliderTrackShape.disabledThumbGapWidth 在 v1.5 中首次弃用，然后在 v1.26 中扩展。

框架不再使用它，因为禁用时滑块拇指的动画不再发生。

迁移指南 迁移前的代码：

dart

RectangularSliderTrackShape(disabledThumbGapWidth: 2.0);

迁移后的代码：

dart

RectangularSliderTrackShape();

参考

API 文档：

RectangularSliderTrackShape

相关 PR：

动画更改于 #30390
在 #65246 中弃用
在 #98613 中移除

Flutter Fix 支持：是

以下 ThemeData 成员在 v1.23 中首次弃用，并在 v1.26 中扩展。

useTextSelectionTheme
textSelectionColor
cursorColor
textSelectionHandleColor

这些应替换为更全面的 TextSelectionThemeData，现在在 ThemeData 本身中指定。

useTextSelectionTheme 标志用作临时迁移标志，以区分这两个 API，现在可以将其删除。

迁移指南

提供深入迁移指南

迁移前的代码：

dartThemeData(
  useTextSelectionTheme: false,
  textSelectionColor: Colors.blue,
  cursorColor: Colors.green,
  textSelectionHandleColor: Colors.red,
);

迁移后的代码：

dartThemeData(
  textSelectionTheme: TextSelectionThemeData(
    selectionColor: Colors.blue,
    cursorColor: Colors.green,
    selectionHandleColor: Colors.red,
  ),
);

参考

设计文档：

文本选择主题

API 文档：

相关问题：

相关 PR：

在 #62014 中添加新的 API
在 #66485 中弃用
在 #98578 中移除

Flutter Fix 支持：否

RenderEditable.onSelectionChanged 和 TextSelectionDelegate.textEditingValue 在 v1.26 中已弃用。

不要调用这些方法中的一个或两个，请调用 TextSelectionDelegate.userUpdateTextEditingValue。这修复了一个 TextInputFormatter 将接收错误选择值的问题。

迁移指南

迁移前的代码：

dartrenderEditable.onSelectionChanged(selection, renderObject, cause);
textSelectionDelegate.textEditingValue = value;

迁移后的代码：

dart

textSelectionDelegate.userUpdateTextEditingValue(value, cause);

参考

API 文档：

相关问题：

已解决 #75505

相关 PR：

在 #75541 中弃用
在 #98582 中移除

Flutter Fix 支持：是

Stack.overflow 以及 Overflow 枚举在 v1.22 中已弃用。

替换项为 Stack.clipBehavior，此更改是框架中统一剪辑行为和语义的一部分。如果使用了 Overflow.visible，则使用 Clip.none。如果使用了 Overflow.clip，则使用 Clip.hardEdge。

迁移指南

提供深入迁移指南

迁移前的代码：

dartconst Stack stack = Stack(overflow: Overflow.visible);
const Stack stack = Stack(overflow: Overflow.clip);

迁移后的代码：

dartconst Stack stack = Stack(clipBehavior: Clip.none);
const Stack stack = Stack(clipBehavior: Clip.hardEdge);

参考

API 文档：

相关问题：

已解决 #66030

相关 PR：

在 #66305 中弃用
在 #98583 中移除

Flutter Fix 支持：否

SemanticsEvent UpdateLiveRegionEvent 在 v1.12 中首次弃用，然后在 v1.26 中扩展。

框架从未实现过它，任何引用都应删除。

参考

API 文档：

SemanticsEvent

相关 PR：

在 #45940 中弃用
在 #98615 中移除

Flutter Fix 支持：是

以下 RenderObjectElement 方法在 v1.21 中已弃用。

insertChildRenderObject
moveChildRenderObject
removeChildRenderObject

这些方法分别被替换为：

insertRenderObjectChild
moveRenderObjectChild
removeRenderObjectChild

为了更改函数签名，这些更改被作为软性中断弃用进行。

迁移指南

迁移前的代码：

dartelement.insertChildRenderObject(child, slot);
element.moveChildRenderObject(child, slot);
element.removeChildRenderObject(child);

迁移后的代码：

dartelement.insertRenderObjectChild(child, slot);
element.moveRenderObjectChild(child, oldSlot, newSlot);
element.removeRenderObjectChild(child, slot);

参考

API 文档：

RenderObjectElement

相关问题：

问题 63269

相关 PR：

在 #64254 中弃用
在 #98616 中移除

稳定版：3.0.0

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

v2.10 后移除的已弃用 API

摘要

变更

`TextField` 及相关类的 `maxLengthEnforced`

`VelocityTracker` 构造函数

`DayPicker` 和 `MonthPicker`

`FlatButton`、`RaisedButton` 和 `OutlineButton`

`Scaffold` 的 `SnackBar` 方法

`RectangularSliderTrackShape.disabledThumbGapWidth`

`ThemeData` 的文本选择到 `TextSelectionThemeData`

`RenderEditable.onSelectionChanged` 到 `TextSelectionDelegate.textEditingValue`

`Stack.overflow`

`UpdateLiveRegionEvent`

`RenderObjectElement` 方法

时间线

摘要

变更

TextField 及相关类的 maxLengthEnforced

VelocityTracker 构造函数

DayPicker 和 MonthPicker

FlatButton、RaisedButton 和 OutlineButton

Scaffold 的 SnackBar 方法

RectangularSliderTrackShape.disabledThumbGapWidth

ThemeData 的文本选择到 TextSelectionThemeData

RenderEditable.onSelectionChanged 到 TextSelectionDelegate.textEditingValue

Stack.overflow

UpdateLiveRegionEvent

RenderObjectElement 方法

时间线

`TextField` 及相关类的 `maxLengthEnforced`

`VelocityTracker` 构造函数

`DayPicker` 和 `MonthPicker`

`FlatButton`、`RaisedButton` 和 `OutlineButton`

`Scaffold` 的 `SnackBar` 方法

`RectangularSliderTrackShape.disabledThumbGapWidth`

`ThemeData` 的文本选择到 `TextSelectionThemeData`

`RenderEditable.onSelectionChanged` 到 `TextSelectionDelegate.textEditingValue`

`Stack.overflow`

`UpdateLiveRegionEvent`

`RenderObjectElement` 方法