文档网站更新内容归档

Contents

Jan 25, 2023, Flutter Forward edition: 3.7 release
Aug 31, 2022, Flutter Vikings Edition: 3.3 release
May 11, 2022, Google I/O Edition: Flutter 3 release
Feb 3, 2022, Windows Support: 2.10 release
December 8, 2021: 2.8 release
2021 年 9 月 8 日：2.5 版本发布
May 18, 2021, Google I/O Edition: 2.2 release
March 3, 2021, Flutter Engage Edition: 2.0 release
Oct 1, 2020: 1.22 release
2020 年 5 月：1.20 发布
May 6, 2020, Work-From-Home Edition: 1.17 release
2019 年 12 月 11 日, Flutter Interact 版本
Sept 10, 2019: 1.9 release
July 9, 2019: 1.7 release
May 7, 2019, Google I/O Edition: 1.5 release
February 26, 2019: 1.2 release
November 5, 2018: new website

该归档包含了历史公告，以及网站上的更新内容。想要了解每个 Flutter 发布的版本更新内容，请查看发布说明页面。

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

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

Jan 25, 2023, Flutter Forward edition: 3.7 release

Flutter 3.7 is live! This release contains many updates and improvements. This page lists the documentation changes, but you can also check out the 3.7 blog post and the 3.7 release notes.

You might also check out What’s next for Flutter and Introducing Dart 3 alpha.

Docs updated or added since the 3.3 release

You can now pass configuration information to the engine in the initializeEngine method. For more information, check out Customizing web app initialization.
Creating Flavors for Flutter Learn how to create a flavor in Flutter (also known as a build configuration in iOS).
Internationalization support has been revamped and the Internationalizing Flutter apps page is updated.
The DevTools memory debugging tool has been completely overhauled and the corresponding page, Using the memory view, is rewritten.
This release includes numerous improvements to Flutter’s support for custom fragment shaders. For more information, see the new Writing and using fragment shaders page.
Some security tools falsely report security vulnerabilities in Flutter apps. The new Security false positives page lists the known false positives and why you can ignore them.
You can now invoke a platform channel from any isolate, including background isolates. For more information, check out Writing custom platform-specific code and the Introducing isolate background channels article on Medium.
We’ve updated our Swift documentation. New and updated pages include:
- Flutter for SwiftUI developers - updated
- Add a Flutter screen to an iOS app - updated for SwiftUI
- Flutter concurrency for Swift developers - new
- Learning Dart as a Swift developer on dart.dev - new
As of Xcode 14, Apple no longer supports bitcode. Two of our pages, Adding an iOS clip target and the Flutter FAQ, are updated to reflect this fact.
For developers who enjoy living on the bleeding edge, you might want to try Flutter’s future rendering engine, Impeller. Because Impeller isn’t yet ready for a stable release, you can find more information on our Flutter GitHub wiki.

Codelabs and workshops

We have new codelabs since the last stable release:

Your first Flutter app
Learn about Flutter as you build an application that generates cool-sounding names, such as “newstay”, “lightstream”, “mainbrake”, or “graypine”. The user can ask for the next name, favorite the current one, and review the list of favorited names on a separate page. The final app is responsive to different screen sizes. (Note that this codelab replaces the previous “Write your first Flutter codelab for mobile, part 1 and part 2.”)
Using FFI in a Flutter plugin
Dart’s FFI (foreign function interface) allows Flutter apps to use of existing native libraries that expose a C API. Dart supports FFI on Android, iOS, Windows, macOS, and Linux.
Building a game with Flutter and Flame
Learn how to build a platformer game with Flutter and Flame! In the Doodle Dash game, inspired by Doodle Jump, you play as either Dash (the Flutter mascot), or her best friend Sparky (the Firebase mascot), and try to reach as high as possible by jumping on platforms.
Add a user authentication flow to a Flutter app using FirebaseUI
Learn how to add Firebase Authentication to your Flutter app using the FlutterFire UI package. You’ll add both email/password and Google Sign In authorization to a Flutter app. You’ll also learn how to set up a Firebase project, and use the FlutterFire CLI to initialize Firebase in your Flutter app.
Local development for your Flutter apps using the Firebase Emulator Suite
Learn how to use the Firebase Emulator Suite with Flutter during local development, including how to use email-password authentication with the Emulator Suite, and how to read and write data to the Firestore emulator. Also, you’ll import and export data from the emulators, to work with the same faked data each time you return to development.

