如何在TFS Build中用同一构建定义实现跨平台多配置构建

我之前在维护TFS 2017构建的时候也碰到过一模一样的问题——想把Windows和Linux的CMake构建合并成一个定义，减少重复维护的麻烦，试了几个方案都可行，给你详细说说：

方案一：变量驱动的条件化构建步骤（最直接的实现） #

这个方案核心是用自定义变量+任务条件，让同一个构建定义根据不同平台参数，自动适配代理需求和构建命令：

• 1. 配置多值平台变量
     在构建定义的「变量」标签页，添加一个名为BuildPlatform的变量，设置允许的取值为Linux和Windows，勾选「多值」选项。这样触发构建时，TFS会自动为每个值生成一个独立的构建配置。
• 2. 为任务添加平台专属代理需求
     不要在构建定义的「选项」里设置全局代理需求，而是给每个任务（比如CMake配置、编译任务）单独添加条件化的代理要求：
  • 针对Windows平台的任务：添加需求 Agent.OS -equals Windows_NT，并设置任务的运行条件为 eq(variables['BuildPlatform'], 'Windows')
  • 针对Linux平台的任务：添加需求 Agent.OS -equals Linux，并设置任务的运行条件为 eq(variables['BuildPlatform'], 'Linux')
• 3. 适配CMake命令的平台差异
     用变量或者条件命令来处理不同平台的CMake生成器差异：
  • 比如在变量里新增CMakeGenerator，设置为「根据BuildPlatform的值动态赋值」：当BuildPlatform是Windows时，值为Visual Studio 15 2017 Win64；Linux时为Unix Makefiles
  • 然后CMake配置任务的命令写成：cmake -G "$(CMakeGenerator)" -DCMAKE_BUILD_TYPE=$(BuildConfiguration) ..
  • 或者直接用条件命令：如果是Windows就执行cmake -G "Visual Studio 15 2017 Win64" ..，Linux就执行cmake -G "Unix Makefiles" ..

方案二：用脚本自动适配平台（更简洁的维护方式） #

如果觉得设置一堆条件任务太繁琐，可以写一个跨平台的脚本（PowerShell或Bash，TFS 2017支持两种脚本任务），让脚本自动检测当前代理的操作系统，然后执行对应的构建逻辑：

# PowerShell脚本示例
if ($env:AGENT_OS -eq "Windows_NT") {
    # Windows平台CMake配置
    cmake -G "Visual Studio 15 2017 Win64" -DCMAKE_BUILD_TYPE=Release ..
    cmake --build . --config Release
} else {
    # Linux平台CMake配置
    cmake -G "Unix Makefiles" -DCMAKE_BUILD_TYPE=Release ..
    make -j$(nproc)
}

然后在构建定义里只需要添加一个脚本任务，不需要设置任何条件，脚本会自动处理平台差异。不过要确保代理池里同时有Windows和Linux代理，并且脚本任务设置为「在任何操作系统上运行」。

注意事项 #

• 确保你的TFS代理池里同时注册了Windows和Linux代理，这样多配置构建时，每个平台的任务能找到对应的代理执行
• 测试时先单独运行单个平台的配置验证逻辑，再触发多配置构建确保两个平台都能正常执行
• 如果需要区分构建产物，可以在变量里设置ArtifactPath，比如Windows下为$(Build.ArtifactStagingDirectory)/Windows，Linux下为$(Build.ArtifactStagingDirectory)/Linux，避免产物冲突

内容的提问来源于stack exchange，提问作者kuga