内容

v3.19 后移除的已弃用 API

内容

摘要
更改
时间线

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

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

本节按包和受影响的类列出已弃用的 API。

包：flutter Flutter Fix 支持：是

在 v3.1 中，TextTheme 的几个 TextStyle 属性被弃用，以支持 Material Design 规范中的新样式。它们与新 API 中的相应替换一起列在下面的表格中。

已弃用 API	新 API
headline1	displayLarge
headline2	displayMedium
headline3	displaySmall
headline4	headlineMedium
headline5	headlineSmall
headline6	titleLarge
subtitle1	titleMedium
subtitle2	titleSmall
bodyText1	bodyLarge
bodyText2	bodyMedium
caption	bodySmall
button	labelLarge
overline	labelSmall

迁移指南

迁移前代码

dart// TextTheme
// Base constructor
TextTheme(
  headline1: headline1Style,
  headline2: headline2Style,
  headline3: headline3Style,
  headline4: headline4Style,
  headline5: headline5Style,
  headline6: headline6Style,
  subtitle1: subtitle1Style,
  subtitle2: subtitle2Style,
  bodyText1: bodyText1Style,
  bodyText2: bodyText2Style,
  caption: captionStyle,
  button: buttonStyle,
  overline: overlineStyle,
);

// copyWith
TextTheme.copyWith(
  headline1: headline1Style,
  headline2: headline2Style,
  headline3: headline3Style,
  headline4: headline4Style,
  headline5: headline5Style,
  headline6: headline6Style,
  subtitle1: subtitle1Style,
  subtitle2: subtitle2Style,
  bodyText1: bodyText1Style,
  bodyText2: bodyText2Style,
  caption: captionStyle,
  button: buttonStyle,
  overline: overlineStyle,
);

// Getters
TextStyle style;
style = textTheme.headline1,
style = textTheme.headline2,
style = textTheme.headline3,
style = textTheme.headline4,
style = textTheme.headline5,
style = textTheme.headline6,
style = textTheme.subtitle1,
style = textTheme.subtitle2,
style = textTheme.bodyText1,
style = textTheme.bodyText2,
style = textTheme.caption,
style = textTheme.button,
style = textTheme.overline,

迁移后代码

dart// TextTheme
// Base constructor
TextTheme(
  displayLarge: headline1Style,
  displayMedium: headline2Style,
  displaySmall: headline3Style,
  headlineMedium: headline4Style,
  headlineSmall: headline5Style,
  titleLarge: headline6Style,
  titleMedium: subtitle1Style,
  titleSmall: subtitle2Style,
  bodyLarge: bodyText1Style,
  bodyMedium: bodyText2Style,
  bodySmall: captionStyle,
  labelLarge: buttonStyle,
  labelSmall: overlineStyle,
);

TextTheme.copyWith(
  displayLarge: headline1Style,
  displayMedium: headline2Style,
  displaySmall: headline3Style,
  headlineMedium: headline4Style,
  headlineSmall: headline5Style,
  titleLarge: headline6Style,
  titleMedium: subtitle1Style,
  titleSmall: subtitle2Style,
  bodyLarge: bodyText1Style,
  bodyMedium: bodyText2Style,
  bodySmall: captionStyle,
  labelLarge: buttonStyle,
  labelSmall: overlineStyle,
);

TextStyle style;
style = textTheme.displayLarge;
style = textTheme.displayMedium;
style = textTheme.displaySmall;
style = textTheme.headlineMedium;
style = textTheme.headlineSmall;
style = textTheme.titleLarge;
style = textTheme.titleMedium;
style = textTheme.titleSmall;
style = textTheme.bodyLarge;
style = textTheme.bodyMedium;
style = textTheme.bodySmall;
style = textTheme.labelLarge;
style = textTheme.labelSmall;

参考

API 文档

TextTheme

相关 PR

弃用自 #109817
移除自 #139255

包：flutter Flutter Fix 支持：是

在 v3.3 中，ThemeData 的几个 Color 属性被弃用，以支持 Material Design 规范中的新样式。这些颜色为 errorColor、backgroundColor、bottomAppBarColor 和 toggleableActiveColor。前两个被 ThemeData.colorScheme 的属性替换，而 bottomAppBarColor 被组件主题 BottomAppBarTheme 的颜色替换。toggleableActiveColor 不再被框架使用，已被移除。

迁移指南

迁移前代码

dartvar myTheme = ThemeData(
  //...
  errorColor: Colors.red,
  backgroundColor: Colors.blue,
  bottomAppBarColor: Colors.purple,
  toggleableActiveColor: Colors.orange,
  //...
);
var errorColor = myTheme.errorColor;
var backgroundColor = myTheme.backgroundColor;
var bottomAppBarColor = myTheme.bottomAppBarColor;
var toggleableActiveColor = myTheme.toggleableActiveColor;

迁移后代码