In addition, we’ve updated all of our existing codelabs to support multiplatform. The codelabs & workshops page is updated to reflect the latest available codelabs.

Articles

We’ve published the following articles on the Flutter Medium publication since the last stable release:

Aug 31, 2022, Flutter Vikings Edition: 3.3 release

Flutter 3.3 is live! For more information, see

What’s new in Flutter 3.3, and Dart 2.18: Objective-C & Swift interop (free articles on Medium), and the Flutter 3.3 release notes.

Docs updated or added since the 3.0 release

The navigation and routing overview page has been rewritten with more guidance on using Navigator and Router together, named routes, and using a routing package.
The URL strategies page has also been updated to reflect a more streamlined API.
For apps not published to the Microsoft Store, you can now set the app’s executable’s file and product versions in the pubspec file. For more information, see Build and release a Windows desktop app.
If you are developing software for iOS 16 and higher, you must enable Developer mode. The macOS install page is updated with this information.
As described in the 3.3 release notes, you should catch all errors and exceptions in your app by setting the PlatformDispatcher.onError callback, instead of using a custom Zone. The Handling errors in Flutter page has been updated with this advice.

May 11, 2022, Google I/O Edition: Flutter 3 release

Flutter 3 is live!!! For more information, see Introducing Flutter 3, What’s new in Flutter 3, and Dart 2.17: Productivity and integration (free articles on Medium), and the Flutter 3 release notes.

Docs updated or added since the 2.10 release

We have launched the Casual Games Toolkit to help you build games with Flutter. Learn more on the Games page and the Games doc page.
Are you struggling to level up as a Flutter developer? We have created the Happy paths project to help. Learn more on the Happy paths page.
Are you a web developer who would like more control over your app’s launch process? Check out the new page, Customizing web app initialization, which has been added to the newly updated and collected web docs under /development/platform-integration/web.
Flutter 3 supports Apple Silicon processors. We’ve updated the macOS install page to offer an Apple Silicon download button.
In Flutter 3, the macOS and Linux platforms have reached stable, in addition to Windows. You can now develop your app to run on any or all of these platforms. As a result, the Desktop (and related) pages are updated.
The Performance best practices page has largely been rewritten and moved to be more visible. The changes include additional advice on avoiding jank, including how to minimize layout passes caused by intrinsics, and techniques to minimize calls to saveLayer().
Firebase’s Flutter docs have been overhauled. Check out the newly updated Flutter Firebase get started guide.
The dart.dev site has its own what’s new page, but one new page of note is the guide, Learning Dart as a JavaScript developer. Stay tuned for similar articles on Swift and C#.

Codelabs and workshops

We have a new codelab since the last stable release:

Take your Flutter app from boring to beautiful Learn how to use features in Material 3 to make your more beautiful and more responsive.

Also, check out the workshops written by our GDEs and available on the Flutter community blog.

Videos

Google I/O 2022 is over, but you can still check out the Flutter-specific updates and talks from Google I/O on the videos page.

Feb 3, 2022, Windows Support: 2.10 release

Desktop support for Microsoft Windows (a central feature of the 2.10 release) is live! For more information, see Announcing Flutter for Windows and What’s new in Flutter 2.10, free articles on Medium.

December 8, 2021: 2.8 release

Flutter 2.8 is live! For details, see Announcing Flutter 2.8 and What’s new in Flutter 2.8.

2021 年 9 月 8 日：2.5 版本发布

Flutter 2.5 is live! For details, see What’s new in Flutter 2.5.

We’ve made significant changes to flutter/website repo to make it easier to use and maintain. If you contribute to this repo, see the README file for more information.

Docs updated or added since the 2.2 release

A new page on Using Actions and Shortcuts.

Articles

We’ve published the following articles on the Flutter Medium publication since the last stable release:

May 18, 2021, Google I/O Edition: 2.2 release

Flutter 2.2 is live! For details, see Announcing Flutter 2.2 and What’s New in Flutter 2.2.

