目录

新增内容

本页面描述了 Dart 网站和博客上的新增内容。要查看 Flutter 的新增内容,请访问 Flutter 新增内容页面

要查看每个 Dart SDK 中 Dart 语言变化的列表,请参阅 语言演变页面 。要及时了解公告,包括重大更改,请加入 Dart 公告 Google 论坛 并关注 Dart 博客

2024年8月6日:3.5 版本发布

#

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

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

2024年5月14日:3.4 版本发布

#

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

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

Dart 博客新增文章

#

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

2024年2月15日:3.3 版本发布

#

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

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

2023年11月15日:3.2 版本发布

#

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

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

  • 更新了 修复类型提升失败 页面,以介绍新的类型提升特性:私有 final 字段提升。

    • 对关于 的 Effective Dart 条目进行了次要的相关调整。
  • 更新了 类型提升理解空安全 页面以及网站上的其他各个地方。

  • C 交互操作 页面上介绍了关于实验性原生资产特性的文档。

  • 创建了一个新的页面专门用于记录 重大更改

  • 在各自的文档页面中考虑了新的和更新的 代码检查诊断

  • pub upgrade 页面添加了新的 --tighten 标志的文档。

  • 删除了备忘单,改用 语言概述 页面。

  • 阐明了 保护子句和模式 之间的关系。

  • 调整了 构造函数 页面,以更好地体现最佳实践。

  • 改进了 包依赖项 页面的内容,使其更易于操作和理解。

  • 扩展方法 页面上详细阐述了静态成员。

  • 更改了 Objective-C 的多线程限制内容,以考虑新的 NativeCallable API。

  • 元数据 页面上添加了新的注释并提到了弃用。

  • 通过调整文本颜色和突出显示网站上的代码示例来提高对比度。

  • 为了 放弃使用 Jekyll ,彻底重组并简化了网站基础架构。

2023年8月16日:3.1 版本发布

#

本节列出了从2023年5月11日至2023年8月16日之间做出的显著更改。有关 3.1 版本的详细信息,请查看 Dart 3.1 和 Dart 3 中函数式编程的回顾SDK 变更日志

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

  • 大修了代码检查规则文档,以替换旧的代码检查站点:
  • 通过添加 类修饰符参考 来扩展 类修饰符 文档,概述它们如何相互作用。
  • 引入了一个 面向 API 维护者的类修饰符 指南,以帮助开发人员最佳地使用类修饰符。
  • 重写了 switch 表达式 文档,以更好地说明它与 switch 语句的区别。
  • 记录了在 pubspec 文件中指定 主题 以在 pub.dev 网站上对包进行分类的支持。
  • 阐明了 包屏幕截图 用于展示包的功能,而不是包的徽标或图标。
  • 在 Dart 的 语言文档 中添加了上一页和下一页按钮,以实现引导式学习体验。
  • 继续扩展新的全站 词汇表
  • 添加了一个关于如何在 Dart 3 中最终确定 Windows 上的 pub 缓存移动 的迁移说明。
  • 简化并更新了旧的文档,因为 Dart 的类型系统现在始终是 空安全 的。

Dart 博客新增文章

#

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

2023年5月10日:3.0 版本发布

#

本节列出了从2023年1月26日至2023年5月10日之间做出的显著更改。有关主要 3.0 版本的详细信息,请查看 宣布 Dart 3SDK 变更日志

dart.dev 更新或新增文档

#

为了准备 Dart 3,我们将语言教程拆分并重新组织到新的概念类别中。您可以在侧边导航菜单的 语言 下访问重组的语言文档,或者访问更新的 Dart 简介

利用这个新结构,我们为 Dart 3 的每个主要特性添加了文档:

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

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

除了新的 Dart 3 内容和网站上的相应更新之外,我们还进行了以下更改:

Dart 博客新增文章

#

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

Dart 团队发布的视频

#

在 2023 年 Google I/O 大会期间,我们发布了以下视频:

2023年1月25日:2.19 + 3.0 alpha 版本发布

#

本节列出了从2022年8月31日至2023年1月25日之间做出的显著更改。有关 2.19 + 3.0 alpha 版本的详细信息,请参阅 介绍 Dart 3 alpha , 以及 SDK 变更日志

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

Dart 博客新增文章

#

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

2022年8月30日:2.18 版本发布

#

