跳到主内容

此页面包含 Flutter 网站和博客上已存档的新内容公告。有关最新版本的信息，请查阅当前的新内容页面。

2024 年 12 月 11 日：3.27 版本发布

#

Flutter 3.27 已上线！欲了解更多信息，请查看Flutter 3.27 综合博客文章和Flutter 3.27 技术博客文章。您还可以查看Dart 3.6 发布博客文章。

自 3.24 版本发布以来更新或新增的文档

本次网站发布包含多项重要更新！

2024 年 8 月 7 日：I/O Connect 北京 3.24 版本发布

#

Flutter 3.24 已上线！欲了解更多信息，请查看Flutter 3.24 综合博客文章和Flutter 3.24 技术博客文章。您还可以查看Dart 3.5 发布博客文章。

自 3.22 版本发布以来更新或新增的文档

本次网站发布包含多项重要更新！

其他

  • 如果您对新的实验性 Flutter GPU API 感兴趣，请查看Flutter GPU 博客文章。
  • Flutter wiki 已被拆分并移动到相关的 GitHub 仓库中，从而更容易保持信息最新。

2024 年 5 月 14 日：Google I/O 3.22 版本发布

#

Flutter 3.22 已上线！欲了解更多信息，请查看Flutter 3.22 综合博客文章和Flutter 3.22 技术博客文章。

您还可以查看Dart 3.4 发布博客文章。特别是，Dart 现在提供了一个“内置”语言宏 JsonCodable，用于序列化和反序列化 JSON 数据。未来（未指定）的 Dart 版本将允许您创建自己的宏。要了解更多信息，请查看dart.dev/go/macros。

自 3.19 版本发布以来更新或新增的文档

  • 新增了关于自适应和响应式设计的 7 页内容。（这取代了我们之前对此主题的一些零散文档。）
  • 对于已经完成第一个 Flutter Codelab 的新 Flutter 开发者，我们提供了一些“下一步”建议，指导他们如何超越最初的步骤。请查看Flutter 基础文档。
  • 我们的Flutter 安装文档已 revamped。
  • 我们有三个新的 Codelab 和一个适用于 Games Toolkit 的新指南。要查看新增内容的列表，请查看更新的休闲游戏工具包页面。
  • Flutter 对 WebAssembly (Wasm) 的支持已达到稳定版本。要了解更多信息，请查看更新的对 WebAssembly (Wasm) 的支持页面。
  • DevTools 新增了一个屏幕，用于评估 Android 上的深层链接。要了解更多信息，请查看新页面验证深层链接。
  • 我们新增了一个页面，描述了 Flutter SDK 3.22 及更高版本的 Web 启动引导。请查看Flutter Web 应用初始化。
  • 您现在可以在运行时提供代码，将您的资产转换为另一种格式。要了解更多信息，请查看构建时转换资产。

网站基础设施

  • 如果您是网站的贡献者，您可能已经注意到最近的一些变化。具体来说，网站基础设施已更新，新工作流程更简单。有关更多详细信息，请查看网站 README。
  • 您可能还注意到，侧边导航中的应用解决方案子菜单现在新增了AI部分，并增强了变现部分，这些只是其中一些变化。

2024 年 2 月 15 日：临近情人节的 3.19 版本发布

#

Flutter 3.19 已上线！欲了解更多信息，请查看Flutter 3.19 综合博客文章和Flutter 3.19 技术博客文章。

您还可以查看Dart 3.3 发布博客文章。

自 3.16 版本发布以来更新或新增的文档

其他更新

2023 年 11 月 15 日：3.16 版本发布

#

Flutter 3.16 已上线！欲了解更多信息，请查看Flutter 3.16 博客文章和技术性Flutter 3.16 新内容博客文章。

您还可以查看Dart 3.2 发布。

