重要改动 (Breaking changes)

As described in the breaking change policy, on occasion we publish guides for migrating code across a breaking change.

The following guides are available. They sorted by release, and listed in alphabetical order:

Not yet released to stable

• Android ActivityControlSurface attachToActivity signature change
• Material Chip button semantics
• Network Policy on iOS and Android
• SnackBars managed by the ScaffoldMessenger
• TextSelectionTheme migration
• Android FlutterMain.setIsRunningInRobolectricTest testing API removed
• Clip behavior
• Dry layout support for RenderBox

Released in Flutter 1.22

• Android v1 embedding app and plugin creation deprecation
• Cupertino icons 1.0.0
• The new Form, FormField auto-validation API

Released in Flutter 1.20

• Actions API revision
• Adding TextInputClient.currentAutofillScope property
• Dialogs’ Default BorderRadius
• More Strict Assertions in the Navigator and the Hero Controller Scope
• The Route Transition record and Transition delegate updates
• The RenderEditable needs to be laid out before hit testing
• Reversing the dependency between the scheduler and services layer
• Semantics Order of the Overlay Entries in Modal Routes
• showAutocorrectionPromptRect method added to TextInputClient
• TestWidgetsFlutterBinding.clock
• TextField requires MaterialLocalizations

Released in Flutter 1.17

• Adding ‘linux’ and ‘windows’ to TargetPlatform enum
• Annotations return local position relative to object
• Container color optimization
• CupertinoTabBar requires Localizations parent
• Generic type of ParentDataWidget changed to ParentData
• ImageCache and ImageProvider changes
• ImageCache large images
• MouseTracker moved to rendering
• MouseTracker no longer attaches annotations
• Nullable CupertinoTheme.brightness
• Rebuild optimization for OverlayEntries and Routes
• Scrollable AlertDialog
• TestTextInput state reset
• TextInputClient currentTextEditingValue
• The forgetChild() method must call super
• The Route and Navigator refactoring
• ThemeData’s accent properties