ROS2 Jazzy尝鲜指南：在Ubuntu 24.04上从安装到跑通第一个Demo（附常见错误修复）

ROS2 Jazzy尝鲜指南在Ubuntu 24.04上从安装到跑通第一个DemoUbuntu 24.04 LTS的发布带来了全新的ROS2 Jazzy版本这对机器人开发者来说无疑是一次令人兴奋的技术升级。作为长期支持版本Jazzy将在未来五年内获得官方维护这意味着开发者可以基于这个稳定平台构建长期项目。本文将带你从零开始在全新的Ubuntu 24.04系统上完成ROS2 Jazzy的安装、配置并最终运行一个简单的发布/订阅Demo。1. 系统准备与环境配置在开始安装ROS2之前我们需要确保Ubuntu 24.04系统已经做好充分准备。新版本的Ubuntu带来了一些底层库的变化这可能会影响到ROS2的安装过程。首先更新系统软件包sudo apt update sudo apt upgrade -yUbuntu 24.04默认使用Python 3.12这与之前的ROS2版本有所不同。我们需要确认系统中安装了必要的编译工具和依赖sudo apt install -y \ build-essential \ git \ python3-pip \ python3-venv \ python3-dev \ cmake \ curl \ gnupg \ lsb-release注意Ubuntu 24.04中某些系统库的版本较新可能会导致与ROS2包的兼容性问题。如果遇到依赖冲突可以考虑使用apt-cache policy命令检查具体版本。2. ROS2 Jazzy安装详解不同于一键安装脚本我们将采用官方推荐的分步安装方式这能帮助我们更好地理解安装过程并解决可能出现的问题。2.1 设置软件源首先添加ROS2的GPG密钥和APT源sudo mkdir -p /usr/share/keyrings curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key | sudo gpg --dearmor -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 update2.2 安装ROS2桌面版ROS2 Jazzy提供了多个变体对于大多数开发者来说桌面完整版是最佳选择sudo apt install -y ros-jazzy-desktop安装完成后建议同时安装一些常用的开发工具sudo apt install -y \ python3-colcon-common-extensions \ ros-dev-tools \ python3-rosdep2.3 配置rosdeprosdep是ROS中用于管理系统依赖的工具正确配置它非常重要sudo rosdep init rosdep update如果在更新过程中遇到网络问题可以尝试使用国内镜像源export ROSDISTRO_INDEX_URLhttps://mirrors.tuna.tsinghua.edu.cn/rosdistro/index-v4.yaml rosdep update3. 环境变量与工作区设置安装完成后需要设置环境变量才能使ROS2命令正常工作。将以下内容添加到~/.bashrc文件末尾source /opt/ros/jazzy/setup.bash然后重新加载bash配置source ~/.bashrc验证安装是否成功ros2 --help如果看到帮助信息输出说明ROS2已正确安装。接下来创建一个工作区mkdir -p ~/ros2_ws/src cd ~/ros2_ws colcon build4. 创建并运行第一个ROS2节点让我们创建一个简单的发布/订阅Demo来验证ROS2是否正常工作。4.1 创建Python包在工作区的src目录下创建新包cd ~/ros2_ws/src ros2 pkg create --build-type ament_python my_first_package4.2 编写发布者节点编辑my_first_package/my_first_package/publisher.pyimport rclpy from rclpy.node import Node from std_msgs.msg import String class MinimalPublisher(Node): def __init__(self): super().__init__(minimal_publisher) self.publisher_ self.create_publisher(String, topic, 10) timer_period 0.5 self.timer self.create_timer(timer_period, self.timer_callback) self.i 0 def timer_callback(self): msg String() msg.data Hello World: %d % self.i self.publisher_.publish(msg) self.get_logger().info(Publishing: %s % msg.data) self.i 1 def main(argsNone): rclpy.init(argsargs) minimal_publisher MinimalPublisher() rclpy.spin(minimal_publisher) minimal_publisher.destroy_node() rclpy.shutdown() if __name__ __main__: main()4.3 编写订阅者节点编辑my_first_package/my_first_package/subscriber.pyimport rclpy from rclpy.node import Node from std_msgs.msg import String class MinimalSubscriber(Node): def __init__(self): super().__init__(minimal_subscriber) self.subscription self.create_subscription( String, topic, self.listener_callback, 10) self.subscription def listener_callback(self, msg): self.get_logger().info(I heard: %s % msg.data) def main(argsNone): rclpy.init(argsargs) minimal_subscriber MinimalSubscriber() rclpy.spin(minimal_subscriber) minimal_subscriber.destroy_node() rclpy.shutdown() if __name__ __main__: main()4.4 修改package.xml和setup.py确保package.xml中包含以下依赖exec_dependrclpy/exec_depend exec_dependstd_msgs/exec_depend在setup.py中注册新节点entry_points{ console_scripts: [ publisher my_first_package.publisher:main, subscriber my_first_package.subscriber:main, ], },4.5 构建并运行构建包cd ~/ros2_ws colcon build --packages-select my_first_package source install/setup.bash在三个不同的终端中分别运行# 终端1 ros2 run my_first_package publisher # 终端2 ros2 run my_first_package subscriber # 终端3 ros2 topic list如果一切正常你应该能看到发布者和订阅者之间的消息传递。5. 常见问题与解决方案在Ubuntu 24.04上安装ROS2 Jazzy可能会遇到一些特有的问题以下是几个常见问题及其解决方法5.1 Python版本兼容性问题问题现象运行ROS2命令时出现Python导入错误解决方案sudo apt install python3-rosdep2 python3-rosinstall-generator python3-vcstool5.2 缺少系统依赖问题现象构建时报告缺少某些系统库解决方案rosdep install --from-paths src --ignore-src -y --skip-keys fastcdr rti-connext-dds-6.0.1 urdfdom_headers5.3 网络连接问题问题现象rosdep update失败解决方案export ROSDISTRO_INDEX_URLhttps://mirrors.tuna.tsinghua.edu.cn/rosdistro/index-v4.yaml rosdep update5.4 权限问题问题现象运行时出现权限错误解决方案sudo usermod -aG dialout $USER newgrp dialout6. Jazzy新特性探索ROS2 Jazzy带来了一些值得关注的新特性改进的RMW实现默认的DDS中间件性能有所提升增强的Python支持更好地支持Python 3.12新的工具链包括改进的ros2cli和监控工具性能优化在消息传递和节点发现方面有显著改进可以通过以下命令查看ROS2版本信息ros2 version要体验这些新特性可以尝试运行一些更复杂的Demo如ros2 run demo_nodes_cpp talker ros2 run demo_nodes_cpp listener