解决CARLA 0.9.13在Windows下的编译问题

问题背景

CARLA是一款开源的自动驾驶仿真平台，在Windows系统上编译0.9.13版本时，开发者可能会遇到两个主要错误：MSB1009项目文件不存在和C1083无法打开OSM2ODR.h头文件。这些问题通常出现在执行make PythonAPI命令时。

环境准备

在开始解决问题前，需要确认以下环境配置：

• 操作系统：Windows 10
• CARLA版本：0.9.13
• 开发工具：Visual Studio 2019
• Python版本：3.7.9

详细解决方案

1. 源码获取与初始配置

首先需要从GitHub获取CARLA 0.9.13的源代码压缩包，解压到合适的位置。这一步是后续所有操作的基础。

2. 修改Setup.bat文件

Setup.bat是CARLA构建过程中的关键脚本，需要进行以下修改：

1. 注释掉原版本检测行：

:: for /f %%i in ('git describe --tags --dirty --always') do set carla_version=%%i

2. 手动设置版本号：

set carla_version="0.9.13"

3. 添加库文件拷贝指令：

xcopy /Y /S /I "%INSTALLATION_DIR%\xerces-c-3.2.5-install\lib\xerces-c_3.lib" "%CARLA_PYTHON_DEPENDENCIES%\lib" > NUL
xcopy /Y /S /I "%INSTALLATION_DIR%\sqlite3-install\lib\sqlite3.lib" "%CARLA_PYTHON_DEPENDENCIES%\lib" > NUL
xcopy /Y /S /I "%INSTALLATION_DIR%\sproj-install\lib\proj.lib" "%CARLA_PYTHON_DEPENDENCIES%\lib" > NUL

3. 更新资源链接

在Update.bat中修改资源下载链接，确保能够正确获取依赖资源：

CONTENT_LINK=https://carla-assets.s3.us-east-005.backblazeb2.com/%CONTENT_ID%.tar.gz

4. 依赖库版本调整

CARLA构建过程中依赖多个第三方库，需要确保版本兼容性：

1. 修改zlib版本： 在install_zlib.bat中将ZLIB_VERSION设置为1.3.1

2. 修改xerces-c版本和下载源：

• 设置XERCESC_VERSION=3.2.5
• 更新XERCESC_REPO为新的下载地址

5. 关键构建脚本修改

BuildOSM2ODR.bat是生成OSM2ODR工具的关键脚本，需要调整以下参数：

-DXercesC_INCLUDE_DIR=%INSTALLATION_DIR:/=\%\xerces-c-3.2.5-install\include^
-DXercesC_LIBRARY=%INSTALLATION_DIR:/=\%\xerces-c-3.2.5-install\lib\xerces-c.lib^

构建流程

完成上述修改后，按照CARLA官方文档的构建流程执行：

1. 运行Update.bat获取必要资源
2. 执行Setup.bat配置环境
3. 运行make PythonAPI命令构建Python接口

技术原理分析

这些修改主要解决了以下技术问题：

1. 版本检测机制：原git命令可能无法在非git环境下工作，手动设置版本号确保构建系统能识别正确版本。

2. 依赖库路径：明确指定xerces-c等关键库的路径，解决头文件和库文件找不到的问题。

3. 资源下载：更新资源链接确保能获取到构建所需的资源文件。

4. 版本兼容性：调整依赖库版本以避免潜在的兼容性问题。

总结

通过上述步骤的系统性修改，可以有效解决CARLA 0.9.13在Windows平台上的编译问题。这些解决方案不仅适用于特定版本，其思路也可为其他版本的构建问题提供参考。在开源项目构建过程中，理解构建系统的运作机制和依赖关系是解决问题的关键。