Dart 测试

软件测试是应用开发的重要组成部分，它有助于在发布应用之前验证应用是否正常工作。本 Dart 测试指南概述了几种测试类型，并指引您了解如何测试您的 Flutter、Web 和 服务器端应用和脚本。

您可以使用 dart test 命令（或对于 Flutter 应用，使用 flutter test）在命令行上运行测试。

Dart 测试文档重点介绍三种测试类型，它们来自您可能熟悉的 众多测试类型：单元测试、组件测试和端到端测试（一种集成测试）。测试术语各不相同，但这些是在使用 Dart 技术时您可能会遇到的术语和概念。

• 单元测试侧重于验证可测试软件的最小单元，例如函数、方法或类。您的测试套件应该包含比其他类型的测试更多的单元测试。

• 组件测试（在 Flutter 中称为widget测试）验证组件（通常由多个类组成）的行为是否符合预期。组件测试通常需要使用模拟对象，这些对象可以模拟用户操作、事件、执行布局并实例化子组件。

• 集成和端到端测试验证整个应用或应用的大块部分的行为。集成测试通常在模拟或真实设备或浏览器（对于 Web）上运行，并由两部分组成：应用本身以及对应用进行测试的测试应用。集成测试通常会衡量性能，因此测试应用通常在与被测应用不同的设备或操作系统上运行。

尽管您的测试部分取决于您的代码的目标平台（例如 Flutter、Web 或服务器端），但以下包在各个 Dart 平台上都很有用。

• package:test
  提供了一种在 Dart 中编写测试的标准方法。您可以使用 test 包来

  • 编写单个测试或测试组。
  • 使用 @TestOn 注解将测试限制在特定环境中运行。
  • 编写异步测试，就像编写同步测试一样。
  • 使用 @Tag 注解标记测试。例如，定义一个标记来为某些测试创建自定义配置，或将某些测试识别为需要更多时间才能完成。
  • 创建一个 dart_test.yaml 文件以跨多个文件或整个包配置标记的测试。

• package:mockito
  提供了一种创建 模拟对象 的方法，这些对象易于配置以用于固定场景，并验证被测系统是否以预期的方式与模拟对象交互。有关同时使用 package:test 和 package:mockito 的示例，请参阅 国际空间站 API 库及其单元测试（位于 mockito 包 中）。

使用以下资源来详细了解如何测试 Flutter 应用。

• 测试 Flutter 应用
  如何在 Flutter 应用上执行单元测试、widget 测试或集成测试。
• flutter_test
  一个基于 package:test 构建的 Flutter 测试库。
• flutter_driver
  一个用于在真实设备和模拟器上（在单独的进程中）测试 Flutter 应用的测试库。
• flutter_gallery
  Flutter 库示例的源代码和测试。
• flutter/dev/manual_tests
  Flutter SDK 中的许多测试示例。

您可能会发现以下资源对于开发和调试 Dart 应用也很有用。

在调试方面，您的第一道防线是您的 IDE。许多 常用的 IDE 都存在 Dart 插件。

Dart DevTools 是一套用于 Dart 和 Flutter 的性能工具。有关详细信息，请参阅 Dart DevTools 文档。

考虑使用持续集成 (CI) 在每次提交后构建您的项目并运行其测试。GitHub 的两个 CI 服务是 GitHub Actions 和 AppVeyor。

详细了解 GitHub Actions

• 使用 GitHub Actions 测试 Dart 包 演示了一个使用 GitHub Actions 测试 Flutter 应用或 Dart 包的简单工作流。
• Dart 团队提供的许多包都使用 GitHub Actions。例如，请参阅 markdown 包的存储库中的 test-package.yml。若要了解该存储库如何从 Travis CI 迁移到 GitHub Actions，请查看 PR #353。

除非另有说明，否则本网站上的文档反映的是 Dart 3.5.3。页面上次更新于 2024-04-11。 查看源代码 或 报告问题。