自 3.13 版本发布以来更新或新增的文档

  • 自本版本发布起，Material Flutter 应用程序的默认主题为 Material 3。除非您在应用程序主题中明确指定 Material 2（使用 useMaterial3: false），否则您的应用程序在更新后会有所不同。
  • 虽然 Flutter 休闲游戏工具包严格来说并非 3.16 版本的一部分，但我们在此版本发布的同时，对工具包进行了重大更新。此更新包括三个全新的游戏代码模板、三个新的游戏烹饪食谱以及我们游戏工具包文档的总体重组。有关更多信息，请查看休闲游戏工具包并务必查看侧边导航！
  • Impeller 运行时现在可通过 --enable-impeller 标志在 Vulkan 设备上的 Android 上使用。有关更多信息，请查看Impeller 渲染引擎页面。
  • 现在，在 iOS 上运行时，您可以将 Apple iOS 应用程序扩展添加到您的 Flutter 应用程序。要了解更多信息，请查看添加 iOS 应用程序扩展。

文章

自 Flutter 3.13 以来，以下文章已发布在Flutter Medium出版物上

2023 年 8 月 16 日：3.13 版本发布

#

Flutter 3.13 已上线！欲了解更多信息，请查看Flutter 3.13 博客文章。

您还可以查看Dart 3.1 和对 Dart 3 中函数式编程风格的回顾。

除了自上次发布以来的新文档外，我们还逐步发布了 docs.flutter.dev 网站的改版版本。具体来说，我们重新组织（扁平化）了信息架构（IA），并将一些最受欢迎的菜谱整合到侧边导航中。让我们知道您的想法！

自 3.10 版本发布以来更新或新增的文档

Codelab 和工作坊

自 Flutter 3.10 发布以来，已发布以下 Codelab

文章

自 Flutter 3.10 以来，以下文章已发布在Flutter Medium出版物上

即将到来

即将稳定发布的内容

Material 3

您可能已经听说Material 3即将到来。它已经在 Flutter 中可用了一段时间，通过在您的代码中设置useMaterial3: true来实现。到第四季度的下一个稳定版本，Material 3 将默认启用。现在是开始迁移代码的好时机。本网站上几乎所有示例代码都已更新为使用 Material 3。

有关更多信息，请查看以下资源

Android 版 Impeller

Android 版 Impeller 持续取得进展。更多信息，请查阅Flutter 3.13 博客文章。

新的滚动 API

我们一直在更新滚动 API。这项重构最终将实现对树和表格的 2D 滚动支持，甚至是对角线滚动！Flutter 3.13 还提供了用于高级滚动的新 Sliver 类。有关更多信息，请查看Flutter 3.13 博客文章。

游戏工具包更新

我们正在更新 Flutter 游戏工具包，包括示例代码、额外文档和新视频。游戏工具包独立于 Flutter SDK 开发，因此请关注更新，一旦准备就绪就会发布。有关更多信息，请查看Flutter 3.13 博客文章。

2023 年 5 月 10 日：Google I/O 2023：3.10 版本发布

#

Flutter 3.10 已上线！此版本包含许多更新和改进。本页面列出了文档更改，但您也可以查看3.10 博客文章和3.10 发布说明。

您还可以查看Dart 3 简介。

自 3.7 版本发布以来更新或新增的文档

Codelab

自 Flutter 3.7 发布以来，已发布以下 Codelab

  • Dart 3 中的 Records 和 Patterns
    探索 Dart 3 的新记录和模式功能。了解如何在 Flutter 应用程序中使用它们来帮助您编写更具可读性和可维护性的 Dart 代码。
  • 在 Flutter 中构建下一代 UI
    了解如何构建一个利用 flutter_animate、片段着色器和粒子场功能的 Flutter 应用程序。您将制作一个唤起我们都喜欢观看的科幻电影和电视节目的用户界面。
  • 使用 PaLM API 和 Flutter 创作关于 Google 产品的俳句
    新 学习如何构建一个使用 PaLM API 根据 Google 产品名称生成俳句的应用程序。PaLM API 让您能够访问 Google 最先进的大型语言模型。

