重要改动 (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:

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

Not yet released to stable

• Actions API revision
• Adding TextInputClient.currentAutofillScope
• Reversing the dependency between the scheduler and services layer
• showAutocorrectionPromptRect method added to TextInputClient
• The RenderEditable needs to be laid out before hit testing
• The Route Transition record and Transition delegate updates
• TestWidgetsFlutterBinding.clock