Choose two real stable releases. Boring Doc lists every indexed change between them with its evidence, impact and migration instructions, and can fetch the verified source diff from GitHub.
1698 indexed changes across 18 versions: 8 breaking change, 3 removed, 10 deprecated api, 299 new feature, 567 improvement, 28 performance, 188 platform-specific, 247 developer tooling, 316 bug fix, 32 documentation.
11 high-impact items. Start with: OpenGL ES render-to-texture content is stored top-down; Update semantics header and headingLevel behavior on iOS and Android; Changing RawMenuAnchor close order; ….
Read the 10 official migration guides first, apply `dart fix` where available, then upgrade and run your test suite. Deprecations can be scheduled; removals cannot.
Prefer stepping through stable series sequentially; each breaking-change page has a checklist, before/after code and the official guide. Verify with `flutter analyze`, `flutter test` and a profile-mode run on each target platform.
Tick “Fetch verified source diff” above (or load it now) to corroborate these announcements with the git history between the two tags.
Impeller's OpenGL ES backend now stores render-to-texture content top-down, the same as the Metal and Vulkan backends. A fragment shader or Flutter GPU app that sampled a render-target texture on OpenGL ES and added a vertical flip to compensate for the old bottom-up orientation now renders that content upside down.
The `header` semantics property now behaves as a no-op on iOS and Android. To declare a section heading for accessibility purposes on these platforms, use the `headingLevel` property with a value greater than `0`.
Closing a `RawMenuAnchor` now triggers the `onCloseRequested` and `onClose` callbacks for all descendant `RawMenuAnchor`s. The `onCloseRequested` callback is triggered top-down, starting from the triggering `RawMenuAnchor` and moving to its descendants, while the `onClose` callback is triggered bottom-up. If a `RawMenuAnchor` is already closed, calls to `MenuController.close` and `MenuController.closeChildren` don't trigger the `onCloseRequested` callback.
The `IconData` class is now marked as `final`, which prevents it from being implemented or extended. This change is part of an effort to generalize the mechanism for tree-shaking assets and native code.
For apps targeting Android 17 or higher, orientation, resizability, and aspect ratio restrictions no longer apply on displays with width 600dp or greater. This means that `SystemChrome.setPreferredOrientations` is ignored on these devices.
When a widget with a non-transparent background color, such as a `Container` or `ColoredBox` that sets `color`, sits between a `ListTile` and its nearest `Material` ancestor, the framework now reports an error.
`CupertinoPageTransitionsBuilder` has been relocated from `package:material_ui/material_ui.dart` to the Cupertino package, which is now in `package:cupertino_ui/cupertino_ui.dart`.
Fix README images + breaking change links (Framework, by @loic-sharma).
The `describeEnum` method has been removed from the framework because it's redundant with the `name` getter on `Enum` which was introduced in `Dart 2.14`.
Remove use of deprecated copy_trees. (Other changes, by @rmacnak-google).
Remove use of deprecated API related to removal of the VM isolate. (Other changes, by @rmacnak-google).
The `onReorder` callback in the `ReorderableListView`, `ReorderableListView.builder`, `ReorderableList`, and `SliverReorderableList` widgets has been replaced by a new callback, `onReorderItem`, which provides more intuitive behavior for `newIndex`.
`TextInputConnection.setStyle` is deprecated in favor of `TextInputConnection.updateStyle`, which supports synchronizing `letterSpacing`, `wordSpacing`, and `lineHeight` to the engine.
Flutter 3.44 deprecates `cacheExtent` and `cacheExtentStyle` in scrolling-related widgets, such as `ListView`, `GridView`, `CustomScrollView`, and `Viewport`, and their corresponding render objects, such as `RenderViewport`. The new `scrollCacheExtent` property encapsulates both the value and the caching strategy (pixels or viewport).
[Android] Test to verify AnnounceSemanticsEvent deprecation warning on API 36 (Android, by @mboetger).
Fix deprecation validator message to require leading v (Framework, by @ashoknarayan).
Deprecate onReorder callback (Material, by @navaronbracke).
[skia] Disable use of deprecated Mock GrBackendSurface (Android, by @kjlubick).
[Android] Use EdgeToEdge.enable/WindowCompat for edge-to-edge mode instead of deprecated View flags (Android, by @dbebawy).
[flutter_tools] Deprecate `plugin_ffi` template (Tooling, by @dcharkes).
[flutter_tools] Deprecate web hot reload flag (Tooling, by @nshahan).
AI_PROVIDER (for example to openai-compatible with a local Ollama or LM Studio endpoint) to enable grounded explanations. Everything else on this page works without an AI provider.