Windows Docker 镜像中构建 ROS2 工作空间时如何解决 VCTargetsPath 错误？

2024-03-02 13:56:10

在 Windows Docker 镜像中构建 ROS2 工作空间时解决 VCTargetsPath 错误

问题概述

在 Windows Docker 镜像中构建 ROS2 工作空间时，可能会遇到一个恼人的错误，它会阻碍 MSBuild 命令获取 VCTargetsPath。这个错误通常会以以下形式出现：

Failed to run MSBuild command to get the value of VCTargetsPath:

Exit code: 1

原因

此错误的根源在于无法使用 MSBuild 命令检索 VCTargetsPath 环境变量，该变量指向 Visual Studio 编译器工具的路径。

解决方法

为了解决此错误，需要修改 Dockerfile 以正确安装 Visual Studio 2019 构建工具并设置 VCTargetsPath 环境变量。

步骤 1：修改 Dockerfile 以安装 Visual Studio 2019 构建工具

添加以下命令到 Dockerfile 中：

RUN wget --no-verbose https://aka.ms/vs/16/release/vs_buildtools.exe
RUN start /w vs_buildtools.exe --quiet --wait --norestart --nocache \
        --installPath "%ProgramFiles(x86)%\Microsoft Visual Studio\2019\BuildTools" \
        --add Microsoft.VisualStudio.Workload.NativeDesktop \
        --add Microsoft.VisualStudio.Component.Debugger.JustInTime \
        --add Microsoft.VisualStudio.Component.VC.v141.x86.x64 \
        --add Microsoft.VisualStudio.Component.VC.DiagnosticTools \
        --add Microsoft.VisualStudio.Component.Windows10SDK.17134 \
        --add Microsoft.VisualStudio.Component.VC.ATL \
        --add Microsoft.VisualStudio.Component.VC.TestAdapterForBoostTest \
        --add Microsoft.VisualStudio.Component.VC.TestAdapterForGoogleTest \
        --add Microsoft.VisualStudio.Component.VC.Llvm.Clang \
        --add Microsoft.VisualStudio.Component.VC. CMakeGenerator \
        || IF "%ERRORLEVEL%"=="3010" EXIT 0
RUN del /q vs_buildtools.exe

这将下载并安装 Visual Studio 2019 构建工具，包括 CMake 生成器组件。

步骤 2：修改 Dockerfile 以设置 VCTargetsPath

接下来，添加以下命令：

RUN setx /m PATH "%PATH%;C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Tools\MSVC\14.16.27023\bin\HostX64\x64"
RUN setx /m VCTargetsPath "C:\Program Files (x86)\Microsoft Visual Studio\2019\BuildTools\VC\Tools\MSVC\14.16.27023"

这将把 VCTargetsPath 环境变量设置为 Visual Studio 编译器工具的正确路径。