dartvar myTheme = ThemeData(
  //...
  colorScheme: ColorScheme(
    /// ...
    error: Colors.red,
    background: Colors.blue,
  ),
  bottomAppBarTheme: BottomAppBarTheme(
    color: Colors.purple,
  ),
  //...
);
var errorColor = myTheme.colorScheme.error;
var backgroundColor = myTheme.colorScheme.background;
var bottomAppBarColor = myTheme.bottomAppBarTheme.color;
var toggleableActiveColor = Colors.orange;

参考

API 文档

相关 PR

弃用自 #110162、#111080 和 #97972
移除自 #144178、#144080、#144079 和 #144078

包：flutter Flutter Fix 支持：是

在 v3.4 之后，previewBuilder 被 CupertinoContextMenu 的 builder 替换。通过添加 builder，上下文菜单执行的整个动画都被覆盖，其中后半部分由 previewBuilder 执行，并由 CupertinoContextMenu.animationOpensAt 分隔。

迁移指南

迁移前代码

dartCupertinoContextMenu(
  previewBuilder: (BuildContext context, Animation<double> animation, Widget child) {
    return FittedBox(
      fit: BoxFit.cover,
      child: ClipRRect(
        borderRadius: BorderRadius.circular(64.0 * animation.value),
        child: Image.asset('assets/photo.jpg'),
      ),
    );
  },
  actions: <Widget>[
    CupertinoContextMenuAction(
      child: const Text('Action one'),
      onPressed: () {},
    ),
  ],
  child: FittedBox(
    fit: BoxFit.cover,
    child: Image.asset('assets/photo.jpg'),
  ),
);

迁移后代码

dartCupertinoContextMenu(
  actions: <Widget>[
    CupertinoContextMenuAction(
      child: const Text('Action one'),
      onPressed: () {},
    ),
  ],
  builder: (BuildContext context, Animation<double> animation) {
    final Animation<BorderRadius?> borderRadiusAnimation = BorderRadiusTween(
      begin: BorderRadius.circular(0.0),
      end: BorderRadius.circular(CupertinoContextMenu.kOpenBorderRadius),
    ).animate(
      CurvedAnimation(
        parent: animation,
        curve: Interval(
          CupertinoContextMenu.animationOpensAt,
          1.0,
        ),
      ),
    );

    final Animation<Decoration> boxDecorationAnimation = DecorationTween(
      begin: const BoxDecoration(
        color: Color(0xFFFFFFFF),
        boxShadow: <BoxShadow>[],
      ),
      end: BoxDecoration(
        color: Color(0xFFFFFFFF),
        boxShadow: CupertinoContextMenu.kEndBoxShadow,
      ),
    ).animate(
      CurvedAnimation(
        parent: animation,
        curve: Interval(
          0.0,
          CupertinoContextMenu.animationOpensAt,
        )
      )
    );

    return Container(
      decoration: animation.value < CupertinoContextMenu.animationOpensAt
        ? boxDecorationAnimation.value
        : null,
      child: FittedBox(
        fit: BoxFit.cover,
        child: ClipRRect(
          borderRadius: borderRadiusAnimation.value ?? BorderRadius.circular(0.0),
          child: SizedBox(
            height: 150,
            width: 150,
            child: Image.asset('assets/photo.jpg'),
          ),
        ),
      )
    );
   }
 )

参考

API 文档

CupertinoContextMenu

相关 PR

弃用自 #110616
移除自 #143990

包：flutter Flutter Fix 支持：是

在 v3.4 之后，Scrollbar 的 showTrackOnHover 属性及其关联的组件主题 ScrollbarThemeData.showTrackOnHover 被状态属性 ScrollbarThemeData.trackVisibility 替换。通过使用 trackVisibility，所有状态排列都可以考虑在内以显示滚动条轨道，而不仅仅是悬停。

迁移指南

迁移前代码

dartScrollbar(
  showTrackOnHover: true,
  child: //...
);
ScrollbarThemeData(
  showTrackOnHover: true,
);

迁移后代码

dartScrollbar(
  child: //...
);
ScrollbarThemeData(
  // This will always show the track for any state.
  trackVisibility: MaterialStateProperty<bool>.all(true),
);
// Or
ScrollbarThemeData(
  // Only show on hover.
  trackVisibility: (Set<MaterialState> states) => states.contains(MaterialState.hovered),
);

参考

API 文档

相关 PR

弃用自 #111706
移除自 #144180

包：flutter Flutter Fix 支持：否

KeepAliveHandle 的 release 方法已被移除，并在 v3.3 之后由调用 dispose 替换。进行此更改是因为发现 release 经常在不随后调用 dispose 的情况下被调用，从而导致内存泄漏。dispose 方法现在执行与 release 相同的功能。

迁移指南

迁移前代码

dartKeepAliveHandle handle = KeepAliveHandle();
handle.release();
handle.dispose();

迁移后代码

dartKeepAliveHandle handle = KeepAliveHandle();
handle.dispose();

参考

API 文档

KeepAliveHandle

相关 PR

弃用自 #108384
移除自 #143961

