Azure DevOps Windows代理中qmake使用INSTALL_ROOT报错求助

问题描述 #

我有一个Qt 5.15项目，在Azure DevOps Pipelines的自托管Windows代理上通过qmake构建，构建及安装步骤脚本如下：

- script: |
    call C:\"Program Files (x86)\"\"Microsoft Visual Studio\"\2019\Community\VC\Auxiliary\Build\vcvarsall.bat amd64
    call qmake $(Build.SourcesDirectory)
    call jom
    call jom install
  workingDirectory: $(Build.BinariesDirectory)
  env:
    INSTALL_ROOT: $(Build.ArtifactStagingDirectory)

由于vcvarsall.bat无法在PowerShell中运行，故使用script任务。执行jom install时出现错误：

The filename, directory name, or volume label syntax is incorrect.

已完成以下排查操作：

• 验证env属性中INSTALL_ROOT已正确设置；
• 尝试在脚本步骤中添加call set INSTALL_ROOT=$(Build.ArtifactStagingDirectory)，错误未改变；
• 在同一代理的cmd.exe及bat文件中执行相同命令，安装正常。

移除INSTALL_ROOT环境变量后安装成功，但路径不符合要求。请问如何让DevOps Windows代理完成正确路径的安装任务？

解决方法 #

1. 给INSTALL_ROOT路径添加引号 #

Azure DevOps环境变量展开后若包含空格，直接传递会导致路径被拆分引发语法错误。可以在脚本里用set "VAR=VALUE"的方式显式设置带引号的路径，确保空格被正确识别：

- script: |
    call C:\"Program Files (x86)\"\"Microsoft Visual Studio\"\2019\Community\VC\Auxiliary\Build\vcvarsall.bat amd64
    set "INSTALL_ROOT=$(Build.ArtifactStagingDirectory)"
    call qmake $(Build.SourcesDirectory)
    call jom
    call jom install
  workingDirectory: $(Build.BinariesDirectory)

2. 检查Qt项目.pro文件的路径引用 #

确认项目.pro文件中对INSTALL_ROOT的拼接逻辑正确，若路径包含空格，需给目标路径添加引号：

isEmpty(INSTALL_ROOT): INSTALL_ROOT = $$PWD/install
target.path = "$$INSTALL_ROOT/bin"
INSTALLS += target

3. 改用独立batch脚本执行 #

把构建命令写入单独的.bat文件并提交到代码库，通过Azure DevOps任务调用该脚本，避免直接在script任务中处理复杂的变量展开：
创建build_install.bat：

@echo off
call C:\"Program Files (x86)\"\"Microsoft Visual Studio\"\2019\Community\VC\Auxiliary\Build\vcvarsall.bat amd64
set "INSTALL_ROOT=%1"
call qmake %2
call jom
call jom install

Azure DevOps任务配置：

- script: build_install.bat "$(Build.ArtifactStagingDirectory)" "$(Build.SourcesDirectory)"
  workingDirectory: $(Build.BinariesDirectory)

4. 验证环境变量实际值 #

在脚本中添加echo命令，确认INSTALL_ROOT的实际展开结果，排查是否存在变量未正确解析或路径异常：

- script: |
    call C:\"Program Files (x86)\"\"Microsoft Visual Studio\"\2019\Community\VC\Auxiliary\Build\vcvarsall.bat amd64
    set INSTALL_ROOT=$(Build.ArtifactStagingDirectory)
    echo INSTALL_ROOT实际值: %INSTALL_ROOT%
    call qmake $(Build.SourcesDirectory)
    call jom
    call jom install
  workingDirectory: $(Build.BinariesDirectory)

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