文档

支持

Build Automation

DevOps

Build Automation REST API

Build Automation Editor Package

Open Unity Dashboard

Build Automation

单元测试

Enable and configure unit tests in Unity Build Automation to catch issues early and ensure code quality.
阅读时间3 分钟最后更新于 19 天前
在 Build Target（构建目标） 配置中启用单元测试可以尽早发现问题，确保代码质量，并在部署前防止出现回归问题。Unity Build Automation (UBA) 提供集成支持，将运行单元测试作为构建过程的一部分。UBA 支持 Edit Mode（编辑模式） 和 Play Mode（运行模式） 测试，并提供了控制测试执行和处理失败情况的选项。 有关编辑模式和运行模式测试的更多信息，请参阅 Unity 编辑器手册。

启用单元测试

在 Unity Dashboard 中启用和配置单元测试：
  1. 选择 Build Automation > Configurations（配置）。
  2. 选择编辑（铅笔）图标以打开构建目标设置。
  3. 选择 Advanced Settings（高级设置）。
  4. 在 Tests（测试） 部分下，选择要启用的测试选项。
  5. 选择 Save changes（保存更改）。
如果在启用测试时遇到问题，请确保正确设置了项目的测试程序集，并且将脚本放在合适的目录中，例如 
Assets/Tests
。在 UBA 中运行构建之前，使用 Unity 编辑器的 Test Runner 来验证是否检测到了测试。

测试配置选项

以下是可用的测试选项：

测试配置选项

描述

Run my project's unit tests when building（构建时运行项目的单元测试）当您运行构建时，单元测试将运行。
Run EditMode tests（运行编辑模式测试）当您运行构建时，编辑模式测试将运行。
Run PlayMode tests（进行运行模式测试）当您运行构建时，运行模式测试将运行。
Mark build as failed if any test fails（如果任何测试失败，则将构建标记为失败）UBA 会将任何未通过单元测试套件的构建标记为失败，即使构建在其他情况下成功也是如此。

访问和查看测试结果

UBA 在构建日志和 Artifact 中提供测试结果。构建完成后：
  1. 导航到 Unity Dashboard 中的 Build History（构建历史记录）部分。
  2. 选择已完成的构建以查看其详细信息。
  3. 查看测试摘要，以查找通过、失败和跳过的测试数量。
  4. 下载详细的测试报告以进行深入分析。
UBA 单元测试视图

UBA 单元测试视图

如果测试结果缺失或不完整，请检查以下解决方案：
  • 检查构建日志中是否有与测试执行相关的警告或错误。
  • 检查是否正确标记了测试并将其放置在已识别的测试文件夹中。