We continue migrating code on the website to use null safety, but that work is not yet completed.

Docs updated or added since the 2.0 release

A new page on Building adaptive apps.
A new page describing how to use Google APIs with Flutter.
A new landing page for Embedded Support for Flutter.
A new page on setting up and using Deferred components on Android.
Significant updates to the DevTools Memory view page.
The desktop page is updated to reflect the progress on desktop support, particularly the new support for Windows UWP.

Codelabs

New codelabs since the last stable release:

Workshops

For Google I/O 2021, we have added a new Flutter/Dart learning tool that is based on DartPad: Workshops! These workshops are designed to be instructor led. The instructor-led videos are available on the Flutter and Firebase YouTube channels:

To see the event list of “all things Flutter” at I/O, see the Google 2021 I/O Flutter page.

You can author your own DartPad workshops! If you are interested, check out the following resources:

Articles

We’ve published the following articles on the Flutter Medium publication since the last stable release:

March 3, 2021, Flutter Engage Edition: 2.0 release

Flutter 2 is live!!! For more information, see Announcing Flutter 2, What’s new in Flutter 2, Flutter web support hits the stable milestone, Announcing Dart 2.12, and the Flutter 2 release notes.

Docs updated or added since the 1.22 release

A new Who is Dash? page!
Information about monetizing your apps has been collected in the new Flutter Ads landing page.
Added a new page explaining the Flutter Fix feature and how to use it.
New and updated web pages, including:
The Desktop support for Flutter page is updated, as well as other pages on the site that discuss desktop support.
The DevTools docs have been updated. The most significant updates are to the following page:
- Flutter inspector
Added a page on how to implement deep linking for mobile and web.
Updated the Creating responsive and adaptive apps page.
Many pages (including all codelabs on flutter.dev) and examples are updated to be null safe.
Added two new add to app pages:
- Using multiple Flutter instances
- Adding a Flutter view to an Android app
Added a page on how to write integration tests using the integration_test package.
Significant updates to the internationalization page.
New and updated performance pages, including:

Codelabs

Many of our codelabs have been updated to null safety. We’ve also added a new codelab since the last stable release:

Adding AdMob banner and native inline ads to a Flutter app

For a complete list, see Flutter codelabs.

Articles

We’ve published the following articles on the Flutter Medium publication since the last stable release:

Oct 1, 2020: 1.22 release

Flutter 1.22 is live! For details, see Announcing Flutter 1.22.

Docs updated or added to flutter.dev since the 1.20 release

Updated the Developing for iOS 14 page with details about targeting iOS 14 with Flutter, including some Add-to-App, deep linking, and notification considerations.
Added a page on how to add an iOS App Clip, a new iOS 14 feature that supports running lightweight, no-install apps under 10 MB.
Added a page that describes how to migrate your app to use the new icon glyphs available in CupertinoIcons.
Added a page that describes the new implementation for Platform Views and how to use them to host native Android and iOS views in your Flutter app. This feature has enabled the google_maps_flutter and webview_flutter plugins to be updated to production-ready release 1.0.
Added a page that describes how to use the new App Size tool in Dart DevTools.

Codelabs

We’ve added a new codelab since the last stable release:

Building Beautiful Transitions with Material Motion for Flutter
Learn how to use the Material animations package to add prebuilt transitions to a Material app called Reply.

For a complete list, see Flutter codelabs.

Articles

We’ve published the following articles on the Flutter Medium publication since the last stable release:

2020 年 5 月：1.20 发布

Flutter 1.20 版本正式发布！更多信息请参见 Flutter 1.20 发布介绍。

flutter.dev 文档更新

减少移动设备上的着色器（shader）掉帧问题文档已添加到性能章节中。
在 iOS 14 beta 上进行开发介绍了一些你在 iOS 14 beta 开发中可能会遇到的一些问题。
使用 snaped 在 Linux 安装 Flutter 应用提供了最新介绍。
更新了桌面支持介绍页面， Linux 桌面应用（以及 macOS）已经进入 alpha 阶段。
多本全新 Flutter 书籍正式出版。更新了 Flutter 书籍页面。
更新了代码实验室主页。

dart.dev 增加了深入探索 null safety（空安全）文章：

深入理解空安全

Codelabs