文章

自 Flutter 3.7 发布以来，Flutter 团队在Flutter Medium出版物上发布了以下文章

2023 年 1 月 25 日：Flutter Forward：3.7 版本发布

#

Flutter 3.7 已上线！此版本包含许多更新和改进。本页面列出了文档更改，但您也可以查看3.7 博客文章和3.7 发布说明。

您还可以查看Flutter 的下一步和Dart 3 alpha 简介。

自 3.3 版本发布以来更新或新增的文档

Codelab 和工作坊

自上次稳定版本发布以来，我们有了新的 Codelab

  • 您的第一个 Flutter 应用程序
    在您构建一个生成诸如“newstay”、“lightstream”、“mainbrake”或“graypine”等好听名称的应用程序时，了解 Flutter。用户可以请求下一个名称，收藏当前名称，并在单独的页面上查看收藏名称的列表。最终应用程序可响应不同的屏幕尺寸。（请注意，此 Codelab 取代了之前的“为移动设备编写您的第一个 Flutter Codelab，第一部分和第二部分”。）
  • 在 Flutter 插件中使用 FFI
    Dart 的 FFI（Foreign Function Interface）允许 Flutter 应用程序使用暴露 C API 的现有原生库。Dart 在 Android、iOS、Windows、macOS 和 Linux 上支持 FFI。
  • 使用 Flutter 和 Flame 构建游戏
    学习如何使用 Flutter 和 Flame 构建一个平台游戏！在涂鸦冲刺游戏中，灵感来自涂鸦跳跃，您可以扮演 Dash（Flutter 吉祥物）或她的好朋友 Sparky（Firebase 吉祥物），并通过跳跃平台尝试尽可能高地达到。
  • 使用 FirebaseUI 向 Flutter 应用程序添加用户身份验证流程
    了解如何使用 FlutterFire UI 包将 Firebase 身份验证添加到您的 Flutter 应用程序。您将向 Flutter 应用程序添加电子邮件/密码和 Google 登录授权。您还将学习如何设置 Firebase 项目，以及如何使用 FlutterFire CLI 在 Flutter 应用程序中初始化 Firebase。
  • 使用 Firebase Emulator Suite 在本地开发 Flutter 应用程序
    了解如何在本地开发期间使用 Firebase Emulator Suite 和 Flutter，包括如何使用 Emulator Suite 进行电子邮件-密码身份验证，以及如何读写数据到 Firestore 模拟器。此外，您将从模拟器导入和导出数据，以便每次返回开发时都使用相同的模拟数据。

此外，我们还更新了所有现有的 Codelab，以支持多平台。Codelab 和工作坊页面已更新，以反映最新的可用 Codelab。

文章

自上次稳定版本发布以来，我们已在Flutter Medium出版物上发布了以下文章

2022 年 8 月 31 日：Flutter Vikings：3.3 版本发布

#

Flutter 3.3 已上线！更多信息请参见

Flutter 3.3 的新功能，以及Dart 2.18：Objective-C & Swift 互操作（Medium 上的免费文章），以及Flutter 3.3 发布说明。

自 3.0 版本发布以来更新或新增的文档

  • 导航和路由概览页面已重写，提供了更多关于同时使用 Navigator 和 Router、命名路由以及使用路由包的指导。
  • URL 策略页面也已更新，以反映更简化的 API。
  • 对于未发布到 Microsoft Store 的应用，您现在可以在 pubspec 文件中设置应用可执行文件的文件和产品版本。有关更多信息，请参阅构建和发布 Windows 桌面应用。
  • 如果您正在为 iOS 16 及更高版本开发软件，则必须启用开发者模式。macOS 安装页面已更新此信息。
  • 如3.3 发布说明中所述，您应该通过设置 PlatformDispatcher.onError 回调来捕获应用程序中的所有错误和异常，而不是使用自定义 Zone。在 Flutter 中处理错误页面已根据此建议进行了更新。

