保姆级教程：在Ubuntu 20.04上从源码编译Autoware.universe (ROS2 Galactic) 的完整避坑指南

从零构建Autoware.universe开发环境Ubuntu 20.04与ROS2 Galactic深度避坑指南自动驾驶开发环境的搭建往往充满挑战特别是当涉及到复杂的开源框架如Autoware.universe时。本文将带您一步步完成从系统准备到最终编译的完整流程特别针对Ubuntu 20.04和ROS2 Galactic这一常见组合中可能遇到的各类问题提供解决方案。1. 系统环境准备在开始安装Autoware.universe之前确保您的系统环境已经正确配置。Ubuntu 20.04 LTS是最稳定的选择因为它与ROS2 Galactic有最佳的兼容性。首先更新系统基础软件包sudo apt update sudo apt upgrade -y接下来安装一些基础开发工具sudo apt install -y build-essential cmake git python3-pip python3-rosdep python3-colcon-common-extensions重要提示Autoware.universe对CUDA有特定要求。我们推荐安装CUDA 11.6版本wget https://developer.download.nvidia.com/compute/cuda/11.6.2/local_installers/cuda_11.6.2_510.47.03_linux.run sudo sh cuda_11.6.2_510.47.03_linux.run安装完成后将CUDA路径添加到环境变量中echo export PATH/usr/local/cuda-11.6/bin:$PATH ~/.bashrc echo export LD_LIBRARY_PATH/usr/local/cuda-11.6/lib64:$LD_LIBRARY_PATH ~/.bashrc source ~/.bashrc2. ROS2 Galactic安装与配置Autoware.universe需要ROS2 Galactic作为基础环境。以下是安装步骤sudo apt install -y software-properties-common sudo add-apt-repository universe sudo apt update sudo apt install -y curl gnupg lsb-release sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg echo deb [arch$(dpkg --print-architecture) signed-by/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main | sudo tee /etc/apt/sources.list.d/ros2.list /dev/null sudo apt update sudo apt install -y ros-galactic-desktop安装完成后初始化rosdepsudo rosdep init rosdep update3. Autoware.universe源码获取与依赖安装现在我们可以获取Autoware.universe的源代码。建议使用gitcode镜像源速度更快git clone https://gitcode.com/gh_mirrors/au/autoware.git -b galactic cd autoware安装依赖项前先设置环境变量source /opt/ros/galactic/setup.bash ./setup.env.sh然后使用rosdep安装依赖rosdep install -y --from-paths src --ignore-src --rosdistro galactic4. 常见编译错误及解决方案在编译过程中您可能会遇到各种依赖缺失的问题。以下是常见错误及其解决方案4.1 系统库缺失错误示例fatal error: pcap.h: 没有那个文件或目录解决方案sudo apt-get install libpcap-dev4.2 ROS包缺失错误示例fatal error: can_msgs/msg/frame.hpp: 没有那个文件或目录解决方案sudo apt-get install ros-galactic-can-msgs4.3 CUDA相关错误错误示例CMake Error: Could not find a package configuration file provided by cudnn_cmake_module解决方案sudo apt-get install ros-galactic-cudnn-cmake-module4.4 特殊依赖项错误示例fatal error: GeographicLib/Geoid.hpp: 没有那个文件或目录解决方案sudo apt-get install libgeographic-dev5. 编译与测试当所有依赖问题解决后可以开始编译colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPERelease编译完成后测试环境是否正常工作source install/setup.bash ros2 launch autoware_launch logging_simulator.launch.xml6. 高级问题排查即使完成了上述步骤仍可能遇到一些棘手问题。以下是几个高级问题的解决方案6.1 Python包冲突问题AttributeError: module importlib_metadata has no attribute EntryPoints解决方案pip install --upgrade importlib-metadata6.2 库文件路径问题问题没有规则可制作目标/usr/lib//libnvparsers.so解决方案locate libnvparsers.so cp -r /usr/lib/x86_64-linux-gnu/libcudnn.so.8.4.1 /usr/local/cuda-11.6/targets/x86_64-linux/lib/6.3 特殊ROS包需求问题Could not find a package configuration file provided by osqp解决方案sudo apt install ros-galactic-osqp-vendor7. 环境优化与维护为了保持开发环境的稳定性建议定期执行以下维护操作更新系统包sudo apt update sudo apt upgrade清理编译缓存rm -rf build install log重新编译时使用colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPERelease --parallel-workers 4监控系统资源使用情况确保编译过程不会因内存不足而失败。在实际开发中Autoware.universe的环境搭建可能会因硬件配置、网络环境等因素而有所不同。建议在遇到问题时首先检查错误日志然后根据错误信息搜索解决方案。大多数常见问题都可以在Autoware的GitHub issue页面找到答案。