最新动态

此页面介绍了 Dart 网站和博客上的新内容。要查看 Flutter 的新功能，请访问Flutter 最新动态页面。

有关每个 Dart SDK 中 Dart 语言更改的列表，请参阅语言演变页面。要了解公告（包括重大更改），请加入Dart 公告 Google 网上论坛并关注Dart 博客。

本节列出了 2024 年 5 月 15 日至 2024 年 8 月 6 日期间所做的显著更改。有关 Dart 3.5 版本的详细信息，请查看3.5 公告和SDK 变更日志。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 阐明了新的和旧的Web 平台库的状态和预期用途。
• 扩展了关于将包的预发布版本发布到 pub.dev 站点的文档。
• 添加了一个页面，涵盖新的dart pub unpack 命令。
• 记录了 dart pub publish 的新--skip-validation 标志和 dart pub downgrade 的 --tighten 标志。
• 为包作者提供了最佳实践指南，以使用降级依赖项测试他们的包。
• 改进了修复类型提升失败指南，并添加了代码高亮以更好地指示相关代码。
• 补充了Dart 安装文档，其中包含卸载和清理说明。
• 引入了新的文档和代码示例，涵盖函数和构造函数的提取。
• 解释了如何导出 Dart 函数和对象，以便从 JS 中使用。
• 为子类和子类型添加了词汇表条目，解释了 Dart 上下文中的术语。

本节列出了 2024 年 2 月 16 日至 2024 年 5 月 14 日期间所做的显著更改。有关 3.4 版本的详细信息，请查看3.4 博客文章和SDK 变更日志。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 添加了一个页面，记录实验性的宏语言功能。
• 添加了一个页面来跟踪 Dart 的 Wasm 开发。
• 重构了构造函数页面。
• 阐明了 package:web 迁移页面的重命名部分的说明。
• 调整了关于启用类型提升的有效 Dart 条目，以建议首先使用 null 检查模式，然后再使用其他习惯用法。
• 修订了Web 库和包列表，以更好地表示推荐的解决方案。
• 解释了如何在记录和模式页面上解构命名字段。
• 在 JS 互操作页面上包含了 Web 解决方案的前后对比表。
• 在运算符页面上添加了一个部分，解释展开运算符。
• 阐明了模式类型页面上带括号的模式的排序。
• 为 JS 类型页面上的ExternalDartReference添加了文档。
• 更新了站点以适应新的linter 规则和诊断消息，例如为新的 @mustBeConst 注释诊断添加文档。

我们在 Dart 博客上发表了以下文章

• Dart 中 JS 互操作的历史
• 2024 年 Google 代码夏令营中的 Dart

本节列出了 2023 年 11 月 16 日至 2024 年 2 月 15 日期间所做的显著更改。有关 3.3 版本的详细信息，请查看3.3 博客文章和SDK 变更日志。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 更改了站点基础结构，以在 11ty 上运行，而不是 Jekyll。
• 添加了一个页面，涵盖新的语言功能扩展类型。
• 添加了一个关于JavaScript 互操作的新文档集
  • 用法
  • JS 类型
  • 教程，第一个是关于模拟的
  • 过去的 JS 互操作
• 更新了并发概述，以及一个新的关于使用隔离区的实践页面。
• 在函数页面中添加了关于external的部分。
• 从一些页面中删除了嵌入式 DartPad，以适应新版本的DartPad。
• 在词汇表中包含了“函数”的定义。
• 将库导览分解为每个库的单独页面。
• 更新了重大更改页面，以适应 3.3 版本。
• 更新了常见问题解答页面上的一些过时条目。
• 扩展了关于dart doc的文档。
• 更新并简化了支持的平台内容。
• 合并了多个dart format内容。
• 更新了各个位置，建议使用 package:web，而不是 dart:html。
• 不再建议使用dart:html和dart:io来发出 HTTP 请求，而是建议使用 package:http。
• 记录了在 pubspec 文件中禁止诊断。
• 添加了关于在 pubspec 文件中创建和忽略安全公告的内容。
• 记录了如何从撤回的包版本迁移。