2022 年 5 月 11 日：Google I/O 2022：Flutter 3 版本发布

#

Flutter 3 已上线！！！欲了解更多信息，请查看Flutter 3 简介、Flutter 3 的新功能和Dart 2.17：生产力和集成（Medium 上的免费文章），以及Flutter 3 发布说明。

自 2.10 版本发布以来更新或新增的文档

  • 我们推出了休闲游戏工具包，帮助您使用 Flutter 构建游戏。在游戏页面和游戏文档页面了解更多信息。
  • 您是否正在努力提升为 Flutter 开发者？我们创建了 Happy Paths 项目来提供帮助。在 Happy Paths 页面了解更多信息。（注意，此项目已停止，转而支持Flutter 精选项目。）
  • 您是一位希望对应用程序启动过程有更多控制权的 Web 开发者吗？请查看新增的自定义 Web 应用程序初始化页面，该页面已添加到新更新和收集的 /platform-integration/web 下的 Web 文档中。
  • Flutter 3 支持 Apple Silicon 处理器。我们更新了macOS 安装页面，提供了 Apple Silicon 下载按钮。
  • 在 Flutter 3 中，macOS 和 Linux 平台已达到稳定版，此外还有 Windows。您现在可以开发您的应用程序以在任何或所有这些平台上运行。因此，桌面（及相关）页面已更新。
  • 性能最佳实践页面已基本重写并移至更显眼的位置。这些更改包括关于避免卡顿的额外建议，包括如何最大程度地减少由内在因素引起的布局通过，以及最大程度地减少对 saveLayer() 调用的技术。
  • Firebase 的 Flutter 文档已全面更新。请查看新更新的Flutter Firebase 入门指南。
  • dart.dev 网站有其自己的新内容页面，但值得注意的一个新页面是指南JavaScript 开发者学习 Dart。请继续关注关于 Swift 和 C# 的类似文章。

Codelab 和工作坊

自上次稳定版本发布以来，我们新增了一个 codelab

此外，请查看我们的 GDE 编写的、在Flutter 社区博客上提供的研讨会。

视频

Google I/O 2022 已经结束，但您仍然可以在视频页面上查看 Google I/O 中 Flutter 特定的更新和讲座。

2022 年 2 月 3 日：Windows 支持：2.10 版本发布

#

对 Microsoft Windows 的桌面支持（2.10 版本的一个核心功能）已上线！更多信息请参见宣布 Flutter for Windows和Flutter 2.10 的新功能（Medium 上的免费文章）。

在新标签页中在 YouTube 上观看：“Flutter 更新：Windows”

2021 年 12 月 8 日：2.8 版本发布

#

Flutter 2.8 已上线！有关详细信息，请参见宣布 Flutter 2.8和Flutter 2.8 的新功能。

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

#

Flutter 2.5 已上线！有关详细信息，请参见Flutter 2.5 的新功能。

我们对 flutter/website 仓库进行了重大更改，使其更易于使用和维护。如果您为该仓库做出了贡献，请参阅README文件以获取更多信息。

自 2.2 版本发布以来更新或新增的文档

文章

自上次稳定版本发布以来，我们已在Flutter Medium出版物上发布了以下文章

2021 年 5 月 18 日：Google I/O 2021：2.2 版本发布

#

Flutter 2.2 已上线！有关详细信息，请参见Google I/O 2021 宣布 Flutter 2.2和Flutter 2.2 的新功能。

我们正在继续将网站上的代码迁移到使用空安全，但该工作尚未完成。

自 2.0 版本发布以来更新或新增的文档

  • 新增了关于构建自适应应用程序的页面。
  • 新增了一个页面，介绍如何将Google API与 Flutter 结合使用。
  • 新增了嵌入式 Flutter 支持的着陆页。
  • 新增了一个页面，介绍如何在 Android 上设置和使用延迟组件。
  • DevTools 内存视图页面有重大更新。
  • 桌面页面已更新，以反映桌面支持的进展，特别是对 Windows UWP 的新支持。

