内容

v2.5 后移除的已弃用 API

内容

摘要
变更
时间线

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

所有受影响的 API 都已编译到此主要来源中，以帮助迁移。一个快速参考表也可供使用。

本节按受影响的类列出弃用情况。

Flutter Fix 支持：是

autovalidate 在 v1.19 中被弃用。

请使用 autovalidateMode 代替。如果 autovalidate 为 true，则替换为 AutovalidateMode.always。如果 autovalidate 为 false，则替换为 AutovalidateMode.disabled。此更改允许指定更多行为，超出原始二元选择，并添加 AutovalidateMode.onUserInteraction 作为附加选项。

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

Form
FormField
DropdownButtonFormField
TextFormField

迁移指南

提供深入的迁移指南

迁移前的代码

dartconst Form form = Form(autovalidate: true);
const Form form = Form(autovalidate: false);
final autoMode = form.autovalidate;

const FormField formField = FormField(autovalidate: true);
const FormField formField = FormField(autovalidate: false);
final autoMode = formField.autovalidate;

const TextFormField textFormField = TextFormField(autovalidate: true);
const TextFormField textFormField = TextFormField(autovalidate: false);

const DropdownButtonFormField dropDownButtonFormField = DropdownButtonFormField(autovalidate: true);
const DropdownButtonFormField dropdownButtonFormField = DropdownButtonFormField(autovalidate: false);

迁移后的代码

dartconst Form form = Form(autovalidateMode: AutovalidateMode.always);
const Form form = Form(autovalidateMode: AutovalidateMode.disabled);
final autoMode = form.autovalidateMode;

const FormField formField = FormField(autovalidateMode: AutovalidateMode.always);
const FormField formField = FormField(autovalidateMode: AutovalidateMode.disabled);
final autoMode = formField.autovalidateMode;

const TextFormField textFormField = TextFormField(autovalidateMode: AutovalidateMode.always);
const TextFormField textFormField = TextFormField(autovalidateMode: AutovalidateMode.disabled);

const DropdownButtonFormField dropDownButtonFormField = DropdownButtonFormField(autovalidateMode: AutovalidateMode.always);
const DropdownButtonFormField dropdownButtonFormField = DropdownButtonFormField(autovalidateMode: AutovalidateMode.disabled);

参考

API 文档

相关 PR

在 #59766 中弃用
在 #90292 中移除

Flutter Fix 支持：否

FloatingHeaderSnapConfiguration 的 TickerProvider vsync 属性在 v1.19 中被弃用。

动画的 vsync 应改为使用 SliverPersistentHeaderDelegate.vsync 指定。

迁移指南

迁移前的代码

dartclass MySliverPersistentHeaderDelegate extends SliverPersistentHeaderDelegate {
  FloatingHeaderSnapConfiguration? get snapConfiguration => FloatingHeaderSnapConfiguration(vsync: myTickerProvider);
}

迁移后的代码

dartclass MySliverPersistentHeaderDelegate extends SliverPersistentHeaderDelegate {
  FloatingHeaderSnapConfiguration? get snapConfiguration => FloatingHeaderSnapConfiguration();
  TickerProvider? get vsync => myTickerProvider;
}

参考

设计文档

控制 SliverPersistentHeader 的 showOnScreen 行为

API 文档

相关 PR

在 #56413 中弃用
在 #90293 中移除

Flutter Fix 支持：是

AndroidViewController、TextureAndroidViewController 和 SurfaceAndroidViewController 的 id 在 v1.20 中被弃用。

对于所有这些用例，都应使用 viewId 代替。

迁移指南

迁移前的代码

dartfinal SurfaceAndroidViewController surfaceController = SurfaceAndroidViewController(
  viewId: 10,
  viewType: 'FixTester',
  layoutDirection: TextDirection.ltr,
);
int viewId = surfaceController.id;
final SurfaceAndroidViewController surfaceController = SurfaceAndroidViewController(
  error: '',
);
final TextureAndroidViewController textureController = TextureAndroidViewController(
  error: '',
);
final TextureAndroidViewController textureController = TextureAndroidViewController(
  viewId: 10,
  viewType: 'FixTester',
  layoutDirection: TextDirection.ltr,
);
viewId = textureController.id;

迁移后的代码

dartfinal SurfaceAndroidViewController surfaceController = SurfaceAndroidViewController(
  viewId: 10,
  viewType: 'FixTester',
  layoutDirection: TextDirection.ltr,
);
int viewId = surfaceController.viewId;
final SurfaceAndroidViewController surfaceController = SurfaceAndroidViewController(
  error: '',
);
final TextureAndroidViewController textureController = TextureAndroidViewController(
  error: '',
);
final TextureAndroidViewController textureController = TextureAndroidViewController(
  viewId: 10,
  viewType: 'FixTester',
  layoutDirection: TextDirection.ltr,
);
viewId = textureController.viewId;

参考

设计文档

Flutter 混合合成

