机器人 / 系统课时

安装 Jazzy 版 MoveIt 2

安装 Jazzy 版 MoveIt 2

在 Ubuntu 24.04 上安装 MoveIt 2,容易遇到 ROS 软件源缺失、终端未加载 Jazzy,以及机器人示例依赖不齐的问题。本篇通过 APT 安装官方二进制包与 Panda 测试配置,检查核心 ROS 包是否可见,再启动 RViz 示例完成验收。

学习目标

  • 核对 Ubuntu 24.04 与 ROS 2 Jazzy 的运行环境。
  • 安装 MoveIt 2、Panda 示例配置和控制器依赖。
  • 验证包路径、环境变量及 RViz 示例的启动结果。

确认系统与 ROS 环境

适用环境是 Ubuntu 24.04(noble)及通过 APT 安装的 ROS 2 Jazzy,使用 Bash 和能打开 RViz 的图形桌面。先确认 /opt/ros/jazzy/setup.bash 存在;若不存在,先按 ROS 2 Jazzy 安装指南 配置 ROS 软件源并安装 ros-jazzy-desktop,不要直接跳到 MoveIt 安装。

bash
# 读取系统版本,并为当前终端加载 Jazzy 环境
. /etc/os-release
printf '%s %s\n' "$ID" "$VERSION_ID"
source /opt/ros/jazzy/setup.bash
printf 'ROS_DISTRO=%s\n' "$ROS_DISTRO"
command -v ros2 >/dev/null && echo 'ros2 CLI ready'

预期输出:

text
ubuntu 24.04
ROS_DISTRO=jazzy
ros2 CLI ready

如果 source 报文件不存在,说明 Jazzy 尚未按上述目录安装;如果系统版本不是 24.04,不要套用本篇的二进制包名。source 只改变当前终端及其子进程的环境,新终端还需重新执行。

安装 MoveIt 2 与示例依赖

在已配置 ROS 2 官方 APT 软件源的机器上执行以下命令。ros-jazzy-moveit 提供规划框架,Panda 配置包包含用于测试的机器人模型与规划参数;ros2_control 和控制器包支撑示例中的模拟执行,rviz2 提供可视化界面。

bash
# 安装 MoveIt、Panda 测试配置及图形/模拟控制依赖
sudo apt update
sudo apt install -y \
  ros-jazzy-moveit \
  ros-jazzy-moveit-resources-panda-moveit-config \
  ros-jazzy-ros2-control \
  ros-jazzy-ros2-controllers \
  ros-jazzy-rviz2

预期结果:APT 完成依赖解析和安装,命令以退出码 0 结束;下载体积与具体软件版本取决于当前镜像源。已有的 ros-jazzy-desktop 或相关控制器包可能显示为已安装,不需要重新编译 MoveIt 源码。

验证 ROS 包与终端环境

APT 包名与 ROS 包名不同:前者形如 ros-jazzy-moveit,后者由 ros2 pkg 查询。新开终端后先加载 Jazzy,再核对 MoveIt 核心节点与 Panda 配置包的安装前缀。

bash
# 以 ROS 包名验证可执行程序与示例配置
source /opt/ros/jazzy/setup.bash
printf '%s\n' "$ROS_DISTRO"
ros2 pkg prefix moveit_ros_move_group
ros2 pkg prefix moveit_resources_panda_moveit_config
ros2 pkg executables moveit_ros_move_group

预期输出(未叠加其他工作空间时):

text
jazzy
/opt/ros/jazzy
/opt/ros/jazzy
moveit_ros_move_group move_group

这证明 ROS 2 能查到已安装的 move_group 可执行程序及示例配置,但还不能证明 RViz 图形环境可用。若仅使用 Jazzy,可将 source /opt/ros/jazzy/setup.bash 写入 ~/.bashrc;如果同时使用 Humble 或其他发行版,应按终端分别加载,避免混合不同发行版和工作空间。

启动 RViz 示例验收

在图形桌面终端运行 Panda 自带的演示启动文件,不需要接入实体机械臂。它将拉起 RViz、move_group、机器人状态发布器以及使用模拟硬件的控制器;首次启动可能需要数秒加载模型和规划插件。

bash
# 使用 Panda 测试配置启动 MoveIt 规划环境
source /opt/ros/jazzy/setup.bash
ros2 launch moveit_resources_panda_moveit_config demo.launch.py

预期结果:RViz 打开并显示 Panda 机械臂,能找到 MotionPlanning 面板;启动命令持续运行是正常现象,关闭时按 Ctrl+C。若 RViz 界面加载了机器人但规划插件报错,应先检查终端中的实际错误,而不是据此判断安装包不存在。

排查常见安装失败

  • Unable to locate package ros-jazzy-moveit:先确认系统是 Ubuntu 24.04,检查 apt-cache policy ros-jazzy-moveit 是否有候选版本;若没有,检查 ROS 2 APT 软件源并重新执行 sudo apt update。
  • Package 'moveit_ros_move_group' not found:在运行命令的那个终端执行 source /opt/ros/jazzy/setup.bash,再用 ros2 pkg prefix moveit_ros_move_group 核对;不要将 APT 包名直接当作 ROS 包名查询。
  • 示例提示缺少控制器插件:检查 ros-jazzy-ros2-control、ros-jazzy-ros2-controllers 是否安装,并确保没有加载其他 ROS 发行版的工作空间。示例启动异常时还应检查配置包的安装版本。
  • RViz 无法打开或 OpenGL 报错:先在 Ubuntu 图形桌面本地启动 rviz2 检查显示环境;纯 SSH 终端、无图形桌面的容器或缺失图形加速,都可能让包检查通过却无法显示界面。

完成验收的标准是:ROS_DISTRO 为 jazzy、两个 ROS 包均可查询、move_group 可执行程序存在,并且 Panda 示例能够打开 RViz。安装步骤采用 MoveIt 官方二进制安装说明 所推荐的 Jazzy APT 路径。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Jazzy 版 MoveIt 2

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通