v3.13 后移除的已弃用 API

根据 Flutter 的弃用策略，在 3.13 稳定版发布后生命周期结束的已弃用 API 已被移除。

所有受影响的 API 都已整理到此主要来源，以协助迁移。为了进一步协助您迁移，请查看此快速参考表。

本节按软件包和受影响的类列出了废弃项。

软件包：flutter Flutter Fix 支持：是

以下类的 useDeleteButtonTooltip 属性在 v2.10 中已弃用

• DeletableChipAttributes
• Chip
• RawChip
• InputChip

deleteButtonTooltipMessage 替换了 useDeleteButtonTooltip。此更改简化了 API，因为向 deleteButtonTooltipMessage 提供一个空字符串可以达到与将原始属性 useDeleteButtonTooltip 设置为 false 相同的结果。当 deleteButtonTooltipMessage 未设置时，默认使用 MaterialLocalizations.deleteButtonTooltip。

《弃用 Chip 的 useDeleteButtonTooltip》设计文档更深入地介绍了此对 Chip 和 Tooltip 的更新。要了解更多信息，请查看Chip 和 Tooltip 迁移指南。

迁移指南

迁移前的代码

Chip(useDeleteButtonTooltip: false);
InputChip(useDeleteButtonTooltip: true);
RawChip rawChip = RawChip();
rawChip.useDeleteButtonTooltip;

迁移后的代码

Chip(deleteButtonTooltipMessage: '');
InputChip();
RawChip rawChip = RawChip();
rawChip.deleteButtonTooltipMessage;

参考资料

API 文档

• DeletableChipAttributes
• Chip
• RawChip
• InputChip
• MaterialLocalizations.deleteButtonTooltip

相关 PR

• 在 #96174 中弃用
• 在 #134486 中移除

Package: flutter 受 Flutter Fix 支持: 否

MaterialButtonWithIconMixin 属性在 v2.11 中已弃用。

随着新的按钮类 TextButton、OutlinedButton 和 ElevatedButton 的引入，此 Mixin 不再使用。早期版本移除了使用此 Mixin 的旧按钮类。因此，此 Mixin 不再影响任何可能混合使用它的类。

迁移指南

迁移前的代码

class MyButtonClass extends StatelessWidget with MaterialButtonWithIconMixin {
  // ...
}

迁移后的代码

class MyButtonClass extends StatelessWidget {
  // ...
}

参考资料

相关 PR

• 在 #99088 中弃用
• 在 #133173 中移除

Package: flutter 受 Flutter Fix 支持: 否

PlatformsViewsService 的静态方法 synchronizeToNativeViewHierarchy 在 v2.11 中已弃用。

在弃用期间，该方法是一个空操作函数，因为它不再需要为了提高性能而调用。应移除对该方法的引用，这不会影响应用程序。

迁移指南

迁移前的代码

await PlatformsViewsService.synchronizeToNativeViewHierarchy(false);

迁移后的代码

参考资料

API 文档

• PlatformViewsService

相关 PR

• 在 #100990 中弃用
• 在 #133175 中移除

软件包：flutter Flutter Fix 支持：是

TextSelectionOverlay 的静态 fadeDuration 属性在 v2.12 中已弃用。

SelectionOverlay.fadeDuration 属性替换了 TextSelectionOverlay.fadeDuration。随着 TextSelectionOverlay 的重构，SelectionOverlay 被添加为一个更通用的 Widget，不再依赖于 RenderEditable。

迁移指南

迁移前的代码

TextSelectionOverlay.fadeDuration;

迁移后的代码

SelectionOverlay.fadeDuration;

参考资料

API 文档

• TextSelectionOverlay
• SelectionOverlay

相关 PR

• 在 #100381 中弃用
• 在 #134485 中移除

Package: flutter 受 Flutter Fix 支持: 否

以下类的 androidOverscrollIndicator 属性在 v2.13 中已弃用

• ScrollBehavior
• MaterialScrollBehavior
• ThemeData