本节列出了 2023 年 8 月 17 日至 2023 年 11 月 15 日期间所做的显著更改。有关 3.2 版本的详细信息，请查看3.2 博客文章和SDK 变更日志。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 为新的类型提升功能更新了修复类型提升失败页面：私有最终字段提升。
  • 对“Effective Dart”中关于类型提升的条目、《理解空安全》页面以及网站上的其他各个地方进行了小的相关调整。
• 在C 互操作页面中引入了关于实验性原生资源特性的文档。
• 创建了一个新页面，专门用于记录重大更改。
• 在各自的文档页面中考虑了新的和更新的linter 规则和诊断信息。
• 为pub upgrade页面添加了新的 --tighten 标志的文档。
• 删除了速查表，改为使用语言概述页面。
• 澄清了守卫子句和模式之间的关系。
• 调整了构造函数页面，以更好地表示最佳实践。
• 改进了包依赖页面的内容，使其更具可操作性且更易于理解。
• 在扩展方法页面中详细阐述了静态成员。
• 修改了Objective-C多线程限制的内容，以考虑新的 NativeCallable API。
• 在元数据页面上添加了新的注解并提及了弃用。
• 通过调整整个网站代码示例中的文本颜色和高亮显示，提高了对比度。
• 在全面重组和简化站点基础设施的同时，为不再使用 Jekyll 做准备。

本节列出了 2023 年 5 月 11 日至 2023 年 8 月 16 日期间所做的重要更改。有关 3.1 版本的详细信息，请查看Dart 3.1 & 对 Dart 3 中函数式编程风格的回顾 和SDK 更新日志。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 全面修改了 linter 规则文档，以取代旧的 linter 站点。
  • 将每个 linter 规则的文档移动到其自己的页面。例如：avoid_dynamic_calls。
  • 添加了一个示例 analysis_options.yaml，其中启用了最新 Dart 版本中提供的所有 linter 规则。
  • 更新了所有可用 linter 规则的索引，以便更容易发现 lint。
• 通过添加类修饰符参考来概述它们如何相互作用，从而增强了类修饰符的文档。
• 引入了API 维护人员的类修饰符指南，以帮助开发人员更好地使用类修饰符。
• 重写了switch 表达式的文档，以更好地说明其与 switch 语句的不同之处。
• 记录了在 pubspec 文件中指定主题以在 pub.dev 站点上对包进行分类的支持。
• 澄清了包截图旨在展示包的功能，而不是包的徽标或图标。
• 在 Dart 的语言文档中添加了“上一页”和“下一页”按钮，以实现引导式学习体验。
• 继续扩展新的全站点词汇表。
• 添加了一个关于 Windows 上pub 缓存移动如何在 Dart 3 中完成的迁移说明。
• 简化并更新了旧文档，因为 Dart 的类型系统现在始终是空安全的。

我们在 Dart 博客上发表了以下文章。

• Dart DevTools：使用 CPU 分析器分析应用程序性能

本节列出了 2023 年 1 月 26 日至 2023 年 5 月 10 日期间所做的重要更改。有关 3.0 主要版本的详细信息，请查看Dart 3 发布和SDK 更新日志。

为了准备 Dart 3，我们将语言之旅拆分并重新组织为新的概念类别。您可以访问侧面导航菜单中语言下的重组语言文档，或访问更新后的Dart 入门。

利用这种新结构，我们为 Dart 3 的每个主要功能添加了文档。

• 模式匹配和不同的模式类型。
• 支持模式和穷举性检查的Switch 表达式。
• 支持模式匹配的带有 case 子句的 If 语句。
• 一种新的匿名、不可变和聚合类型记录，它支持多重返回。
• 允许库对导出的类型进行更多控制的类修饰符。

为了帮助您过渡到 Dart 3 对健全空安全的强制执行和其他更改，我们还准备了以下更新。

• 创建了全面的Dart 3 迁移指南。
• 将所有文档和代码示例迁移到 Dart 3、最新的工具版本和最新的依赖项。
• 澄清了 Dart 的类型系统现在在 Dart 3 中始终是空安全的。
• 更新并重新组织了语言演变页面及其语言版本控制讨论。
• 删除了 Dart 1 和早期 Dart 2 文档、注释和资源的残留。

