跳转至正文

Flutter 文档网站更新

Flutter 和 Dart 文档的相关更新说明页面。

本页包含了近期的公告以及网站上的更新内容。想要了解每个 Flutter 发布的版本更新内容,你可以在 更新内容归档 页面上查找历史更新信息。还可以查看 Flutter SDK 发布说明 页面。

要及时同步最新 Flutter 公告,包括重大变更 (breaking changes) 等,请加入 flutter-announce 邮件组。

你可以加入 Dart Announce 邮件组或查看 Dart 更新日志 了解 Dart 的更新内容。

12 August 2026: Release 3.47

#

Flutter 3.47 is live! For details, check out the Flutter 3.47 blog post.

Docs updated or added since the 3.44 release

  • The Flutter Widget Previews tool has graduated to stable, introducing local build caching for faster startup times and real-time preview search and filtering.

  • The AI documentation has been reorganized to improve navigation and help you get started quickly with agent-plugins (formerly known as skills) using the Antigravity CLI, IDE integrations, and other coding assistants. An experimental AI Evaluations topic page has also been added.

  • A new guide on Dependency management explains how to configure, manage, and upgrade package dependencies.

  • The Swift Package Manager guides for iOS and macOS have expanded, and the Add-to-app documentation now includes SwiftPM integration instructions.

  • The web documentation now includes troubleshooting guidance for Wasm compilation errors and instructions for using the --source-maps flag during web builds.

  • The assets guide now explains how to bundle platform-specific assets in pubspec.yaml.

  • A new migration guide helps you migrate plugins and apps to built-in Kotlin Gradle plugins.

As always, check out the breaking changes page for this release, which includes links to migration guides and other vital information.


18 May 2026: Google I/O Release 3.44

#

Flutter 3.44 is live! This release is jam packed. For details, check out the Flutter 3.44 blog post and watch the video:

More on the site updates to come.

11 February 2026: "Year of the Fire Horse" Release 3.41

#

Flutter 3.41 is live! For details, check out the Flutter 3.41 blog post.

Docs updated or added since the 3.38 release

In addition to many smaller updates, here are some of the more significant changes:

  • We have introduced a new getting started experience for both Flutter and Dart, as announced in a recent blog post. You can find the Flutter learning pathway under the Learn tab at the top of docs.flutter.dev. To return to the rest of the site, select the Guides tab. As always, the Reference tab takes you to the Flutter API docs.

  • Flutter and Dart now have an official glossary. As part of the recent migration of the websites to Jaspr, a glossary has been added to the Flutter website. Expect to see it grow in the fullness of time.

  • As always, check out the breaking changes page for this release, which includes links to migration guides and other vital information. A special thank you to navaronbracke, who wrote a migration guide for the deprecation of the onReorder callback.


12 November 2025: Release 3.38

#

Flutter 3.38 is live! For details, check out the Flutter 3.38 technical blog post.

Website update

A significant update to the website has recently landed! 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.

Let us know what you think!

Docs updated or added since the 3.35 release

  • 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, 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.

  • Development continues on the Flutter Widget Previewer tool, introduced as an experimental feature in the 3.35 release. 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.

  • 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 lifecycle. 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 page for this release. That's where you'll find information about breaking changes, code deprecations, and migration guides.

Other relevant resources:


For past releases, check out the What's new archive page.