单元测试
Enable and configure unit tests in Unity Build Automation to catch issues early and ensure code quality.
阅读时间4 分钟最后更新于 10 个月前
在 Build Target（构建目标） 配置中启用单元测试可以尽早发现问题，确保代码质量，并在部署前防止出现回归问题。Unity Build Automation (UBA) 提供集成支持，将运行单元测试作为构建过程的一部分。UBA 支持 Edit Mode（编辑模式） 和 Play Mode（运行模式） 测试，并提供了控制测试执行和处理失败情况的选项。
有关编辑模式和运行模式测试的更多信息，请参阅 Unity 编辑器手册。
启用单元测试
在 Unity Dashboard 中启用和配置单元测试：
- 选择 Build Automation > Configurations（配置）。
- 选择编辑（铅笔）图标以打开构建目标设置。
- 选择 Advanced Settings（高级设置）。
- 在 Tests（测试） 部分下，选择要启用的测试选项。
- 选择 Save changes（保存更改）。
如果在启用测试时遇到问题，请确保正确设置了项目的测试程序集，并且将脚本放在合适的目录中，例如 。在 UBA 中运行构建之前，使用 Unity 编辑器的 Test Runner 来验证是否检测到了测试。
Assets/Tests测试配置选项
以下是可用的测试选项：
测试配置选项 | 描述 |
|---|---|
| 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 中提供测试结果。构建完成后：
- 导航到 Unity Dashboard 中的 Build History（构建历史记录）部分。
- 选择已完成的构建以查看其详细信息。
- 查看测试摘要，以查找通过、失败和跳过的测试数量。
- 下载详细的测试报告以进行深入分析。
UBA 单元测试视图
如果测试结果缺失或不完整，请检查以下解决方案：
- 检查构建日志中是否有与测试执行相关的警告或错误。
- 检查是否正确标记了测试并将其放置在已识别的测试文件夹中。
注意
注意： 如果测试意外失败，请查看最近的代码更改，并确认您正确配置了所有依赖项，例如场景或资源。