除了新的 Dart 3 内容和整个网站的相应更新之外，我们还进行了以下更改。

• 添加了关于配置编译环境声明的指南。
• 通过添加关于Java 互操作实验性支持的指南，继续了 Dart 的原生互操作工作。
• 澄清了未命名扩展的用法和限制。
• 为新的dart info命令添加了一个页面，该命令有助于工具诊断。
• 全面修改了dart pub add文档，以涵盖其新的源描述符语法。
• 在SDK 存档中的 beta 通道上展示了预览版 Linux RISC-V (RV64GC) 构建。
• 开始了新的全站点词汇表，其中包含整个站点中使用的常用术语。
• 重点介绍了 Dart 在JS 静态互操作支持方面的实验性工作。
• 记录了分析器插件的存在和当前限制。

我们在 Dart 博客上发表了以下文章。

• 为 Dart 和 Flutter 引入 Realm

在 2023 年 Google I/O 期间，我们发布了以下视频。

• Dart 和 Flutter 的新功能（美国手语版本）
• 重新思考与 Android 的 Dart 互操作性
• 如何在 Dart 中构建包

本节列出了 2022 年 8 月 31 日至 2023 年 1 月 25 日期间所做的重要更改。有关 2.19 + 3.0 alpha 版本的详细信息，请参见Dart 3 alpha 版简介和SDK 更新日志。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 引入了关于使用 package:http 的从互联网获取数据教程。
• 添加了关于自动将包发布到 pub.dev 的页面。
• 在我们的社区资源部分中加入了两个新的站点翻译链接。
  • 该站点的韩语版本（한국어）
  • 该站点的繁体中文版本（正體中文版）
• 更新了空安全内容，为 Dart 3 做准备。
  • 更改了迁移指南中 Dart 3 兼容性的版本约束。
  • 在健全空安全页面上添加了 Dart 3 完全健全空安全概述。
  • 在注释中强调了 Dart 3 与不健全空安全的不兼容性。
• 引入了新的作为 Swift 开发人员学习 Dart 指南。
• 用关于布尔值和相等运算符的更通用指南替换了 Effective Dart 部分。
• 记录了 pub 文档中的内容哈希。
• 开始努力全面修改区域页面，将示例更改为使用 runZonedGuarded 而不是 onError。
• 更新了库上的内容，以涵盖新的无名声明开发。
  • Effective Dart：文档、样式和用法
  • 语言之旅中的新库指令部分。
• 提高了对 Dart 单线程或多线程状态的清晰度。
  • 删除了过时的 dart:io 页面。
  • 扩展了Dart 的 Web 并发功能。
• 重新排列并澄清了可选和位置参数的默认值的讨论。
• 更新了Dart 中的并发，使其默认为新的 Isolate.run() 函数。
• 记录了在pub global 页面上激活包时指定文件路径的方法。
• 重写了作为 JavaScript 开发人员学习 Dart。
• 在dart run 页面中添加了 Dart DevTools 的简要概述。
• 在语言之旅中提供了关于运算符优先级和结合性的更多清晰说明。
• 使用 URI http 和工厂构造函数信息扩展了关于构建 URI的库之旅部分。
• 考虑了pub 从 pub.dartlang.org 过渡到 pub.dev 的问题。
• 添加了关于包截图的文档。
• 改进了 Dart 类型系统页面的显式向下转换部分。
• 增加了分析器和lint 的覆盖范围。
  • 包含了 linter 规则的 SDK 版本支持信息。
  • 为 2.19 更改添加了诊断和 lint 消息。

我们在 Dart 博客上发表了以下文章

• 使用 Isolate.run() 更好地隔离管理
• pub.dev 的截图和自动发布
• 通往 Dart 3 的道路：一种完全健全的、空安全的语言
• 2022 年 Google 编程之夏的结果
• 与 GitHub 合作，确保 Dart 包的供应链安全

