破坏性改动 (Breaking changes)
尚未发布到稳定版
Not yet released to stable
已经在 Flutter 2.10 中发布
Released in Flutter 2.10
已经在 Flutter 2.5 中发布
Released in Flutter 2.5
在 2.2 版本中回退的改动
Reverted change in 2.2
发布于 Flutter 2.2
Released in Flutter 2.2
发布于 Flutter 2
Released in Flutter 2
发布于 Flutter 1.22
Released in Flutter 1.22
发布于 Flutter 1.20
Released in Flutter 1.20
发布于 Flutter 1.17
Released in Flutter 1.17
正如 破坏性改动策略 中描述的,我们会不定期地发布关于破坏性改动的迁移指南。
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 are sorted by release, and listed in alphabetical order:
尚未发布到稳定版
Not yet released to stable
- Deprecated API removed after v2.10
- Page transitions replaced by ZoomPageTransitionsBuilder
- Migrate useDeleteButtonTooltip to deleteButtonTooltipMessage of Chips
- ThemeData’s toggleableActiveColor property has been deprecated
已经在 Flutter 2.10 中发布
Released in Flutter 2.10
- Deprecated API removed after v2.5
- Raw images on Web uses correct origin and colors
- Required Kotlin version
- Scribble Text Input Client
已经在 Flutter 2.5 中发布
Released in Flutter 2.5
- Default drag scrolling devices
- Deprecated API removed after v2.2
- Change the enterText method to move the caret to the end of the input text
- GestureRecognizer Cleanup
- Introducing package:flutter_lints
- Replace AnimationSheetBuilder.display with collate
- ThemeData’s accent properties have been deprecated
- Transition of platform channel test interfaces to flutter_test package
- Using HTML slots to render platform views in the web
在 2.2 版本中回退的改动
Reverted change in 2.2
以下重要改动在 Flutter 2.2 中已被回退。
The following breaking change was reverted in release 2.2:
iOS 端和 Android 端的网络策略
引入版本:2.0.0
回退版本:2.2.0(建议)
Network Policy on iOS and Android
Introduced in version: 2.0.0
Reverted in version: 2.2.0 (proposed)
发布于 Flutter 2.2
Released in Flutter 2.2
发布于 Flutter 2
Released in Flutter 2
- Added BuildContext parameter to TextEditingController.buildTextSpan
- Android ActivityControlSurface attachToActivity signature change
- Android FlutterMain.setIsRunningInRobolectricTest testing API removed
- Clip behavior
- Deprecated API removed after v1.22
- Dry layout support for RenderBox
- Eliminating nullOk Parameters
- Material Chip button semantics
- SnackBars managed by the ScaffoldMessenger
- TextSelectionTheme migration
- Use maxLengthEnforcement instead of maxLengthEnforced
- Transition of platform channel test interfaces to flutter_test package
发布于 Flutter 1.22
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
发布于 Flutter 1.20
Released in Flutter 1.20
- Actions API revision
- Adding TextInputClient.currentAutofillScope property
- New Buttons and Button Themes
- 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
发布于 Flutter 1.17
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
- FloatingActionButton and ThemeData’s accent properties