Deprecated API removed after v1.22

In accordance with Flutter's Deprecation Policy, deprecated APIs that reached end of life after the 1.22 stable release have been removed. This is the first time that deprecated APIs have been removed from Flutter, and some of these deprecations predate our migration guide policy.

All affected APIs have been compiled into this primary source to aid in migration. A quick reference sheet is available as well.

A design document and article are available for more context on Flutter's deprecation policy.

This section lists the deprecations, listed by the affected class.

Supported by fix tool: IDE fix only.

CupertinoDialog was deprecated in v0.2.3. Use CupertinoAlertDialog or CupertinoPopupSurface instead.

Migration guide

CupertinoAlertDialog

Code before migration:

CupertinoDialog(child: myWidget);

Code after migration:

CupertinoAlertDialog(content: myWidget);

CupertinoPopupSurface

Code before migration:

CupertinoDialog(child: myWidget);

Code after migration:

CupertinoPopupSurface(child: myWidget);

References

API documentation:

• CupertinoAlertDialog
• CupertinoPopupSurface

Relevant issues:

• Deprecate CupertinoDialog class

Relevant PRs:

• Deprecated in #20649
• Removed in #73604

Supported by fix tool: No

CupertinoNavigationBar.actionsForegroundColor and CupertinoSliverNavigationBar.actionsForegroundColor were deprecated in v1.1.2. Setting primaryColor in your CupertinoTheme propagates this instead. To access the primaryColor, call CupertinoTheme.of(context).primaryColor.

Migration guide

Code before migration:

CupertinoNavigationBar(
  actionsForegroundColor: CupertinoColors.systemBlue,
);
CupertinoSliverNavigationBar(
  actionsForegroundColor: CupertinoColors.systemBlue,
);

Code after migration:

CupertinoTheme(
  data: CupertinoThemeData(
    primaryColor: CupertinoColors.systemBlue
  ),
  child: ...
);

// To access the color from the `CupertinoTheme`
CupertinoTheme.of(context).primaryColor;

References

API documentation:

• CupertinoNavigationBar
• CupertinoSliverNavigationBar
• CupertinoTheme
• CupertinoThemeData

Relevant issues:

• Create a CupertinoApp and a CupertinoTheme

Relevant PRs:

• Deprecated in #23759
• Removed in #73745

Supported by fix tool: Yes

CupertinoTextThemeData.brightness was deprecated in v1.10.14. This field member was made ineffective at the time of deprecation. There is no replacement for this parameter, references should be removed.

Migration guide

Code before migration:

const CupertinoTextThemeData themeData = CupertinoTextThemeData(brightness: Brightness.dark);
themeData.copyWith(brightness: Brightness.light);

Code after migration:

const CupertinoTextThemeData themeData = CupertinoTextThemeData();
themeData.copyWith();

References

API documentation:

• CupertinoTextThemeData

Relevant issues:

• Revise CupertinoColors and CupertinoTheme for dynamic colors

Relevant PRs:

• Deprecated in #41859
• Removed in #72017

Supported by fix tool: Yes

The fromHoverEvent constructors for PointerEnterEvent and PointerExitEvent were deprecated in v1.4.3. The fromMouseEvent constructor should be used instead.

Migration guide

Code before migration:

final PointerEnterEvent enterEvent = PointerEnterEvent.fromHoverEvent(PointerHoverEvent());
final PointerExitEvent exitEvent = PointerExitEvent.fromHoverEvent(PointerHoverEvent());

Code after migration:

final PointerEnterEvent enterEvent = PointerEnterEvent.fromMouseEvent(PointerHoverEvent());
final PointerExitEvent exitEvent = PointerExitEvent.fromMouseEvent(PointerHoverEvent());

References

API documentation:

• PointerEnterEvent
• PointerExitEvent

Relevant issues:

• PointerEnterEvent and PointerExitEvent can only be created from hover events

Relevant PRs:

• Deprecated in #28602
• Removed in #72395

