Skip to content
Boring Doc

Version Comparison Studio

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.

Categories
Platform
Explain

3.22.3 → 3.24.5Jul 18, 2024 → Nov 14, 2024 · 6 releases in range

Sort:impactversioncategorytopicHide unreviewed
Changes in range
47
Breaking / removed
3
4 with migration guides
Deprecations
1
plan before they are removed
Official evidence
47
4 official migration guide, 43 official changelog

Summary

What changed?

47 indexed changes across 6 versions: 3 breaking change, 1 deprecated api, 43 bug fix.

Will this affect my application?

3 high-impact items. Start with: Navigator's page APIs breaking change; Generic types in PopScope; New APIs for Android plugins that render to a Surface.

What action should I take?

Read the 4 official migration guides first, apply `dart fix` where available, then upgrade and run your test suite. Deprecations can be scheduled; removals cannot.

How do I migrate safely?

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.

What this comparison covers
  • Release-note items are indexed for the most recent series only. For 3.24 this comparison shows official breaking-change guides and hotfix notes.
  • Release-note items are classified from PR titles (heuristic); breaking-change guides are classified from the official index.

Releases in range

  1. 3.24.0
    Aug 6, 2024
    4 changes
  2. 3.24.1
    Aug 21, 2024
    19 changes
  3. 3.24.2
    Sep 4, 2024
    9 changes
  4. 3.24.3
    Sep 12, 2024
    10 changes
  5. 3.24.4
    Oct 24, 2024
    3 changes
  6. 3.24.5
    Nov 14, 2024
    2 changes

Verified source change (GitHub)

Tick “Fetch verified source diff” above (or load it now) to corroborate these announcements with the git history between the two tags.

Changes by category

47 shown

Breaking Breaking change 3

BreakingHigh impact3.24.0 migration guide

Generic types in PopScope

Added a generic type to the `PopScope` class and replaced the `onPopInvoked` with a new method `onPopInvokedWithResult`. The new method takes a boolean `didPop` and a `result` as position parameters.

Official migration guideVerified classificationFrameworkSource Details
BreakingHigh impact3.24.0android migration guide

New APIs for Android plugins that render to a Surface

The Android embedder for Flutter introduces a new API, `SurfaceProducer`, which allows plugins to render to a `Surface` without needing to manage what the backing implementation is. Plugins using the older `createSurfaceTexture` API will continue to work with Impeller after the _next_ stable release, but are recommended to migrate to the new API.

Official migration guideVerified classificationFrameworkSource Details

Deprecated Deprecated API 1

DeprecatedMedium impact3.24.0 migration guide

Deprecate ButtonBar in favor of OverflowBar

The `ButtonBar` widget was deprecated in favor of the more efficient `OverflowBar` widget. As a result, `ThemeData.buttonBarTheme` and `ButtonBarTheme` were also deprecated.

Official migration guideVerified classificationFrameworkSource Details

Bug fix Bug fix 43

AIExplain this upgrade

AI explanationAI-generated · grounded in cited sources
AI explanations are not configured
Set 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.
Was this useful?