API 文档

相关 PR

在 #60320 中弃用
在 #90294 中移除

Flutter Fix 支持：否

BlacklistingTextInputFormatter 和 WhitelistingTextInoutFormatter 的整个类在 v1.20 中被弃用。

它们的功能已重写到一个名为 FilteringTextInputFormatter 的单一类中。

迁移指南

迁移前的代码

dartformatter = BlacklistingTextInputFormatter(pattern, replacementString: 'replacedPattern');
formatter = BlacklistingTextInputFormatter.singleLineFormatter;
pattern = formatter.blacklistedPattern;
formatter = WhitelistingTextInputFormatter(pattern);
formatter = WhitelistingTextInputFormatter.digitsOnly;
pattern = formatter.whitelistedPattern;

迁移后的代码

dartformatter = FilteringTextInputFormatter.deny(pattern, replacementString: 'replacedPattern');
formatter = FilteringTextInputFormatter.singleLineFormatter;
pattern = formatter.filterPattern;
formatter = FilteringTextInputFormatter.allow(pattern);
formatter = FilteringTextInputFormatter.digitsOnly;
pattern = formatter.filterPattern;

参考

API 文档

FilteringTextInputFormatter

相关 PR

在 #59120 中弃用
在 #90296 中移除

Flutter Fix 支持：是

BottomNavigationBarItem 的 title 在 v1.19 中被弃用。应改用 label 属性。此迁移允许更好的文本缩放，并在 BottomNavigationBar 上下文中为 BottomNavigationBarItem 提供内置的 Tooltip。

迁移指南

提供深入的迁移指南

迁移前的代码

dartconst BottomNavigationBarItem bottomNavigationBarItem = BottomNavigationBarItem(title: myTitle);
const BottomNavigationBarItem bottomNavigationBarItem = BottomNavigationBarItem();
bottomNavigationBarItem.title;

迁移后的代码

dartconst BottomNavigationBarItem bottomNavigationBarItem = BottomNavigationBarItem(label: myTitle);
const BottomNavigationBarItem bottomNavigationBarItem = BottomNavigationBarItem();
bottomNavigationBarItem.label;

参考

设计文档

BottomNavigationBarItem 标题

API 文档

相关 PR

在 #59127 中弃用
在 #90295 中移除

以下 API 已被移除

Platform.packageRoot 在 dart:core 中
Isolate.packageRoot 在 dart:isolate 中
Platform.packageRoot 在 package:platform 中

这些 API 在 Dart 2.0 中被标记为已弃用，并且在任何 Dart 2.x 版本中都无法正常工作。

迁移指南

这些 packageRoot API 已被一组新的 packageConfig API 替换，您应该迁移到这些 API。

Platform.packageConfig 在 dart:core 中
Isolate.packageConfig 在 dart:isolate 中
Platform.packageConfig 在 package:platform 中

如果您正在使用 package:platform 包，请注意，无论您是否正在使用 packageRoot API，该包的旧版本都不兼容 Dart 2.16 及更高版本，因为它们依赖于现已删除的 packageRoot API。尝试运行应用程序时，您可能会看到类似这样的错误

../../.pub-cache/hosted/pub.dartlang.org/platform-3.0.0/
  lib/src/interface/local_platform.dart:46:19:
  Error: Member not found: 'packageRoot'.
      io.Platform.packageRoot; // ignore: deprecated_member_use
                  ^^^^^^^^^^^

要解决此问题，请将 package:platform 升级到 3.1.0 或更高版本，方法是在您的 pubspec.yaml 文件中升级约束

yamldependencies:
  platform: ^3.1.0

参考

相关 PR

在 #47769 中从 Dart 库中移除
在 PR #38 中从 package:platform 中移除
在 PR #94603 中更新 Flutter 以使用 package:platform 3.1.0

稳定版发布：2.10

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

v2.5 后移除的已弃用 API

摘要

变更

`FloatingHeaderSnapConfiguration.vsync`

`AndroidViewController` 及其子类的 `id`

`BlacklistingTextInputFormatter` 和 `WhitelistingTextInputFormatter`

`BottomNavigationBarItem.title`

`dart:core`、`dart:isolate` 和 `package:platform` 中的 `packageRoot`

时间线

摘要

变更

Form 及相关类的 autovalidate

FloatingHeaderSnapConfiguration.vsync

AndroidViewController 及其子类的 id

BlacklistingTextInputFormatter 和 WhitelistingTextInputFormatter

BottomNavigationBarItem.title

dart:core、dart:isolate 和 package:platform 中的 packageRoot

时间线

`Form` 及相关类的 `autovalidate`

`FloatingHeaderSnapConfiguration.vsync`

`AndroidViewController` 及其子类的 `id`

`BlacklistingTextInputFormatter` 和 `WhitelistingTextInputFormatter`

`BottomNavigationBarItem.title`

`dart:core`、`dart:isolate` 和 `package:platform` 中的 `packageRoot`