在 2020 年 6 月 25 日我们举办了 Flutter Day。为了准备这次活动，我们编写了全新的代码实验室并更新了已有的 codelab。最新的 codelab 包括以下内容：

完整列表请查看Flutter 代码实验室。

文章

自从上次稳定版发布以来，我们在 Flutter Medium 上发布了一系列文章：

May 6, 2020, Work-From-Home Edition: 1.17 release

Flutter 1.17 is live!

For more information, see Announcing Flutter 1.17.

Docs added and updated since the last announcement include:

Added a new page on Understanding constraints, contributed by Marcelo Glasberg, a Flutter community member.
The animations landing page has been re-written. This page now includes the animation decision tree that helps you figure out which animation approach is right for your needs. It also includes information on the new package for pre-canned Material widget animations.
The hot reload page has been re-written. We hope you find it to be clearer!
The Desktop page has been updated and now includes information on setting up entitlements and using the App Sandbox on macOS.
The plugin docs are updated to cover the new Android Plugin APIs and also to describe Federated Plugins. Affected pages include:
Added an Obfuscating Dart code page. (Moved from the wiki and updated as of 1.16.2.)
Added a page on using Xcode 11.4 and how to manually update your project. The tooling, which automatically updates your configuration when possible, may direct you to this page if it detects that it’s needed.
Added a page on Managing plugins and dependencies in add-to-app when developing for Android.

Other newness:

We’ve published a number of articles on the Flutter Medium publication since the last stable release:

2019 年 12 月 11 日, Flutter Interact 版本

Flutter 1.12 正式发布!

更多详细信息请参阅 Flutter：第一个为环境计算设计的 UI 平台，宣布 Flutter 1.12 正式发布：太棒的一年! 以及 Flutter 1.12.13 发行注记。

自上次发布以来添加和更新的文档包括：

为配合最新版「添加到现有应用」的实现，我们添加了有关如何将 Flutter 添加到现有应用中的文章，同时适用于 iOS 和 Android。
如果您拥有插件代码，我们建议您更新到适用于 Android 插件的新的 API。有关更多信息，请参阅将您的插件迁移到新的 Android API。
Web 支持已进入 Beta 频道，想要查看更多的信息，请参阅 Flutter 的 Web 支持和 Flutter 的 Web 支持变为 beta。此外，使用 Flutter 构建 Web 应用程序页面也已更新。
全新的编写你的第一个 Flutter Web 应用 codelab 已添加到使用入门文档中，其中包括在 DevTools 中设置断点的说明。
我们推出了一个计划以介绍特定 Dart 或者 Flutter package 或插件。请在 Flutter Favorite 项目计划中查看更多信息。
新的隐式动画 codelab 发布啦，它还带有 DartPad。（直接运行它，你无需下载任何软件！）
现在可以在主频道和开发者频道上发布的 1.13 版获得对 MacOS（桌面）的 Alpha 支持。有关更多信息，请参见 Flutter 的桌面支持。
iOS 页面的 app size 部分已更新，包含 bitcode。
Flutter Layout Explorer 的 Alpha 版本，一项新功能（以及 Flutter inspector 的一部分），你可以探索您的布局的可视化表示形式。有关更多信息，请参看探索 Flutter 中的布局文档。

其他新颖之处：

全新版本的 Flutter Gallery。侧面导航 示例和教程 下有个可运行示例的链接。

祝你在 Flutter 应用的开发中有一个愉快的经历和体验！

Sept 10, 2019: 1.9 release

Flutter 1.9 is live!

For more information, see Flutter news from GDD China: uniting Flutter on web and mobile, and introducing Flutter 1.9 and the 1.9.1 release notes.

For the 1.9 release, Flutter’s web support has been merged (“unforked”) into the main repo. Web support hasn’t reached beta, and is not ready to be used in production. Web and desktop support (which is also coming), will impact the website, which was originally written exclusively for developing Flutter mobile apps. Some website updates are available now (and listed below), but more will be coming.

New and updated docs on the site include:

We’ve revamped the Showcase page.
The Flutter layout codelab has been rewritten and uses the updated DartPad, the browser-based tool for running Dart code. DartPad now supports Flutter! Try it out and let us know what you think.
A new page on using the dart:ffi library to bind your app to native code (a feature currently under development).
The Performance view tool, which allows you to record and profile a session from your Dart/Flutter application, has been enabled in DevTools. For more information, see the Performance view page.
A new page on building a web application.
A new page on creating responsive apps in Flutter.
A new page on preparing a web app for release.
A new web FAQ.
The Flutter for web page is updated.

Other relevant docs:

Error messages have been improved in SDK 1.9. For more information, read Improving Flutter’s Error Messages on the Flutter Medium publication.
If you already have a web app that depends on the flutter_web package, the following instructions tell you how to migrate to the flutter package: Upgrading from package:flutter_web to the Flutter SDK.
A new ToggleButtons widget, described in the API docs. ToggleButtons demo
A new ColorFiltered widget, also described in the API docs. ColorFiltered demo
New behavior for the SelectableText widget.

Happy Fluttering!

July 9, 2019: 1.7 release

Flutter 1.7 正式发布！

请参见这个文章了解更多 1.7 的更新内容，在 Flutter wiki 页面查看 1.7.8 的具体更新。

文档站的更新内容包括：

打包和发布到 Android 平台有更新，包括使用 app bundle 和为 32 位 / 64 位单独打包。
新增开发者工具文档系列内容，这是个基于浏览器的开发者工具套件，可以帮助你对 Flutter 和 Dart 应用做调试、性能监控、内存检测和检查器等，同时可以直接从 Android Studio 或 IntelliJ 以及 VSCode 运行，如果你还没有试试看，推荐你看一下。
简单的应用状态管理页面有所更新，新的文档是基于 Provider 3.0 正式版的。
实用教程里添加了一篇新的文章：为页面切换加入动画效果。
调试 Flutter 应用、 Flutter 的构建模式选择、 Flutter 应用性能优化最佳实践和 Flutter 性能分析页面中加入了开发者工具的使用说明。与此同时，还加入了这个文档页面：添加代码的方式来调试。

Flutter 1.7 版本的更新同时加入了 RangeSlider 这个 widget，可以让用户选择在最大值和最小值之间选择一个数字，本周稍晚些时候，在 Flutter 官方博客里可以看到关于这篇文章的介绍和以及如何自定义它，请关注这里。

May 7, 2019, Google I/O Edition: 1.5 release

2019 年 5 月 7 日，Google I/O 版本：1.5 版本发布

Flutter 1.5 发布啦。

更多关于此次发布的信息，可以在这里查看 1.5.4 release notes 或者下载最新版本。

我们正在更新 DartPad 以支持 Flutter，可以通过这个新的 codelab Flutter 布局基础教程来试试看吧。

February 26, 2019: 1.2 release

Flutter released version 1.2 at Mobile World Congress (MWC) in Barcelona. For more information, see the 1.2.1 release notes or download the release.

In addition, here are some recent new and updated docs:

We’ve updated our state management advice. New pages include an introduction, thinking declaratively, ephemeral vs app state, simple app state management, and different state management options. Documenting state management is a tricky thing, as there is no one-size-fits-all approach. We’d love your feedback on these new docs!
A new page on Performance best practices.
Also at MWC, we announced a preview version of the new Dart DevTools for profiling and debugging Dart and Flutter apps. You can find the docs on the DevTools wiki (Note: since moved to this site.) In particular, check out the DevTool’s widget inspector for debugging your UI, or the timeline view for profiling your Flutter application. Try them out and let us know what you think!
An update to the Performance profiling page that incorporates the new Dart DevTools UI.
Updates to the Android Studio/IntelliJ and VS Code pages incorporating info from the new Dart DevTools UI.

If you have questions or comments about any of these docs, file an issue.

November 5, 2018: new website

Welcome to the revamped Flutter website!

We’ve spent the last few months redesigning the website and how its information is organized. We hope you can more easily find the docs you are looking for. Some of the changes to the website include:

Revised front page
Revised showcase page
Revised community page
Revised navigation in the left side bar
Table of contents on the right side of most pages

Some of the new content includes:

Deep dive on Flutter internals, Inside Flutter
Technical videos
State management
Background Dart processes
Flutter’s build modes

If you have questions or comments about the revamped site, file an issue.