文档

支持

单元测试

Enable and configure unit tests in Unity Build Automation to catch issues early and ensure code quality.
阅读时间3 分钟最后更新于 1 个月前

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 单元测试视图

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