本节列出了从 2022 年 5 月 12 日至 2022 年 8 月 30 日期间的重大变更。有关 2.18 版本的详细信息，请参阅 Dart 2.18：Objective-C 和 Swift 互操作，以及 SDK 更改日志。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 引入了 Objective-C 和 Swift 互操作 页面，其中解释了如何使用 Dart 包来调用这些语言的 API。
• 为 修复常见的类型问题 添加了一个解决方法，以应对类型推断可能错误地推断参数类型为 null 的罕见情况。
• 从 什么不应该提交 中删除了所有关于已停用的 .packages 文件的提及。如果您仍然需要生成 .packages 文件以满足第三方遗留依赖项的需求，请参阅 dart pub get 选项。
• 删除了已停用的 dart2js 和 dartdevc 命令行工具的专用页面以及任何其他提及。
  • 将先前与 dart2js 关联的命令行选项和已知问题添加到了 dart compile 页面。
  • 将关于调试生产代码的信息添加到了 调试 Dart Web 应用。
• 为 Dart SDK 存档 添加了下载实验性 Windows ARM 构建版本的支持。
• 更新了 库概览，以包含有关弱引用和终结器的信息。
• 添加了有关自定义 dart fix 的部分。

本节列出了从 2022 年 2 月 4 日至 2022 年 5 月 11 日期间的重大变更。有关 2.17 版本的详细信息，请参阅 Dart 2.17：生产力和集成。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 引入了 作为 JavaScript 开发人员学习 Dart 指南，旨在利用您在学习 Dart 时的 JavaScript 编程知识。
• 记录了 Dart 2.17 中引入的功能和更改。
  • 更新了语言概览中的 命名参数 部分，以反映对在任何位置指定命名参数的支持。
  • 添加了 超类初始化参数 的文档。
  • 扩展了语言概览中的 枚举类型 部分，并记录了 增强型枚举。
  • 记录了对使用 dart compile exe 编译的 macOS 和 Windows 可执行文件进行 签名 的支持。
  • 将 dart create 支持的模板更新为新的标准化名称。
• 考虑了对 pub.dev 站点 和 pub 工具 的更改。
  • 列出了提供 Dart 包存储库即服务 的供应商。
  • 删除了对现在已停用的 dart pub uploader 命令的文档。
  • 扩展了关于管理 pub 项目 上传者 的文档。
  • 删除了大多数对已弃用的 .packages 文件的提及，而是指向其替代项 .dart_tool/package_config.json。
• 更新了关于更新和安装 Dart 的文档。
  • 在 macOS 安装说明 中记录了如何使用 Homebrew 在 Dart 版本之间切换。
  • 更新了 Linux 安装说明，以使用 SecureApt 并遵循最新的最佳实践。
  • 为从 Dart SDK 存档 下载实验性的 Linux RISC-V (RV64GC) 构建版本添加了支持。
• 继续改进和更新对 统一的 dart 工具 的文档。
  • 扩展了关于 dart fix 工具的功能的文档。
  • 调整了 dart doc 工具的指南和文档，以匹配其功能和底层行为。
  • 添加了 dart compile js 的更多文档和示例。
  • 删除了对已移除的独立工具的提及。
• 更新了分析器和 linter 的文档和用法。
  • 记录了分析器新的 严格语言模式。
  • 合并了对 诊断消息 和 linter 规则 页面的更改。
  • 更新了文档和示例，以使用 lints 包的 2.0.0 版本。
• 开始全面改进 Web 编译的文档。
  • 记录了 dart2js 和 dartdevc 独立工具的弃用和计划移除。
  • 整合并阐明了 dart2js 和 dartdevc 的文档，它们是诸如 dart compile js 和 webdev 等工具的底层编译器。
• 增加了对空安全性的文档覆盖率。
  • 在语言概览的 其他运算符 部分中记录了非空断言运算符（!）。
  • 迁移了 低级 HTML 教程 以支持空安全性，并讨论了如何在其中使用空安全性与 Web API 进行交互。
• 进行了其他杂项更新。
  • 记录了 dart:ffi 提供的 本机类型，用于 C 互操作。
  • 在语言概览中引入了一个新部分，记录了 初始化形式参数。
  • 记录了 DartPad 对 包的支持。
  • 修复了 异步编程教程 中的格式问题，并阐述了 为什么异步代码很重要。
  • 更新了 安全性 页面，以匹配我们当前的安全实践。
  • 添加了一个键盘绑定 (/) 以自动聚焦搜索栏。

