MSBuild
这个页面包含有关 MSBuild 构建运行者字段的参考信息。
MSBuild 运行器需要在构建代理上安装 .NET Framework 或 Mono。 Microsoft Build Tools 2013-2019 均得到支持。
在设置构建配置以使用 MSBuild 作为构建运行程序之前,请确保您正在使用带有 MSBuild 运行器的 XML 构建项目文件。
要构建 Microsoft Visual Studio 解决方案文件,您可以使用 Visual Studio (sln) 构建运行程序。
设置
选项 | 描述 |
---|---|
构建文件路径 | 指定要构建的解决方案的路径,相对于 build checkout directory。 例如, |
工作目录 | 可选. 如果 构建工作目录 的路径与构建检出目录的路径不同,您需要指定其路径。 |
MSBuild 版本 | 选择 MSBuild 版本:.NET Framework,Mono xbuild 或 Microsoft Build Tools。 |
MSBuild ToolsVersion | 在这里指定将用于编译的工具的版本(等同于 |
运行平台 | 从下拉菜单中,选择在 x64 机器上想要的执行模式。 |
目标 | 目标是为您的项目目的设定的任意脚本。 请输入由空格分隔的目标。 可用的目标可以通过点击字段旁边的图标在 Web UI 中查看,并通过勾选适当的框来添加。 |
命令行形参 | 为 |
缩短测试失败反馈时间 | 使用此选项指示 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" />
在构建日志的标准输出流中打印文本。