Supported by fix tool: Yes

The child parameter of showDialog was deprecated in v0.2.3. The builder parameter should be used instead.

Migration guide

Code before migration:

showDialog(child: myWidget);

Code after migration:

showDialog(builder: (context) => myWidget);

References

API documentation:

• showDialog

Relevant issues:

• showDialog should take a builder rather than a child

Relevant PRs:

• Deprecated in #15303
• Removed in #72532

Supported by fix tool: Yes

The resizeToAvoidBottomPadding parameter of Scaffold was deprecated in v1.1.9. The resizeToAvoidBottomInset parameter should be used instead.

Migration guide

Code before migration:

Scaffold(resizeToAvoidBottomPadding: true);

Code after migration:

Scaffold(resizeToAvoidBottomInset: true);

References

API documentation:

• Scaffold

Relevant issues:

• Show warning when nesting Scaffolds
• SafeArea with keyboard
• Double stacked material scaffolds shouldn't double resizeToAvoidBottomPadding
• viewInsets and padding on Window and MediaQueryData should define how they interact
• bottom overflow issue, when using textfields inside tabbarview

Relevant PRs:

• Deprecated in #26259
• Removed in #72890

Supported by fix tool: No

The bar constructor of ButtonTheme was deprecated in v1.9.1. ButtonBarTheme can be used instead for ButtonBars, or use another constructor of ButtonTheme if the use is not specific to ButtonBar.

Button-specific theming is also available with the TextButtonTheme, ElevatedButtonTheme, and OutlinedButtonTheme classes, each corresponding with the appropriate button class, TextButton, ElevatedButton and OutlinedButton.

Migration guide

Code before migration:

ButtonTheme.bar(
  minWidth: 10.0,
  alignedDropdown: true,
  height: 40.0,
);

Code after migration, using ButtonTheme:

ButtonTheme(
  minWidth: 10.0,
  alignedDropdown: true,
  height: 40.0,
);

Code after migration, using ButtonBarTheme:

ButtonBarTheme(
  data: ButtonBarThemeData(
    buttonMinWidth: 10.0,
    buttonAlignedDropdown: true,
    buttonHeight: 40.0,
  )
);

References

API documentation:

• ButtonTheme
• ButtonBarTheme
• ButtonBar
• TextButtonTheme
• TextButton
• ElevatedButtonTheme
• ElevatedButton
• OutlinedButtonTheme
• OutlinedButton

Relevant issues:

• ButtonTheme.bar uses accent color when it should be using primary color
• ThemeData.accentColor has insufficient contrast for text
• Increased height as a result of changes to materialTapTargetSize affecting AlertDialog/ButtonBar heights

Relevant PRs:

• Deprecated in #37544
• Removed in #73746

Supported by fix tool: No

The following methods were deprecated in the InlineSpan, TextSpan and PlaceholderSpan in order to enable embedding widgets inline into paragraphs, like images.

Migration guide

References

API documentation:

• InlineSpan
• TextSpan
• PlaceholderSpan
• WidgetSpan

Relevant issues:

• Text: support inline images

Relevant PRs:

• Development history:
  • #30069
  • #33946
  • #33794
• Deprecated in #34051
• Removed in #73747

Supported by fix tool: No

The RenderView.scheduleInitialFrame method was deprecated and removed in order to prevent splash screens from being taken down too early, resulting in a black screen. This would happen when WidgetsFlutterBinding.ensureInitialized was called. Instead, replace calls to this method with RenderView.prepareInitialFrame, followed by RenderView.owner.requestVisualUpdate.

Migration guide

Code before migration:

scheduleInitialFrame();

Code after migration:

prepareInitialFrame();
owner.requestVisualUpdate();

References

API documentation:

• RenderView
• WidgetsFlutterBinding

Relevant issues:

• WidgetsFlutterBinding.ensureInitialized() takes down splash screen too early

Relevant PRs:

• Deprecated in #39535
• Removed in #73748

Supported by fix tool: No

The Layer.findAll method was deprecated with the introduction of Layer.findAnnotations in order to unify the implementations of find and findAll. To migrate affected code, call findAllAnnotations instead. This method returns an AnnotationResult, containing the former return value of findAll in AnnotationResult.annotations.

Migration guide

Code before migration:

findAll(offset);

Code after migration:

findAllAnnotations(offset).annotations;

References

API documentation:

• Layer
• MouseRegion
• RenderMouseRegion
• AnnotatedRegionLayer
• AnnotationResult

Relevant issues:

• Breaking Proposal: MouseRegion defaults to opaque; Layers are required to implement findAnnotations

Relevant PRs:

• Initially changed in #37896
• Deprecated in #42953
• Removed in #73749

Supported by fix tool: No

The BinaryMessages class, its associated static methods and the defaultBinaryMessenger getter were deprecated and removed. The defaultBinaryMessenger instance was moved to ServicesBinding. This made it possible to register a different default BinaryMessenger under testing environment, by creating a ServicesBinding subclass for testing. Doing so allows you to track the number of pending platform messages for synchronization purposes.

Migration guide

References

API documentation:

• ServicesBinding
• BinaryMessenger

Relevant issues:

• Flutter synchronization support for Espresso/EarlGrey

Relevant PRs:

• Initially changed in #37489
• Deprecated in #38464
• Removed in #73750

Supported by fix tool: Yes

Several methods in BuildContext were using Type to search for ancestors. Most of those methods implied a cast at call site because their return type was a parent type. Moreover the type provided was not checked at analysis time even if the type is actually constrained. Making these methods generics improves type safety and requires less code.

These method changes affect the BuildContext, Element, and StatefulElement classes. The TypeMatcher class was also removed.

Migration guide

Code before migration:

ComplexLayoutState state = context.ancestorStateOfType(const TypeMatcher<ComplexLayoutState>()) as ComplexLayoutState;

Code after migration:

ComplexLayoutState state = context.ancestorStateOfType<ComplexLayoutState>();

BuildContext

Element

StatefulElement

References

API documentation:

• Type
• BuildContext
• Element
• StatefulElement

Relevant PRs:

• Deprecated in #44189
• Removed in:
  • #69620
  • #72903
  • #72901
  • #73751

Supported by fix tool: Yes

The deferFirstFrameReport and allowFirstFrameReport methods of WidgetsBinding were deprecated and removed in order to provide the option to delay rendering the first frame. This is useful for widgets that need to obtain initialization information asynchronously and while they are waiting for that information no frame should render as that would take down the splash screen pre-maturely. The deferFirstFrame and allowFirstFrame methods should be used respectively instead.

Migration guide

Code before migration:

final WidgetsBinding binding = WidgetsBinding.instance;
binding.deferFirstFrameReport();
binding.allowFirstFrameReport();

Code after migration:

final WidgetsBinding binding = WidgetsBinding.instance;
binding.deferFirstFrame();
binding.allowFirstFrame();

References

API documentation:

• WidgetsBinding

Relevant PRs:

• Initially changed in
  • #45135
  • #45588
• Deprecated in #45941
• Removed in #72893

Supported by fix tool: No

The WaitUntilNoTransientCallbacks, WaitUntilNoPendingFrame, and WaitUntilFirstFrameRasterized methods from the flutter_driver packages were deprecated and removed in order to provide a more composable waitForCondition API that can be used to compose conditions that the client would like to wait for.

Migration guide

References

API documentation:

• WaitForCondition

Relevant issues:

• Flutter synchronization support for Espresso/EarlGrey

Relevant PRs:

• Initially changed in #37736
• Deprecated in #38836
• Removed in #73754

除非另有说明，本文档之所提及适用于 Flutter 的最新稳定版本，本页面最后更新时间: 2024-06-01。 查看文档源码 或者 为本页面内容提出建议。