1. 项目概述最近在Ubuntu 22.04系统上从源码编译CARLA 0.9.16版本时踩了不少坑也积累了一些经验。CARLA作为开源的自动驾驶仿真平台在科研和工业界都有广泛应用但官方文档对特定版本的编译说明往往不够详细。本文将详细记录整个编译过程包括环境准备、依赖安装、源码编译和常见问题解决。2. 环境准备2.1 系统要求首先需要确保系统满足CARLA 0.9.16的基本要求Ubuntu 22.04 LTS建议全新安装至少16GB内存32GB更佳100GB可用磁盘空间NVIDIA显卡至少6GB显存安装最新版NVIDIA驱动注意虽然CARLA官方推荐Ubuntu 18.04/20.04但在22.04上也能成功编译只是需要额外处理一些依赖问题。2.2 基础环境配置更新系统并安装基础工具包sudo apt update sudo apt upgrade -y sudo apt install -y git cmake build-essential wget unzip安装Python环境CARLA 0.9.16需要Python 2.7sudo apt install -y python2.7 python-pip sudo update-alternatives --install /usr/bin/python python /usr/bin/python2.7 13. 依赖安装3.1 安装Unreal Engine 4.26CARLA 0.9.16需要Unreal Engine 4.26版本支持注册Epic Games账号并关联GitHub账号克隆Unreal Engine源码git clone --depth1 -b 4.26 https://github.com/EpicGames/UnrealEngine.git ~/UnrealEngine编译Unreal Enginecd ~/UnrealEngine ./Setup.sh ./GenerateProjectFiles.sh make这个过程可能需要数小时取决于硬件配置。3.2 安装CARLA依赖安装CARLA编译所需依赖sudo apt install -y \ clang-8 lld-8 g-8 \ libomp5-8 libomp-8-dev \ libpng-dev libtiff5-dev libjpeg-dev \ libzmq3-dev libboost-all-dev \ libgl1-mesa-dev libglu1-mesa-dev \ libxerces-c-dev libproj-dev \ libode-dev libfreetype6-dev \ libssl-dev libxml2-dev \ libgtest-dev libeigen3-dev设置默认编译器为clang-8sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-8 100 sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-8 1004. 源码编译CARLA4.1 获取源码克隆CARLA 0.9.16版本源码git clone --depth1 -b 0.9.16 https://github.com/carla-simulator/carla.git ~/carla4.2 编译CARLA设置Unreal Engine路径export UE4_ROOT~/UnrealEngine更新子模块cd ~/carla git submodule update --init编译CARLAmake launch首次编译会下载大量依赖可能需要数小时。编译完成后会自动启动UE4编辑器。4.3 编译PythonAPICARLA提供了Python接口需要单独编译make PythonAPI编译完成后PythonAPI会安装在~/carla/PythonAPI/carla/dist目录下。5. 常见问题与解决方案5.1 编译错误Unreal Engine版本不匹配错误信息FATAL: This version of CARLA requires Unreal Engine 4.26解决方案确保安装的是Unreal Engine 4.26版本检查UE4_ROOT环境变量设置是否正确5.2 错误clang版本问题错误信息error: invalid argument -stdc14 not allowed with C解决方案确保使用clang-8作为默认编译器检查update-alternatives设置是否正确5.3 错误Python版本冲突错误信息ImportError: No module named carla解决方案确保使用Python 2.7环境将CARLA PythonAPI添加到PYTHONPATHexport PYTHONPATH$PYTHONPATH:~/carla/PythonAPI/carla/dist/carla-0.9.16-py2.7-linux-x86_64.egg5.4 性能优化建议使用ccache加速编译sudo apt install -y ccache export PATH/usr/lib/ccache:$PATH增加make并行编译线程数根据CPU核心数调整make launch -j$(nproc)6. 测试CARLA运行编译完成后可以通过以下命令测试CARLA是否正常运行启动服务端cd ~/carla ./CarlaUE4.sh -quality-levelLow运行Python客户端示例import carla client carla.Client(localhost, 2000) world client.get_world() print(world.get_actors())7. 后续开发建议建议使用Python虚拟环境管理依赖virtualenv -p python2.7 carla-env source carla-env/bin/activate对于自动驾驶开发可以安装CARLA的ROS桥接git clone https://github.com/carla-simulator/ros-bridge.git考虑使用Docker容器化部署便于环境管理和团队协作
1. 项目概述最近在Ubuntu 22.04系统上从源码编译CARLA 0.9.16版本时踩了不少坑也积累了一些经验。CARLA作为开源的自动驾驶仿真平台在科研和工业界都有广泛应用但官方文档对特定版本的编译说明往往不够详细。本文将详细记录整个编译过程包括环境准备、依赖安装、源码编译和常见问题解决。2. 环境准备2.1 系统要求首先需要确保系统满足CARLA 0.9.16的基本要求Ubuntu 22.04 LTS建议全新安装至少16GB内存32GB更佳100GB可用磁盘空间NVIDIA显卡至少6GB显存安装最新版NVIDIA驱动注意虽然CARLA官方推荐Ubuntu 18.04/20.04但在22.04上也能成功编译只是需要额外处理一些依赖问题。2.2 基础环境配置更新系统并安装基础工具包sudo apt update sudo apt upgrade -y sudo apt install -y git cmake build-essential wget unzip安装Python环境CARLA 0.9.16需要Python 2.7sudo apt install -y python2.7 python-pip sudo update-alternatives --install /usr/bin/python python /usr/bin/python2.7 13. 依赖安装3.1 安装Unreal Engine 4.26CARLA 0.9.16需要Unreal Engine 4.26版本支持注册Epic Games账号并关联GitHub账号克隆Unreal Engine源码git clone --depth1 -b 4.26 https://github.com/EpicGames/UnrealEngine.git ~/UnrealEngine编译Unreal Enginecd ~/UnrealEngine ./Setup.sh ./GenerateProjectFiles.sh make这个过程可能需要数小时取决于硬件配置。3.2 安装CARLA依赖安装CARLA编译所需依赖sudo apt install -y \ clang-8 lld-8 g-8 \ libomp5-8 libomp-8-dev \ libpng-dev libtiff5-dev libjpeg-dev \ libzmq3-dev libboost-all-dev \ libgl1-mesa-dev libglu1-mesa-dev \ libxerces-c-dev libproj-dev \ libode-dev libfreetype6-dev \ libssl-dev libxml2-dev \ libgtest-dev libeigen3-dev设置默认编译器为clang-8sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-8 100 sudo update-alternatives --install /usr/bin/clang clang /usr/bin/clang-8 1004. 源码编译CARLA4.1 获取源码克隆CARLA 0.9.16版本源码git clone --depth1 -b 0.9.16 https://github.com/carla-simulator/carla.git ~/carla4.2 编译CARLA设置Unreal Engine路径export UE4_ROOT~/UnrealEngine更新子模块cd ~/carla git submodule update --init编译CARLAmake launch首次编译会下载大量依赖可能需要数小时。编译完成后会自动启动UE4编辑器。4.3 编译PythonAPICARLA提供了Python接口需要单独编译make PythonAPI编译完成后PythonAPI会安装在~/carla/PythonAPI/carla/dist目录下。5. 常见问题与解决方案5.1 编译错误Unreal Engine版本不匹配错误信息FATAL: This version of CARLA requires Unreal Engine 4.26解决方案确保安装的是Unreal Engine 4.26版本检查UE4_ROOT环境变量设置是否正确5.2 错误clang版本问题错误信息error: invalid argument -stdc14 not allowed with C解决方案确保使用clang-8作为默认编译器检查update-alternatives设置是否正确5.3 错误Python版本冲突错误信息ImportError: No module named carla解决方案确保使用Python 2.7环境将CARLA PythonAPI添加到PYTHONPATHexport PYTHONPATH$PYTHONPATH:~/carla/PythonAPI/carla/dist/carla-0.9.16-py2.7-linux-x86_64.egg5.4 性能优化建议使用ccache加速编译sudo apt install -y ccache export PATH/usr/lib/ccache:$PATH增加make并行编译线程数根据CPU核心数调整make launch -j$(nproc)6. 测试CARLA运行编译完成后可以通过以下命令测试CARLA是否正常运行启动服务端cd ~/carla ./CarlaUE4.sh -quality-levelLow运行Python客户端示例import carla client carla.Client(localhost, 2000) world client.get_world() print(world.get_actors())7. 后续开发建议建议使用Python虚拟环境管理依赖virtualenv -p python2.7 carla-env source carla-env/bin/activate对于自动驾驶开发可以安装CARLA的ROS桥接git clone https://github.com/carla-simulator/ros-bridge.git考虑使用Docker容器化部署便于环境管理和团队协作