Codelab

自上次稳定版本发布以来新增的 codelab

工作坊

针对 Google I/O 2021，我们新增了一个基于 DartPad 的 Flutter/Dart 学习工具：工作坊！这些工作坊旨在由讲师主导。讲师主导的视频可在 Flutter 和 Firebase 的 YouTube 频道上找到

要查看 I/O 上“所有 Flutter 相关内容”的活动列表，请参阅Google 2021 I/O Flutter页面。

您可以编写自己的 DartPad 工作坊！如果您感兴趣，请查看以下资源

文章

自上次稳定版本发布以来，我们已在Flutter Medium出版物上发布了以下文章

2021 年 3 月 3 日：Flutter Engage：2.0 版本发布

#

Flutter 2 已上线！！！有关详细信息，请参见宣布 Flutter 2、Flutter 2 的新功能、Flutter Web 支持达到稳定里程碑、宣布 Dart 2.12，以及Flutter 2 发布说明。

自 1.22 版本发布以来更新或新增的文档

Codelab

我们的许多 Codelab 都已更新为支持空安全。自上次稳定版本发布以来，我们还新增了一个 Codelab

如需完整列表，请参阅Flutter codelab。

文章

自上次稳定版本发布以来，我们已在Flutter Medium出版物上发布了以下文章

2020 年 10 月 1 日：1.22 版本发布

#

Flutter 1.22 已上线！有关详细信息，请参见宣布 Flutter 1.22。

自 1.20 版本发布以来，flutter.dev 上更新或新增的文档

Codelab

自上次稳定版本发布以来，我们新增了一个 Codelab

如需完整列表，请参阅Flutter codelab。

文章

自上次稳定版本发布以来，我们已在Flutter Medium出版物上发布了以下文章

2020 年 8 月 5 日：1.20 版本发布

#

Flutter 1.20 已上线！有关详细信息，请参见宣布 Flutter 1.20。

flutter.dev 上更新或新增的文档

对 null safety 的深入探讨已添加到 dart.dev

Codelab

Flutter Day于 2020 年 6 月 25 日举行。为了筹备此次活动，我们编写了新的 codelab 并更新了现有的 codelab。新的 codelab 包括

如需完整列表，请参阅Flutter codelab。

文章

自上次稳定版本发布以来，我们已在Flutter Medium出版物上发布了以下文章

2020 年 5 月 6 日：居家办公：1.17 版本发布

#

Flutter 1.17 已上线！

有关更多信息，请参见宣布 Flutter 1.17。

自上次发布以来新增和更新的文档包括

其他新内容

2019 年 12 月 11 日：Flutter Interact：1.12 版本发布

#

Flutter 1.12 已上线！

欲了解更多信息，请参阅Flutter：为环境计算设计的第一个 UI 平台、宣布 Flutter 1.12：不平凡的一年！和Flutter 1.12.13发布说明。

自上次发布以来新增和更新的文档包括

  • 为了配合更新的添加到应用实现，我们添加了关于如何为 iOS 和 Android 将 Flutter 添加到现有应用的文档。
  • 如果您拥有插件代码，我们鼓励您更新到新的 Android 插件 API。有关更多信息，请参阅将您的插件迁移到新的 Android API。
  • Web 支持已移至 Beta 渠道。有关更多信息，请参见Flutter 的 Web 支持以及 Medium 出版物上的Flutter 的 Web 支持进入 Beta 阶段。此外，使用 Flutter 构建 Web 应用页面也已更新。
  • 新的“在 Web 上编写您的第一个 Flutter 应用程序”Codelab 已添加到入门文档中，并包含在 DevTools 中设置断点的说明！
  • 我们推出了一项推荐特定 Dart 和 Flutter 插件及包的计划。了解更多关于Flutter 精选项目的信息。
  • 一个新的隐式动画 codelab 可用，其中包含 DartPad。（要运行它，您无需下载任何软件！）
  • macOS（桌面）的 Alpha 支持现已在 master 和 dev 渠道的 1.13 版本中提供。有关更多信息，请参见Flutter 的桌面支持。
  • 应用大小页面的 iOS 部分已更新，以反映 bitcode 的包含。
  • Flutter 布局资源管理器（一项新功能，也是 Flutter Inspector 的一部分，可让您探索布局的可视化表示）的 alpha 版本已发布。有关更多信息，请参见Flutter 布局资源管理器文档。