我们在 Dart 博客上发表了以下文章

• 批量应用修复。
• Dart 异步编程：流。
• Google 编程之夏 2022 的贡献者。
• 大型 Dart 项目的渐进式空安全迁移。
• 托管私有 Dart 包存储库。
• 快速修复分析问题。

本节列出了从 2021 年 12 月 8 日至 2022 年 2 月 3 日期间的重大变更。有关 2.16 版本的详细信息，请参阅 Dart 2.16：改进的工具和平台处理。

我们 将网站基础设施更新为基于 Docker 的设置，以实现 更轻松的贡献，并更紧密地与 docs.flutter.dev 的设置保持一致。

除了其他错误修复和渐进式改进外，我们还对本网站进行了以下更改。

• 切换到记录新的 dart doc 工具，该工具取代了 dartdoc。
• 记录了新的 platform 条目，以在包的 pubspec.yaml 中指定支持的平台。
• 更新了 诊断消息 和 linter 规则 页面。
• 记录了如何在一个文件中 忽略所有 linter 规则。
• 从 Dart SDK 概述 中删除了对旧的独立工具的提及。
• 将剩余的对旧的独立工具的提及更新为其 dart 工具等效项。
• 在 首选使用插值来组合字符串和值 的 Effective Dart 指南中添加了说明。

本节列出了从 2021 年 9 月 9 日至 2021 年 12 月 8 日期间的重大变更。有关 2.15 版本的详细信息，请参阅 宣布 Dart 2.15。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 添加了 Dart 中的并发，其中讨论了诸如隔离之类的功能，这些功能支持并行执行 Dart 代码。
• 记录了在 2.15 中添加或改进的 pub 功能。
  • 为新的 pub 子命令 dart pub token 添加了一个页面，并添加了一个关于 自定义包存储库 的页面。
  • 添加了关于 包撤回 的信息。
  • 将 false_secrets 字段添加到 pubspec 页面。
  • 更新了 托管依赖项 的语法。
• 删除了 Dart 1 书籍 的所有条目。
• 扩展了 DartPad 故障排除提示。
• 更新了 诊断消息 页面。
• 更新了 linter 规则 页面；删除了对已弃用的规则集（例如 effective_dart）的引用。
• 更新了安装和使用 Dart DevTools 的说明。
• 添加了关于 Dart 运行时 提供的内容的信息，并阐明了 编译格式。

本节列出了从 2021 年 5 月 20 日至 2021 年 9 月 8 日期间的重大变更。有关 2.14 版本的详细信息，请参阅 宣布 Dart 2.14。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 充实了关于 修复类型提升失败 的页面。
• 记录了如何使用 .pubignore 文件，这是在 Dart 2.14 中引入的功能。
• 添加了对 无符号移位运算符 (>>>) 的覆盖，这是在 Dart 2.14 中引入的。
• 构建了 linter 规则页面；更新了 Effective Dart 以链接到它。
• 为 dart create 和 dart test 命令添加了页面。
• 完成了将示例从使用旧的命令行工具（例如，dartfmt）转换为使用 统一的 dart 工具（例如，dart format）的转换。
• 更新了网站代码以使用 推荐的 linter 规则，而不是 pedantic。
• 更新了 核心库 和 常用包 的列表。
• 添加了从 dart.dev/jobs 到 flutter.dev/jobs 的重定向，以便更容易找到 Dart 和 Flutter 团队的空缺职位。
• 完成了将所有已分析或测试的代码迁移到空安全性，并更新了文本以进行匹配。发现更多未分析的网站代码；修复了该问题。

我们在 Dart 博客上发表了以下文章

• 使用 Dart 和 Wasm 进行实验。
• Dart 的空安全性如何帮助我增强我的项目。
• 在 Dart FFI 中按值实现结构体。

