TeamCity On-Premises 2024.03 Help

MSBuild

这个页面包含有关 MSBuild 构建运行者字段的参考信息。

MSBuild 运行器需要在构建代理上安装 .NET Framework 或 Mono。 Microsoft Build Tools 2013-2019 均得到支持。

在设置构建配置以使用 MSBuild 作为构建运行程序之前,请确保您正在使用带有 MSBuild 运行器的 XML 构建项目文件。

要构建 Microsoft Visual Studio 解决方案文件,您可以使用 Visual Studio (sln) 构建运行程序。

设置

选项

描述

构建文件路径

指定要构建的解决方案的路径,相对于 build checkout directory。 例如, vs-addin\addin\addin.sln

工作目录

可选. 如果 构建工作目录 的路径与构建检出目录的路径不同,您需要指定其路径。

MSBuild 版本

选择 MSBuild 版本:.NET Framework,Mono xbuild 或 Microsoft Build Tools。

MSBuild ToolsVersion

在这里指定将用于编译的工具的版本(等同于 /toolsversion: 命令行参数)。

运行平台

从下拉菜单中,选择在 x64 机器上想要的执行模式。

目标

目标是为您的项目目的设定的任意脚本。 请输入由空格分隔的目标。 可用的目标可以通过点击字段旁边的图标在 Web UI 中查看,并通过勾选适当的框来添加。

命令行形参

MSBuild.exe。 指定任何额外的参数

缩短测试失败反馈时间

使用此选项指示 TeamCity 在其它构建之前运行在之前的构建中失败的测试。

Code Coverage(代码覆盖率)

要了解如何配置代码覆盖率选项,请参考 配置 .NET 代码覆盖率 页面。

实施注意事项

MSBuild 运行器会生成一个包含用户脚本的 MSBuild 脚本。 这个脚本用于添加 TeamCity 提供的 MSBuild 任务。 您的 MSBuild 脚本将会包含在 <Import> 任务中。 如果您指定了一个 Visual Studio 解决方案文件,它将被<MSBuild>任务调用。 要禁用它,请将 teamcity.msbuild.generateWrappingScript 内部属性 设置为 false

由于此运行器已被弃用,它不再支持一些遗留工具,如 MSBuildBootstrap。 要在构建中执行自定义任务,请考虑使用 TeamCity 服务消息。 例如,使用 <Message Text="##teamcity[buildNumber '1.2.3']" Importance="high" /> 在构建日志的标准输出流中打印文本。

最后修改日期: 16日 7月 2024年