其他新内容

快乐的 Fluttering！

2019 年 9 月 10 日：1.9 版本发布

#

Flutter 1.9 已上线！

有关更多信息，请参见来自 GDD 中国的 Flutter 新闻：统一 Flutter 在 Web 和移动端，并推出 Flutter 1.9和1.9.1 发布说明。

对于 1.9 版本，Flutter 的 Web 支持已合并（“解除了分支”）到主仓库中。Web 支持尚未达到 Beta 阶段，尚未准备好用于生产。Web 和桌面支持（也即将推出）将影响网站，该网站最初专门用于开发 Flutter 移动应用程序。一些网站更新现已可用（并列在下面），但更多更新将陆续推出。

网站上新增和更新的文档包括

  • 我们重新设计了展示页面。
  • Flutter 布局 codelab 已重写，并使用更新的 DartPad（基于浏览器的运行 Dart 代码的工具）。DartPad 现在支持 Flutter！试用一下，告诉我们您的想法。
  • 新增了一页关于使用 dart:ffi 库将您的应用绑定到原生代码（一个目前正在开发中的功能）的内容。
  • 性能视图工具已在 DevTools 中启用，该工具允许您记录和分析 Dart/Flutter 应用程序的会话。有关更多信息，请参见性能视图页面。
  • 新增了一页关于构建 Web 应用程序的内容。
  • 新增了一页关于在 Flutter 中创建响应式应用的内容。
  • 新增了一页关于为发布准备 Web 应用的内容。
  • 新增了一个Web 常见问题。
  • Flutter for web页面已更新。

其他相关文档

快乐的 Fluttering！

2019 年 7 月 9 日：1.7 版本发布

#

Flutter 1.7 已上线！

更多信息请参见宣布 Flutter 1.7，刊载于Flutter Medium 出版物，以及1.7.8 发布说明。

网站上新增和更新的文档包括

Flutter 1.7 版本包含新的RangeSlider组件，它允许用户在值范围内选择上限和下限。有关此组件及其自定义方法的信息，请参见Flutter 中的 Material RangeSlider。

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

#

Flutter 1.5 已上线！

有关更新的更多信息，请参阅1.5.4 发布说明或下载发布版。

我们正在更新 DartPad 以支持 Flutter。尝试新的“Flutter 基本布局”Codelab，并告诉我们您的想法！

2019 年 2 月 26 日：1.2 版本发布

#

Flutter 在巴塞罗那世界移动通信大会（MWC）发布了1.2 版本。更多信息请参见1.2.1 发布说明或下载发布版。

此外，以下是一些最近新增和更新的文档

如果您对这些文档有任何疑问或意见，请提交问题。

2018 年 11 月 5 日：新网站

#

欢迎来到焕然一新的 Flutter 网站！

在过去的几个月里，我们重新设计了网站及其信息组织方式。我们希望您能更轻松地找到您正在寻找的文档。网站的一些更改包括

  • 修订后的首页
  • 修订后的展示页面
  • 修订后的社区页面
  • 左侧边栏导航已修订
  • 大多数页面右侧的目录

一些新内容包括

如果您对改版后的网站有任何疑问或意见，请提交问题。

除非另有说明，本网站上的文档反映了 Flutter 的最新稳定版本。页面最后更新于 2025 年 5 月 20 日。 查看来源 或 报告问题。