From cd6b4d63836ce88c43f0c5ab535ba11279359a8b Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Thu, 6 Nov 2025 14:38:18 -0800 Subject: [PATCH 1/9] Updating what's new --- src/content/release/archive-whats-new.md | 67 +++++++++++ src/content/release/whats-new.md | 138 ++++++++++++----------- 2 files changed, 138 insertions(+), 67 deletions(-) diff --git a/src/content/release/archive-whats-new.md b/src/content/release/archive-whats-new.md index 0db95986b64..65b8565c00a 100644 --- a/src/content/release/archive-whats-new.md +++ b/src/content/release/archive-whats-new.md @@ -12,6 +12,73 @@ check out the [current what's new][] page. [current what's new]: /release/whats-new +--- + +## 20 May 2025: Google I/O release 3.32 + +Flutter 3.32 is live! For more information, +check out the [Flutter 3.32 technical blog post][3.32-tech]. +You might also check out the [Dart 3.8 release][] blog post. + +[3.32-tech]: {{site.medium}}/flutter/whats-new-in-flutter-3-32-40c1086bab6e +[Dart 3.8 release]: {{site.medium}}/dartlang/announcing-dart-3-8-724eaaec9f47 + +**Website update** + +First of all, a behind-the-scenes rewrite of the website has +been in the works. These changes have been published incrementally, +so you might have already noticed some of them: + +* Dark mode is now available +* You can now rate each page on the site with a thumbs up + or thumbs down +* The sidenav has changed and it's (hopefully) easier to find content +* The website has been made more accessible +* Files have been moved around (we always provide redirects) + +**Docs updated or added since the 3.29 release** + +* An updated [Flutter on iOS][] page. +* We have a new [workflow for installing Flutter][] on the various + development platforms. This continues to be a work in progress, + so stay tuned. +* A new page on how you can use the new DevTools feature, + [Flutter Property Editor][]. + The [VS Code][] and [Android Studio/IntelliJ][] instructions + are also updated on how to use this feature. +* The website is updated to explain how + you can [use hot reload on web][] behind a flag. + For this release, hot reload on web is an experimental feature. +* A new page on [adding iOS app extensions][]. +* A completely rewritten page for + [setting up Flutter flavors for iOS and macOS][]. +* A new page for [setting up Flutter flavors for Android][]. +* The Cupertino instructions were updated for the + [Place a floating app bar above a list][floating-app-bar] + cookbook recipe. +* You can now + [improve accessibility of your apps with SemanticRoles][semantic-roles]. +* Also, don't forget to check out the [breaking changes][bc-3.32] + page for this release. That's also where you'll find useful + migration info. + +[Architectural overview page]: /resources/architectural-overview +[bc-3.32]: /release/breaking-changes#released-in-flutter-3-32 + +[adding iOS app extensions]: /platform-integration/ios/app-extensions +[Android Studio/IntelliJ]: /tools/android-studio#property-editor +[floating-app-bar]: /cookbook/lists/floating-app-bar +[Flutter on iOS]: https://flutter.dev/multi-platform/ios +[Flutter Property Editor]: /tools/property-editor +[semantic-roles]: /ui/accessibility/web-accessibility#enhancing-accessibility-with-semantic-roles +[setting up Flutter flavors for Android]: /deployment/flavors +[setting up Flutter flavors for iOS and macOS]: /deployment/flavors-ios +[use hot reload on web]: /platform-integration/web/building#hot-reload-web +[VS Code]: /tools/vs-code#property-editor +[workflow for installing Flutter]: /install + +--- + ## 12 February 2025: 3.29 release Flutter 3.29 is live! For more information, diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index 8e54460afbc..88457df93f3 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -11,8 +11,7 @@ Find past what's new information on the You might also check out the Flutter SDK [release notes][]. -To stay on top of Flutter announcements including -breaking changes, +To stay on top of Flutter announcements including breaking changes, join the [flutter-announce][] Google group. For Dart, you can join the [Dart Announce][] Google group, @@ -23,6 +22,76 @@ and review the [Dart changelog][]. [flutter-announce]: {{site.groups}}/forum/#!forum/flutter-announce [release notes]: /release/release-notes +## xx November 2025: Release 3.38 + +Flutter 3.38 is live! For details, +check out the [Flutter 3.38 technical blog post][3.38-tech]. + +[3.38-tech]: xxx + +**Docs updated or added since the 3.35 release** + +* The Dart language now supports _dot shortshands_ syntax + (aka _shorthands_), which allows you to write more + concise code. For more information, visit the + [Dart dot shorthands][] page on dart.dev. In the fullness of time, + the samples on this website will be updated + to take advantage of this new feature. + +* The `flutter run` command now supports a configuration file + that allows you to specify web settings like host, port, + certification, and header. + The web dev config file also supports proxy settings, + making it possible to forward specific path requests + to another server. This makes it easier to develop a + web client that connects to dynamic endpoints on the same host. + For more information, visit + [setting up a web development configuration file][web-config-file] + +* Development continues on the Flutter Widget Previewer tool, + introduced as an experimental feature in the 3.35 release. + The previewer now better integrates with the VS Code and + IntelliJ IDEs (including Android Studio). + It's still an experimental feature. + For more info about the latest version, + check out the [Widget Previewer tool page][]. + +* The Flutter 3.38 release fully supports the platform releases + for iOS 26, Xcode 26, and macOS 26, all of which were released in September. + For the most recent info on Flutter's support for iOS, + visit [Flutter on latest iOS][]. + +* Flutter 3.38 supports the new Apple-mandated [UIScene lifecycl][]. + To support this, code migration is required. + For more information, visit the [UIScene migration guide][]. + +* With a focus on improving Flutter's accessibility, + the [accessibility docs][] have also been completely reworked. + +* Also, don't forget to check out the [breaking changes][bc-3.38] + page for this release. That's where you'll find information + about code deprecations and migrations. + +Other relevant resources: + +* [3.38 release notes and changelog][] +* [DevTools release notes][] +* [Dart 3.10 release][] blog post + +[3.38 release notes and change log]: xxx +[accessibility docs]: /ui/accessibility +[bc-3.38]: /release/breaking-changes#released-in-flutter-3-38 +[Dart 3.10 release]: xxx +[Dart dot shorthands]: {{site.dart-site}}/language/dot-shorthands +[DevTools release notes]: xxx +[Flutter on latest iOS]: /ios/ios-latest +[UIScene lifecycle]: {{site.apple-dev}}/documentation/technotes/tn3187-migrating-to-the-uikit-scene-based-life-cycle +[UIScene migration guide]: /release/breaking-changes/uiscenedelegate +[Widget Previewer tool page]: /tools/widget-previewer +[web-config-file]: /platform-integration/web/web-dev-config-file + +--- + ## 13 August 2025: Release 3.35 Flutter 3.35 is live! For more information, @@ -69,71 +138,6 @@ You might also check out the [Dart 3.9 release][] blog post. --- -## 20 May 2025: Google I/O release 3.32 - -Flutter 3.32 is live! For more information, -check out the [Flutter 3.32 technical blog post][3.32-tech]. -You might also check out the [Dart 3.8 release][] blog post. - -[3.32-tech]: {{site.medium}}/flutter/whats-new-in-flutter-3-32-40c1086bab6e -[Dart 3.8 release]: {{site.medium}}/dartlang/announcing-dart-3-8-724eaaec9f47 - -**Website update** - -First of all, a behind-the-scenes rewrite of the website has -been in the works. These changes have been published incrementally, -so you might have already noticed some of them: - -* Dark mode is now available -* You can now rate each page on the site with a thumbs up - or thumbs down -* The sidenav has changed and it's (hopefully) easier to find content -* The website has been made more accessible -* Files have been moved around (we always provide redirects) - -**Docs updated or added since the 3.29 release** - -* An updated [Flutter on iOS][] page. -* We have a new [workflow for installing Flutter][] on the various - development platforms. This continues to be a work in progress, - so stay tuned. -* A new page on how you can use the new DevTools feature, - [Flutter Property Editor][]. - The [VS Code][] and [Android Studio/IntelliJ][] instructions - are also updated on how to use this feature. -* The website is updated to explain how - you can [use hot reload on web][] behind a flag. - For this release, hot reload on web is an experimental feature. -* A new page on [adding iOS app extensions][]. -* A completely rewritten page for - [setting up Flutter flavors for iOS and macOS][]. -* A new page for [setting up Flutter flavors for Android][]. -* The Cupertino instructions were updated for the - [Place a floating app bar above a list][floating-app-bar] - cookbook recipe. -* You can now - [improve accessibility of your apps with SemanticRoles][semantic-roles]. -* Also, don't forget to check out the [breaking changes][bc-3.32] - page for this release. That's also where you'll find useful - migration info. - -[Architectural overview page]: /resources/architectural-overview -[bc-3.32]: /release/breaking-changes#released-in-flutter-3-32 - -[adding iOS app extensions]: /platform-integration/ios/app-extensions -[Android Studio/IntelliJ]: /tools/android-studio#property-editor -[floating-app-bar]: /cookbook/lists/floating-app-bar -[Flutter on iOS]: https://flutter.dev/multi-platform/ios -[Flutter Property Editor]: /tools/property-editor -[semantic-roles]: /ui/accessibility/web-accessibility#enhancing-accessibility-with-semantic-roles -[setting up Flutter flavors for Android]: /deployment/flavors -[setting up Flutter flavors for iOS and macOS]: /deployment/flavors-ios -[use hot reload on web]: /platform-integration/web/building#hot-reload-web -[VS Code]: /tools/vs-code#property-editor -[workflow for installing Flutter]: /install - ---- - For past releases, check out the [What's new archive][] page. From 599a5341bfe3d815b07d167e0d041246ca09e81f Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Thu, 6 Nov 2025 14:56:13 -0800 Subject: [PATCH 2/9] Update whats-new.md Adding info about the update to the websit --- src/content/release/whats-new.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index 88457df93f3..cfa8cff0325 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -29,6 +29,17 @@ check out the [Flutter 3.38 technical blog post][3.38-tech]. [3.38-tech]: xxx +**Website update** + +A significant update to the website has recently landed! +As with the update to the dart.dev website that was released +earlier this year, the docs.flutter.dev website has been +reimplemented to use [Jaspr][], a Dart web framework. + +Let us know what you think! + +[Jaspr]: https://pub.dev/packages/jaspr + **Docs updated or added since the 3.35 release** * The Dart language now supports _dot shortshands_ syntax From 41e1e7e87f6bb0ec5bb266abef6a619642fab66b Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Fri, 7 Nov 2025 10:28:08 -0800 Subject: [PATCH 3/9] Tweaking --- src/content/release/whats-new.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index cfa8cff0325..4484b360236 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -32,7 +32,7 @@ check out the [Flutter 3.38 technical blog post][3.38-tech]. **Website update** A significant update to the website has recently landed! -As with the update to the dart.dev website that was released +As with the update to the dart.dev website that landed earlier this year, the docs.flutter.dev website has been reimplemented to use [Jaspr][], a Dart web framework. @@ -45,7 +45,7 @@ Let us know what you think! * The Dart language now supports _dot shortshands_ syntax (aka _shorthands_), which allows you to write more concise code. For more information, visit the - [Dart dot shorthands][] page on dart.dev. In the fullness of time, + [Dart dot shorthands][] page on dart.dev. Over time, the samples on this website will be updated to take advantage of this new feature. @@ -61,8 +61,8 @@ Let us know what you think! * Development continues on the Flutter Widget Previewer tool, introduced as an experimental feature in the 3.35 release. - The previewer now better integrates with the VS Code and - IntelliJ IDEs (including Android Studio). + For this release, the previewer better integrates with the VS Code + and IntelliJ IDEs (including Android Studio). It's still an experimental feature. For more info about the latest version, check out the [Widget Previewer tool page][]. @@ -72,7 +72,7 @@ Let us know what you think! For the most recent info on Flutter's support for iOS, visit [Flutter on latest iOS][]. -* Flutter 3.38 supports the new Apple-mandated [UIScene lifecycl][]. +* Flutter 3.38 supports the new Apple-mandated [UIScene lifecycle][]. To support this, code migration is required. For more information, visit the [UIScene migration guide][]. @@ -81,12 +81,12 @@ Let us know what you think! * Also, don't forget to check out the [breaking changes][bc-3.38] page for this release. That's where you'll find information - about code deprecations and migrations. + about breaking changes, code deprecations, and migration guides. Other relevant resources: * [3.38 release notes and changelog][] -* [DevTools release notes][] +* [DevTools 2.52 release notes][] * [Dart 3.10 release][] blog post [3.38 release notes and change log]: xxx @@ -94,7 +94,7 @@ Other relevant resources: [bc-3.38]: /release/breaking-changes#released-in-flutter-3-38 [Dart 3.10 release]: xxx [Dart dot shorthands]: {{site.dart-site}}/language/dot-shorthands -[DevTools release notes]: xxx +[DevTools 2.52 release notes]: /release-notes/release-notes-2.52.0 [Flutter on latest iOS]: /ios/ios-latest [UIScene lifecycle]: {{site.apple-dev}}/documentation/technotes/tn3187-migrating-to-the-uikit-scene-based-life-cycle [UIScene migration guide]: /release/breaking-changes/uiscenedelegate From 99d4e9a2d7742816b6d1bd7a88870c7a1a284546 Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Fri, 7 Nov 2025 10:55:02 -0800 Subject: [PATCH 4/9] fix typo --- src/content/release/whats-new.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index 4484b360236..016cda0c4f2 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -89,7 +89,7 @@ Other relevant resources: * [DevTools 2.52 release notes][] * [Dart 3.10 release][] blog post -[3.38 release notes and change log]: xxx +[3.38 release notes and changelog]: xxx [accessibility docs]: /ui/accessibility [bc-3.38]: /release/breaking-changes#released-in-flutter-3-38 [Dart 3.10 release]: xxx From eba2aae47dedf9e78593f565d826e1ea6fff42d4 Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Mon, 10 Nov 2025 10:54:06 -0800 Subject: [PATCH 5/9] Fixes and tweaks --- src/content/release/whats-new.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index 016cda0c4f2..660db97c379 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -22,12 +22,12 @@ and review the [Dart changelog][]. [flutter-announce]: {{site.groups}}/forum/#!forum/flutter-announce [release notes]: /release/release-notes -## xx November 2025: Release 3.38 +## 12 November 2025: Release 3.38 Flutter 3.38 is live! For details, check out the [Flutter 3.38 technical blog post][3.38-tech]. -[3.38-tech]: xxx +[3.38-tech]: {{site.flutter-blog}}/whats-new-in-flutter-3-38-3f7b258f7228 **Website update** @@ -38,11 +38,11 @@ reimplemented to use [Jaspr][], a Dart web framework. Let us know what you think! -[Jaspr]: https://pub.dev/packages/jaspr +[Jaspr]: https://jaspr.site/ **Docs updated or added since the 3.35 release** -* The Dart language now supports _dot shortshands_ syntax +* The Dart language now supports _dot shorthands_ syntax (aka _shorthands_), which allows you to write more concise code. For more information, visit the [Dart dot shorthands][] page on dart.dev. Over time, @@ -57,7 +57,7 @@ Let us know what you think! to another server. This makes it easier to develop a web client that connects to dynamic endpoints on the same host. For more information, visit - [setting up a web development configuration file][web-config-file] + [setting up a web development configuration file][web-config-file]. * Development continues on the Flutter Widget Previewer tool, introduced as an experimental feature in the 3.35 release. @@ -84,9 +84,9 @@ Let us know what you think! about breaking changes, code deprecations, and migration guides. Other relevant resources: - +75600050645551 * [3.38 release notes and changelog][] -* [DevTools 2.52 release notes][] +* [DevTools 2.25.1 release notes][] * [Dart 3.10 release][] blog post [3.38 release notes and changelog]: xxx @@ -95,7 +95,7 @@ Other relevant resources: [Dart 3.10 release]: xxx [Dart dot shorthands]: {{site.dart-site}}/language/dot-shorthands [DevTools 2.52 release notes]: /release-notes/release-notes-2.52.0 -[Flutter on latest iOS]: /ios/ios-latest +[Flutter on latest iOS]: /platform-integration/ios/ios-latest [UIScene lifecycle]: {{site.apple-dev}}/documentation/technotes/tn3187-migrating-to-the-uikit-scene-based-life-cycle [UIScene migration guide]: /release/breaking-changes/uiscenedelegate [Widget Previewer tool page]: /tools/widget-previewer From b5930adf5ea9d689ec0d33b8ec4e2fef07022f6a Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Mon, 10 Nov 2025 13:30:24 -0800 Subject: [PATCH 6/9] tweaking --- src/content/release/whats-new.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index 660db97c379..a8c45047396 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -92,7 +92,7 @@ Other relevant resources: [3.38 release notes and changelog]: xxx [accessibility docs]: /ui/accessibility [bc-3.38]: /release/breaking-changes#released-in-flutter-3-38 -[Dart 3.10 release]: xxx +[Dart 3.10 release]: https://blog.dart.dev/announcing-dart-3-10-ea8b952b6088 [Dart dot shorthands]: {{site.dart-site}}/language/dot-shorthands [DevTools 2.52 release notes]: /release-notes/release-notes-2.52.0 [Flutter on latest iOS]: /platform-integration/ios/ios-latest From 14906e1cff6aa0031a4a1ed04c43b7915d0129aa Mon Sep 17 00:00:00 2001 From: "Shams Zakhour (ignore Sfshaza)" Date: Wed, 12 Nov 2025 09:35:29 -0800 Subject: [PATCH 7/9] Preparing to launch --- src/content/release/release-notes/index.md | 2 ++ src/content/release/whats-new.md | 2 +- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/src/content/release/release-notes/index.md b/src/content/release/release-notes/index.md index 4c18f8c8736..0dd3a64524d 100644 --- a/src/content/release/release-notes/index.md +++ b/src/content/release/release-notes/index.md @@ -13,6 +13,7 @@ check out the Flutter [CHANGELOG][]. ::: * 3.38.0 + * [3.38.0 announcement][] * [3.38.0 release notes & change log][] * [3.38.0 breaking changes & migrations][] * 3.35.0 @@ -104,6 +105,7 @@ check out the Flutter [CHANGELOG][]. * Earlier * [Archived release notes][] +[3.38.0 announcement]: {{site.flutter-blog}}/whats-new-in-flutter-3-38-3f7b258f7228 [3.38.0 release notes & change log]: /release/release-notes/release-notes-3.38.0 [3.38.0 breaking changes & migrations]: /release/breaking-changes#released-in-flutter-3-38 [3.35.0 announcement]: {{site.flutter-blog}}/whats-new-in-flutter-3-35-c58ef72e3766 diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index a8c45047396..3059396b148 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -89,7 +89,7 @@ Other relevant resources: * [DevTools 2.25.1 release notes][] * [Dart 3.10 release][] blog post -[3.38 release notes and changelog]: xxx +[3.38 release notes and changelog]: /release/breaking-changes#released-in-flutter-3-38 [accessibility docs]: /ui/accessibility [bc-3.38]: /release/breaking-changes#released-in-flutter-3-38 [Dart 3.10 release]: https://blog.dart.dev/announcing-dart-3-10-ea8b952b6088 From 89d8ab73ccdf5ef724ab8e93fd8f1b3c92ab64c2 Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Wed, 12 Nov 2025 16:24:10 -0600 Subject: [PATCH 8/9] Remove what looks to be merge remnant --- src/content/release/whats-new.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index 3059396b148..f67dc25027f 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -84,7 +84,7 @@ Let us know what you think! about breaking changes, code deprecations, and migration guides. Other relevant resources: -75600050645551 + * [3.38 release notes and changelog][] * [DevTools 2.25.1 release notes][] * [Dart 3.10 release][] blog post From 03d2ea464802f3e1c86c5127d795751d1755a7af Mon Sep 17 00:00:00 2001 From: Parker Lougheed Date: Wed, 12 Nov 2025 16:26:48 -0600 Subject: [PATCH 9/9] Fix release note links --- src/content/release/whats-new.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/content/release/whats-new.md b/src/content/release/whats-new.md index f67dc25027f..61a6e73818c 100644 --- a/src/content/release/whats-new.md +++ b/src/content/release/whats-new.md @@ -86,15 +86,15 @@ Let us know what you think! Other relevant resources: * [3.38 release notes and changelog][] -* [DevTools 2.25.1 release notes][] +* [DevTools 2.51.1 release notes][] * [Dart 3.10 release][] blog post -[3.38 release notes and changelog]: /release/breaking-changes#released-in-flutter-3-38 +[3.38 release notes and changelog]: /release/release-notes/release-notes-3.38.0 [accessibility docs]: /ui/accessibility [bc-3.38]: /release/breaking-changes#released-in-flutter-3-38 [Dart 3.10 release]: https://blog.dart.dev/announcing-dart-3-10-ea8b952b6088 [Dart dot shorthands]: {{site.dart-site}}/language/dot-shorthands -[DevTools 2.52 release notes]: /release-notes/release-notes-2.52.0 +[DevTools 2.51.1 release notes]: /tools/devtools/release-notes/release-notes-2.51.1 [Flutter on latest iOS]: /platform-integration/ios/ios-latest [UIScene lifecycle]: {{site.apple-dev}}/documentation/technotes/tn3187-migrating-to-the-uikit-scene-based-life-cycle [UIScene migration guide]: /release/breaking-changes/uiscenedelegate