此标志的引入是为了允许用户配置滚动 Widget 使用 GlowingOverscrollIndicator 或 StretchingOvercrollIndicator。由于框架为 Material 3 风格的 Widget 提供了更多支持，它已被 ThemeData.useMaterial3 标志取代。

由于 ThemeData.useMaterial3 默认值为 true，因此默认应用 StretchingOverscrollIndicator。将此值设置为 false 将改为应用 GlowingOverscrollIndicator。

另外，可以覆盖 ScrollBehavior 或 MaterialScrollBehavior 的 buildOverscrollIndicator 方法来进一步更改滚动指示器的外观。

迁移指南

迁移前的代码

MaterialApp(
  scrollBehavior: MaterialScrollBehavior(
    androidOverscrollIndicator: AndroidOverscrollIndicator.glow,
  ),
  //...
);

MaterialApp(
  scrollBehavior: ScrollBehavior(
    androidOverscrollIndicator: AndroidOverscrollIndicator.glow,
  ),
  //...
);

MaterialApp(
  theme: Theme.light().copyWith(
    androidOverscrollIndicator: AndroidOverscrollIndicator.glow,
  ),
  //...
);

迁移后的代码

MaterialApp(
  theme: Theme.light().copyWith(
    // defaults to true and stretching indicator,
    // false results in glowing indicator
    useMaterial3: false,
  ),
  //...
);

参考资料

API 文档

• ScrollBehavior
• MaterialScrollBehavior
• ThemeData
• GlowingOverscrollIndicator
• StretchingOverscrollIndicator

相关 PR

• 在 #100234 中弃用
• 在 #133181 中移除

Package: flutter 受 Flutter Fix 支持: 否

PaintingBinding 的 instantiateImageCodec 方法，以及 ImageProvider 的 load 方法和相关的 DecoderCallback 都在 v2.13 中已弃用。

相应的替换是：

此更改通过使用缓冲区实现了更快的图像加载性能。

迁移指南

迁移前的代码

PaintingBinding.instance.instantiateImageCodec

迁移后的代码

PaintingBinding.instance.instantiateImageCodecFromBuffer

参考资料

API 文档

• PaintingBinding
• ImageProvider
• DecoderBufferCallback

相关 PR

• 在 #103496 中弃用
• 在 #132679 中移除

Package: flutter_test 受 Flutter Fix 支持: 否

为了支持多窗口功能，TestWindow 的许多已弃用属性已被移除。虽然 TestWindow 已被弃用，但目前还不符合移除条件。现在迁移过期的属性将有助于从 TestWindow 迁移。

已移除的属性如下：

• localeTestValue
• clearLocaleTestValue
• localesTestValue
• clearLocalesTestValue
• initialLifecycleStateTestValue
• textScaleFactorTestValue
• clearTextScaleFactorTestValue
• platformBrightnessTestValue
• clearPlatformBrightnessTestValue
• alwaysUse24HourFormatTestValue
• clearAlwaysUse24HourTestValue
• brieflyShowPasswordTestValue
• defaultRouteNameTestValue
• clearDefaultRouteNameTestValue
• semanticsEnabledTestValue
• clearSemanticsEnabledTestValue
• accessibilityFeaturesTestValue
• clearAccessibilityFeaturesTestValue

要了解此 TestWindow 更新的更多信息，请查看TestWindow 迁移指南。

迁移指南

迁移前的代码

testWidgets('My test', (WidgetTester tester) aysnc {
  // For all instances, replace window with platformDispatcher
  tester.binding.window.textScaleFactorTestValue = 42;
  addTearDown(tester.binding.window.clearTextScaleFactorTestValue);
  // ...
});

迁移后的代码

testWidgets('My test', (WidgetTester tester) aysnc {
  // For all instances, replace window with platformDispatcher
  tester.binding.platformDispatcher.textScaleFactorTestValue = 42;
  addTearDown(tester.binding.platformDispatcher.clearTextScaleFactorTestValue);
  // ...
});

参考资料

API 文档

• WidgetTester
• TestWidgetsFlutterBinding
• TestPlatformDispatcher

相关 PR

• 在 #99443 中弃用
• 在 #131098 中移除

稳定版本：3.16