本节列出了从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 选项
  • 删除了专用页面以及对已弃用的 dart2jsdartdevc 命令行工具的所有其他提及。
  • Dart SDK 存档 添加了对下载实验性 Windows ARM 版本的支持。
  • 更新了 库教程 ,其中包含关于弱引用和终结器的信息。
  • 添加了关于自定义 dart fix 的部分。

2022年5月11日:2.17 版本发布

#

本节列出了从2022年2月4日至2022年5月11日之间做出的显著更改。有关 2.17 版本的详细信息,请参阅 Dart 2.17:生产力和集成

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

  • 介绍了 作为 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 的更多文档和示例。
    • 删除了对已删除的独立工具的提及。
  • 更新了分析器和代码检查器的文档和用法:

  • 开始彻底修改 Web 编译的文档:

    • 记录了 dart2jsdartdevc 独立工具的弃用和计划删除。
    • 整合并阐明了 dart2jsdartdevc 的文档,它们是 dart compile jswebdev 等工具的基础编译器。
  • 增加了空安全的文档覆盖范围:

    • 将非空断言运算符( ! )记录为语言教程 其他运算符 部分的一部分。
    • 迁移了 低级 HTML 教程 以支持空安全,并讨论了如何在使用空安全时与 Web API 交互。
  • 进行了其他杂项更新:

Dart 博客新增文章

#

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

2022年2月3日:2.16 版本发布

#

本节列出了从2021年12月8日至2022年2月3日之间做出的显著更改。有关 2.16 版本的详细信息,请参阅 Dart 2.16:改进的工具和平台处理

dart.dev 更新或新增文档

#

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

除了其他错误修复和增量改进之外,我们还对本网站进行了以下更改:

2021年12月8日:2.15 版本发布

#

本节列出了从2021年9月9日至2021年12月8日之间做出的显著更改。有关 2.15 版本的详细信息,请参阅 宣布 Dart 2.15

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

2021年9月8日:2.14 版本发布

#

本节列出了从2021年5月20日至2021年9月8日之间做出的显著更改。有关 2.14 版本的详细信息,请参阅 宣布 Dart 2.14

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

Dart 博客新增文章

#

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

2021年5月19日:2.13 版本发布

#

本节列出了从2021年3月4日至2021年5月19日之间做出的显著更改。有关 2.13 版本的详细信息,请参阅 宣布 Dart 2.13

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

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

Dart 博客新增文章

#

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

2021年3月3日:2.12 版本发布

#

本节列出了从2020年10月2日至2021年3月3日之间做出的显著更改。有关 2.12 版本的详细信息,请参阅 宣布 Dart 2.12

dart.dev 更新或新增文档

#

除了错误修复和增量改进之外,我们还对本网站进行了以下更改:

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

Dart 博客新增文章

#

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

2020年10月1日:2.10 版本发布

#

本节列出了从 2020 年 7 月 1 日到 2020 年 10 月 1 日之间做出的显著更改。有关 2.10 版本的详细信息,请参阅 宣布 Dart 2.10

dart.dev 更新或新增文档

#

除了错误修复和小的改进之外,我们还对本网站进行了以下更改:

  • 添加了一个 dart 工具页面 来记录 Dart SDK 的新命令行界面。新的 dart 工具类似于 Flutter SDK 中的 flutter 工具。以前, dart 命令只运行命令行应用程序。我们相应地更新了之前的 dart 页面,并计划随着时间的推移更新对其他工具的引用。
  • 更新了 包变更日志文档 ,以推荐 CHANGELOG.md 文件的标准格式。这种新的格式允许工具(例如重新发布的 pub.dev)解析变更日志。
  • 更改了 Effective Dart 指南,以倾向于使用 Object 而不是 dynamic 。有关详细信息,请参阅修订后的指南 避免使用 dynamic ,除非您想禁用静态检查
  • 更新了 诊断消息页面 ,以包含 Dart 分析器生成的更多消息。
  • 更新了 演变页面 ,以包含 2.9 和 2.10。
  • 重新组织了 语言规范页面 ,以便更容易找到最新正在进行的规范的 PDF 版本。
  • 添加或更新了与 健全空安全 相关的文档,这是一个即将推出的 Dart 语言功能:

Dart 博客新增文章

#

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

我们还改进了博客导航,添加了 公告存档 选项卡,以及指向 dart.dev 的链接。