本节列出了从 2021 年 3 月 4 日至 2021 年 5 月 19 日期间的重大变更。有关 2.13 版本的详细信息，请参阅 宣布 Dart 2.13。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 更新了语言概览中的 typedef 部分，以反映在 Dart 2.13 中引入的非函数类型别名。
• 发布或更新了与命令行和服务器相关的文档
  • 使用 Google Cloud 介绍了 Dart 服务器可以使用的 Google Cloud 产品，通常借助预先打包的 Docker 镜像。
  • 之前使用已弃用的 http_server 包的HTTP 服务器教程已临时替换为“正在建设中”的页面，该页面链接到有用的文档和示例。
  • 命令行教程已完全更新。
• 发布了一些其他新页面
  • Null 安全性代码实验室，教您了解 Dart 的 null 安全类型系统，该系统在 Dart 2.12 中引入。
  • Dart 中的数字 详细介绍了原生和 Web 数字实现之间的差异。
  • 使用 Google API 指向相关资源，帮助您从 Dart 应用程序中使用 Firebase 和 Google 客户端 API。
  • 编写软件包页面 提供了有关编写在 pub.dev 上效果良好的软件包 README 的技巧。
  • 修复类型提升失败 提供了帮助您了解类型提升失败原因的信息，并提供了有关如何修复它们的技巧。
  • 新的 dart run 页面 介绍了如何从命令行运行 Dart 程序。
• 继续进行将代码迁移到 null 安全性的工作，特别是流教程。
• 进行了其他杂项更新。
  • 删除了对 Stagehand 的引用，改用 dart create。
  • 将 dart.dev 示例代码的分析选项从使用 pedantic 更改为使用 lints 中的推荐规则。
  • 添加了 Docker 作为获取 Dart 的一种方式。
  • 更新了语言演化页面以反映 Dart 2.13。

我们在 Dart 博客上发表了以下文章

• AngularDart、Flutter 和 Web：春季更新
• 宣布 Dart 支持 GitHub Actions
• Dart 入选 2021 年 Google 编程之夏

本节列出了 2020 年 10 月 2 日至 2021 年 3 月 3 日期间所做的重大更改。有关 2.12 版本的详细信息，请参阅宣布 Dart 2.12。

除了错误修复和增量改进外，我们还对此站点进行了以下更改

• 更新并充实了 null 安全性文档。特别是：
  • 提供了一个迁移指南。
  • 添加了一个常见问题解答。
  • 创建了不健全的 null 安全性。
  • 简化了null 安全性主页。
• 刷新了 Effective Dart，更新了代码以实现 null 安全性，并更改了规则以反映新的指导原则。
• 刷新了语言之旅，更新了代码以实现 null 安全性，并添加了有关新功能（例如 late 变量）的信息。
• 更新了语言演化页面，以添加有关语言版本控制的信息并反映 Dart 2.12。
• 更新了库之旅和教程，以反映健全的 null 安全性。
• 更新了整个站点的页面，以使用 dart 工具而不是已弃用的命令。开始为各种 dart 命令添加页面，包括 dart analyze、dart compile、dart fix 和 dart format。
• 创建了一个页面，记录了Dart 团队软件包的质量和支持情况。
• 用新的概览页面替换了平台页面。
• 创建了此页面（“新增功能”）。

我们还从 Travis CI 切换到 GitHub Actions，并对 CSS 进行了多项更改以提高网站的可读性。

我们在 Dart 博客上发表了以下文章

• 为 null 安全性准备 Dart 和 Flutter 生态系统 宣布了 null 安全性 API 的稳定性，并邀请开发人员发布其软件包的稳定、null 安全版本。
• Dart 和健全类型的性能优势 展示了健全性和 null 安全性如何使 Dart 编译器能够生成更快、更小的代码。
• 为什么使用可空类型？ 扩展了在 /r/dart_lang subreddit 上的讨论，回答了“为什么不完全消除 null？”的问题。
• 宣布 Dart null 安全性 Beta 版 邀请开发人员开始规划其向 null 安全性的迁移。

本节列出了 2020 年 7 月 1 日至 10 月 1 日期间所做的重大更改。有关 2.10 版本的详细信息，请参阅宣布 Dart 2.10。

除非另有说明，否则本网站上的文档反映了 Dart 3.6.0。页面上次更新时间为 2024-12-16。 查看源代码 或 报告问题。