TeamCity 中的 NUnit 支持

TeamCity 提供了自己的 NUnit 测试启动器，可以从命令行中使用。 根据传递的参数运行测试，如果该过程在 TeamCity 构建代理环境内运行，结果将报告给 TeamCity 代理。

您可以将以下命令行选项传递给 TeamCity NUnit 测试启动器：

这部分假设，您已经有一个配备了配置的 nunit2 任务的 NAnt 构建脚本，并希望 TeamCity 跟踪测试报告，而无需对现有的构建脚本进行任何更改。 否则，考虑在您的构建配置的步骤中添加 NUnit build runner 作为其中之一。

为了通过标准的 nunt2 任务跟踪在 NAnt 构建中定义的测试，TeamCity 提供了一个自定义的 任务 实现，并自动用其自身任务替换原始的 <nunit2> 任务。 当构建被触发时，TeamCity 会使用自己的实现启动 TeamCity NUnit 测试启动器，利用 <nunit2>。 这使您可以在不更改构建脚本的情况下，在 TeamCity 中实时接收测试报告。

如果您不希望 TeamCity 替换原始的 nunit2 任务，请考虑以下选项：

• 使用 NUnit 控制台与 TeamCity 的 NUnit 插件。

• 通过 XML 测试报告插件导入 XML 测试结果。

• 使用命令行 NUnit Test Launcher。

• 通过服务消息手动配置报告测试。

• 要禁用 nunit2 任务替换，请将 teamcity.dotnet.nant.replaceTasks 系统属性 设置为 false。

在 TeamCity 中， nunt2 任务实现支持额外选项，可以通过 NAnt <property> 任务在构建脚本中指定，或者在 构建配置 | 构建参数 下作为 系统属性 指定。

以下选项支持 TeamCity <nunit2> 任务实施：

TeamCity NUnit 测试启动器将在 NAnt 目标框架所指定的 .NET Framework 中运行测试，也就是说，运行在 .NET Framework 1.1、2.0 或 4.0 运行时环境中。 TeamCity 也支持对 <nunit2> 任务的测试类别。

将列出的属性添加到 NAnt 构建脚本中，使其依赖于 TeamCity。 为了避免这种情况，将属性指定为构建配置下的系统属性，或者考虑添加 <if> 任务。

示例

在 .NET 2.0 下，以 x64 模式从单个汇编文件开始测试。

运行分类 C1 下的所有测试，但不包括 C2。

明确指定 NUnit 的版本以运行测试。
请注意，在这种情况下，应在 nunit2 任务调用之前添加以下属性 。

此部分描述如何从 MSBuild 使用 NUnit。

• 对于 NUnit 在 3.0 版本之前

• 对于 NUnit 3.0 及以上版本

对于 MSBuild，TeamCity 提供了以下服务任务，实现了与 Build Script Interaction 相同的选项：

TeamCitySetBuildNumber 允许更改构建编号：

可以使用 {build.number} 作为旧版本号的占位符。

TeamCityProgressMessage 允许编写进度消息：

TeamCityPublishArtifacts 允许发布来自 MSBuild 项目组的所有制品：

TeamCityReportStatsValue 是一个用于发布统计值的便捷任务：

TeamCityBuildProblem 报告了一个实际上导致构建失败的构建问题。 建筑问题会出现在 Build Results 页面，并且还会影响建筑状态文本：

• 必须的 描述 属性是用人类可读的文本描述构建问题。 默认情况下， 描述 会出现在构建状态文本中。

• 身份 是一个可选属性，用于描述特定的构建问题实例。 如果出现相同问题，它在构建过程中不应有所变化：例如，相同的编译错误。 应为有效的 Java ID，最多可达60个字符长。 默认情况下， 身份 基于 描述 计算。

TeamCitySetStatus 是一个改变当前构建状态文本的任务。

{构建状态.text 被替换为了旧的状态文本。 状态可以具有 成功 值。

NUnit Add-in 是一个扩展程序，它插入到 NUnit 核心中并改变其运行方式。 请参阅 NUnit 插件页面 获取更多信息。 本节内容涵盖了 NAnt 、 MSBuild 和 NUnit Console Launcher 对 NUnit 插件支持的描述。

TeamCity NUnit 插件支持 NUnit 3.0 版本之前的版本。 对于后续版本，请参考 此部分。

如果您通过 NUnit console 运行 NUnit 测试，并希望 TeamCity 能够追踪测试结果，而无需启动 TeamCity 测试运行器，那么最佳的解决方案就是使用 TeamCity 的 NUnit 插件。 您可以将此插件接入 NUnit ，然后测试结果将自动报告给 TeamCity 服务器。

或者，您可以选择使用 XML 报告处理 构建功能，或者通过 服务消息 手动配置测试报告。

要在 TeamCity 中查看测试结果：

1. 在您的构建中，将 TeamCity 插件的路径设置为系统属性 teamcity.dotnet.nunitaddin （对于 MSBuild，应为 teamcity_dotnet_nunitaddin ），并在路径末尾添加 NUnit 的版本。 例如：

   • 对于 NUnit 2.4.X ，请使用 ${teamcity.dotnet.nunitaddin}-2.4.X.dll （对于 MSBuild ： $(teamcity_dotnet_nunitaddin)-2.4.X.dll）。
     例如 NUnit 2.4.7 ： NAnt：${teamcity.dotnet.nunitaddin}-2.4.7.dll， MSBuild ： $(teamcity_dotnet_nunitaddin)-2.4.7.dll。

   • 对于 NUnit 2.5.0 alpha 4，使用 ${teamcity.dotnet.nunitaddin}-2.5.0.dll （适用于 MSBuild： $(teamcity_dotnet_nunitaddin)-2.5.0.dll）。

2. 将 .dll 和 .pdb TeamCity 插件文件复制到 NUnit 插件目录中。

虽然您可以一次复制这些文件，但我们强烈建议配置您的构建，以便 每次构建 时都会将 TeamCity 插件文件复制到 NUnit 插件目录，因为这些文件可能会被 TeamCity 更新。

以下示例展示了如何在 MSBuild 上使用 NUnit console runner 和 TeamCity 的 NUnit 2.4.7 插件：

如果您需要明确地为 NUnit 配置 环境变量，请指定一个带有 %system.teamcity.dotnet.nunitaddin% 值引用的环境变量。 请参阅 此文章 以获取详细信息。

NUnit 2.4.8 问题
NUnit 2.4.8 存在以下已知问题：NUnit 2.4.8 运行器尝试根据创建的 AssemblyName 对象加载程序集。 然而，NUnit 2.4.8 的 插件 文件夹并未包含在应用程序探测路径中。 因此，NUnit 2.4.8 无法在控制台模式下加载任何插件。
为解决这个问题，我们建议您使用以下任何一种解决方法：

• 将 TeamCity 插件程序集复制到 NUnit bin 和 bin/addins 目录。

• 将补丁 NUnit-Console.exe.config 包含到应用程序探针路径中以添加插件。 将以下代码添加到 config/runtime 元素中：

  <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">       <probing privatePath="addins"/> </assemblyBinding>