Update CHANGELOG.md for Flutter 3.38.3 #178935
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Added release notes for Flutter version 3.38.3.
Added instructions to run 'gclient sync' before and after updating dependencies.
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
Contributor
There was a problem hiding this comment.
Code Review
This pull request updates the CHANGELOG.md file to include release notes for Flutter version 3.38.3. My review focuses on improving the clarity and usefulness of the new changelog entries to align with the project's documentation standards. I've suggested making the descriptions more problem-oriented and user-focused, as outlined in the repository's style guide and hotfix documentation best practices.
|
|
||
| ### [3.38.3](https://github.com/flutter/flutter/releases/tag/3.38.3) | ||
|
|
||
| - [flutter/178772](https://github.com/flutter/flutter/issues/178772) Flutter engine reports a different version than the framework. |
Contributor
There was a problem hiding this comment.
This changelog entry is the same as the issue title. Per the project's documentation guidelines, documentation should be useful and explain the 'why' and 'how'.1 The current description doesn't clarify the user-facing impact. Please enhance the description to explain where this version mismatch appears and why it's a problem for users. For more specific guidance, refer to the docs/releases/Hotfix-Documentation-Best-Practices.md file.
Suggested change
| - [flutter/178772](https://github.com/flutter/flutter/issues/178772) Flutter engine reports a different version than the framework. | |
| - [flutter/178772](https://github.com/flutter/flutter/issues/178772) Fixes an issue where `flutter --version` could report a mismatched engine version, which could cause confusion for developers. |
Style Guide References
Footnotes
-
The style guide emphasizes that documentation should be useful, explaining the 'why' and 'how'. Changelog entries, as a form of documentation for releases, should clearly communicate the impact of a change to the user. ↩
| ### [3.38.3](https://github.com/flutter/flutter/releases/tag/3.38.3) | ||
|
|
||
| - [flutter/178772](https://github.com/flutter/flutter/issues/178772) Flutter engine reports a different version than the framework. | ||
| - [flutter/178804](https://github.com/flutter/flutter/issues/178804) Bump Dart version to [3.10.1](https://github.com/dart-lang/sdk/blob/3.10.1/CHANGELOG.md#3101). |
Contributor
There was a problem hiding this comment.
This entry describes an action ('Bump Dart version') rather than the user-facing problem it solves. The style guide states that documentation should be useful.1 To make this entry more useful for users, please summarize the key fixes or improvements from the Dart 3.10.1 update that are relevant to Flutter developers. This helps them understand the benefits of the update. The docs/releases/Hotfix-Documentation-Best-Practices.md file provides more detailed guidance on writing effective hotfix notes.
Style Guide References
Footnotes
-
The style guide emphasizes that documentation should be useful. A changelog entry that only states a version bump without explaining its benefits is not as useful as it could be for developers trying to understand the changes. ↩
gmackall
approved these changes
Nov 21, 2025
mboetger
approved these changes
Nov 21, 2025
reidbaker
added
the
autosubmit
auto-submit
bot
removed
the
autosubmit
Contributor
|
autosubmit label was removed for flutter/flutter/178935, because - The status or check suite Linux analyze has failed. Please fix the issues identified (or deflake) before re-applying this label. |
justinmc
approved these changes
Nov 21, 2025
Contributor
justinmc
left a comment
justinmc
left a comment
There was a problem hiding this comment.
LGTM besides the analyzer failure.
DEPS
Outdated
| # Dart is: https://github.com/dart-lang/sdk/blob/main/DEPS | ||
| # You can use //tools/dart/create_updated_flutter_deps.py to produce | ||
| # updated revision list of existing dependencies. | ||
| # updated revision list of existing dependencies. You will need to |
Contributor
There was a problem hiding this comment.
Looks like there is a trailing space here and that's why it's failing!
reidbaker
added
the
autosubmit
auto-submit
bot
removed
the
autosubmit
Contributor
|
autosubmit label was removed for flutter/flutter/178935, because Pull request flutter/flutter/178935 is not in a mergeable state. |
reidbaker
added
the
autosubmit
auto-submit
bot
removed
the
autosubmit
Contributor
|
autosubmit label was removed for flutter/flutter/178935, because Pull request flutter/flutter/178935 is not in a mergeable state. |
reidbaker
added
the
autosubmit
flutter-dashboard
bot
removed
the
autosubmit
engine-flutter-autoroll
added a commit
to engine-flutter-autoroll/packages
that referenced
this pull request
Nov 25, 2025
engine-flutter-autoroll
added a commit
to engine-flutter-autoroll/packages
that referenced
this pull request
Nov 25, 2025
engine-flutter-autoroll
added a commit
to engine-flutter-autoroll/packages
that referenced
this pull request
Nov 25, 2025
engine-flutter-autoroll
added a commit
to engine-flutter-autoroll/packages
that referenced
this pull request
Nov 25, 2025
engine-flutter-autoroll
added a commit
to engine-flutter-autoroll/packages
that referenced
this pull request
Nov 25, 2025
engine-flutter-autoroll
added a commit
to engine-flutter-autoroll/packages
that referenced
this pull request
Nov 25, 2025
engine-flutter-autoroll
added a commit
to engine-flutter-autoroll/packages
that referenced
this pull request
Nov 26, 2025
engine-flutter-autoroll
added a commit
to engine-flutter-autoroll/packages
that referenced
this pull request
Nov 26, 2025
auto-submit bot
pushed a commit
to flutter/packages
that referenced
this pull request
Nov 26, 2025
flutter/flutter@3f553f6...7b98d50 2025-11-26 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Fix for win32 embedder failing to send all alt key downs to the flutter app (#179097)" (flutter/flutter#179136) 2025-11-26 [email protected] Fix for win32 embedder failing to send all alt key downs to the flutter app (flutter/flutter#179097) 2025-11-26 [email protected] Modernize framework lints (flutter/flutter#179089) 2025-11-25 98614782+auto-submit[bot]@users.noreply.github.com Reverts "Add framework-side hitTestBehavior support to Semantics (#178817)" (flutter/flutter#179100) 2025-11-25 [email protected] Add framework-side hitTestBehavior support to Semantics (flutter/flutter#178817) 2025-11-25 [email protected] Roll Packages from e019cf9 to cc3dca6 (1 revision) (flutter/flutter#179081) 2025-11-25 [email protected] Add tooltip windows to the windowing API alongside the window positioning logic (flutter/flutter#177404) 2025-11-25 [email protected] FlutterWindowsView::SendWindowMetrics now reliably sends the display_id (flutter/flutter#179053) 2025-11-25 [email protected] Remove semantics geometry shortcircuit (flutter/flutter#178680) 2025-11-25 [email protected] Add an assert message when OverlayEntry.remove is called twice (flutter/flutter#178163) 2025-11-25 [email protected] Roll Fuchsia Linux SDK from pOO9Jl9HTLsEmks6y... to nzuAxCJGeJbkZCTkr... (flutter/flutter#179066) 2025-11-25 [email protected] Dynamically set MinimumOSVersion in App.framework (flutter/flutter#178253) 2025-11-25 [email protected] Roll Skia from d83c30b090f4 to 925c311f4b37 (2 revisions) (flutter/flutter#179060) 2025-11-25 [email protected] Marks Linux build_android_host_app_with_module_aar to be unflaky (flutter/flutter#174864) 2025-11-25 [email protected] Marks Linux_mokey complex_layout__start_up to be unflaky (flutter/flutter#174865) 2025-11-25 [email protected] Manual Dart SDK roll to 3.11.0-169.0.dev (flutter/flutter#179054) 2025-11-25 [email protected] Bump Dart to 3.9 (flutter/flutter#179041) 2025-11-25 [email protected] Roll Skia from e298c2f93ebf to d83c30b090f4 (2 revisions) (flutter/flutter#179058) 2025-11-24 [email protected] updated licenses_cpp readme (flutter/flutter#178874) 2025-11-24 [email protected] Roll Skia from 43d2020be565 to e298c2f93ebf (5 revisions) (flutter/flutter#179046) 2025-11-24 [email protected] Refactor `_isLabel` method in `stepper.dart` to use `any` for better readablity (flutter/flutter#178909) 2025-11-24 49699333+dependabot[bot]@users.noreply.github.com Bump actions/checkout from 5 to 6 in the all-github-actions group (flutter/flutter#179049) 2025-11-24 [email protected] Disposes test restoration manager when accessed by bindings (flutter/flutter#176519) 2025-11-24 [email protected] [ Widget Preview ] Always generate scaffold under `$TMP` (flutter/flutter#179039) 2025-11-24 [email protected] Roll Packages from e67b6be to e019cf9 (9 revisions) (flutter/flutter#179035) 2025-11-24 [email protected] Update CHANGELOG.md for Flutter 3.38.3 (flutter/flutter#178935) 2025-11-24 [email protected] Remove unnecessary `String.valueOf` in `SettingsChannel.java` (flutter/flutter#178590) 2025-11-24 [email protected] Roll pub manually, pick up flutter_lints in examples/api (flutter/flutter#179030) 2025-11-24 [email protected] Roll Dart SDK from 24cc9a740bd3 to afca43095efa (1 revision) (flutter/flutter#179019) 2025-11-24 [email protected] Pass EXCLUDED_ARCHS from Xcode project to xcodebuild for macOS builds (flutter/flutter#176948) If this roll has caused a breakage, revert this CL and stop the roller using the controls here: https://autoroll.skia.org/r/flutter-packages Please CC [email protected],[email protected] on the revert to ensure that a human is aware of the problem. To file a bug in Packages: https://github.com/flutter/flutter/issues/new/choose To report a problem with the AutoRoller itself, please file a bug: https://issues.skia.org/issues/new?component=1389291&template=1850622 Documentation for the AutoRoller is here: https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
mboetger
pushed a commit
to mboetger/flutter
that referenced
this pull request
Dec 2, 2025
Added release notes for Flutter version 3.38.3. and better instructions for updating dart version in deps.
reidbaker
added a commit
to AbdeMohlbi/flutter
that referenced
this pull request
Dec 10, 2025
Added release notes for Flutter version 3.38.3. and better instructions for updating dart version in deps.
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Added release notes for Flutter version 3.38.3.
and better instructions for updating dart version in deps.