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.
838 indexed changes across 16 versions: 2 breaking change, 3 removed, 1 deprecated api, 140 new feature, 238 improvement, 15 performance, 124 platform-specific, 138 developer tooling, 159 bug fix, 18 documentation.
5 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; Removal of describeEnum; ….
Read the 3 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`.
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).
[Android] Test to verify AnnounceSemanticsEvent deprecation warning on API 36 (Android, by @mboetger).
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.