包：flutter Flutter Fix 支持：是

在 v3.3 之后，InteractiveViewer 的 alignPanAxis 属性已被移除，并由 panAxis 替换。进行此更改是为了在 InteractiveViewer 中启用更多平移模式。

迁移指南

迁移前代码

dartInteractiveViewer(
  alignPanAxis: true,
);

迁移后代码

dartInteractiveViewer(
  panAxis: PanAxis.aligned,
);

参考

API 文档

相关 PR

弃用自 #109014
移除自 #142500

包：flutter Flutter Fix 支持：是

在 v3.5 之后，MediaQuery 的 boldTextOverride 方法已被移除，并由 boldTextOf 替换。此更改是 MediaQuery 更大重构的一部分，最显著的是减少了依赖它的 widget 触发的重建次数。

迁移指南

迁移前代码

dart

MediaQuery.boldTextOverride(context);

迁移后代码

dart

MediaQuery.boldTextOf(context)

参考

API 文档

MediaQuery

相关 PR

弃用自 #114459
移除自 #143960

包：flutter Flutter Fix 支持：否

随着 AnimatedGrid 的添加，AnimatedList 被重构以共享一个公共基类。之前命名的 AnimatedListItemBuilder 和 AnimatedListRemovedItemBuilder 被重命名，以便更好地反映它们可以在 v3.5 之后与哪些类一起使用。重命名对 AnimatedItemBuilder 和 AnimatedRemovedItemBuilder 的任何引用。

参考

API 文档

相关 PR

弃用自 #113793
移除自 #143974

包：flutter_driver Flutter Fix 支持：是

flutterDriver 的 enableAccessibility 方法在 v2.3 中被弃用。它已被移除并由 setSemantics 替换。此更改使得可以启用或禁用辅助功能，而不仅仅是启用它。

迁移指南

迁移前代码

dartFlutterDriver driver = FlutterDriver.connectedTo(
  // ...
);
driver.enableAccessibility();

迁移后代码

dartFlutterDriver driver = FlutterDriver.connectedTo(
  // ...
);
driver.setSemantics(true);

参考

API 文档

FlutterDriver

相关 PR

弃用自 #82939
移除自 #143979

包：flutter_driver Flutter Fix 支持：是

TimelineSummary 的 writeSummaryToFile 方法在 v2.1 中被弃用。它已被移除并由 writeTimelineToFile 替换。

迁移指南

迁移前代码

dartTimelineSummary summary = TimelineSummary.summarize(
  myTimeline,
);
summary.writeSummaryToFile(
  traceName,
  pretty: true,
);

迁移后代码

dartTimelineSummary summary = TimelineSummary.summarize(
  myTimeline,
);
summary.writeTimelineToFile(
  traceName,
  pretty: true,
);

参考

API 文档

TimelineSummary

相关 PR

弃用自 #79310
移除自 #143983

Flutter Fix 支持：否

从 Flutter 3.0 开始，平台视图需要 api 23 或更高版本。在 Flutter 3.19 中，当在运行 api 级别 22 及以下的 Android 设备上使用平台视图时，我们现在会抛出 UnsupportedOperationException。

迁移指南

将最低 api 级别设置为 23（或更高）或在显示平台视图之前检查 Android api 级别。

关于上下文菜单的先前宣布的弃用，涉及 ToolbarOptions 以及 TextSelectionController 和 SelectableRegionState 的部分内容，在本周期中未被移除，以留出更多时间进行迁移。预计这些弃用将在下个周期中被移除，届时将再次宣布。

稳定版：3.22.0

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

v3.19 后移除的已弃用 API

摘要

更改

`TextTheme`

`ThemeData`

`CupertinoContextMenu.previewBuilder`

`Scrollbar.showTrackOnHover`

`KeepAliveHandle.release` 方法

`InteractiveViewer.alignPanAxis`

`MediaQuery.boldTextOverride`

重命名 `AnimatedList` 的构建器类型定义

`FlutterDriver.enableAccessibility`

`TimelineSummary.writeSummaryToFile`

`API 22 及以下版本的 Android 平台视图`

时间线

摘要

更改

TextTheme

ThemeData

CupertinoContextMenu.previewBuilder

Scrollbar.showTrackOnHover

KeepAliveHandle.release 方法

InteractiveViewer.alignPanAxis

MediaQuery.boldTextOverride

重命名 AnimatedList 的构建器类型定义

FlutterDriver.enableAccessibility

TimelineSummary.writeSummaryToFile

API 22 及以下版本的 Android 平台视图

时间线

`TextTheme`

`ThemeData`

`CupertinoContextMenu.previewBuilder`

`Scrollbar.showTrackOnHover`

`KeepAliveHandle.release` 方法

`InteractiveViewer.alignPanAxis`

`MediaQuery.boldTextOverride`

重命名 `AnimatedList` 的构建器类型定义

`FlutterDriver.enableAccessibility`

`TimelineSummary.writeSummaryToFile`

`API 22 及以下版本的 Android 平台视图`