机器人 / 系统课时

在 Ubuntu 上配置 ROS 2 建图环境

在 Ubuntu 上配置 ROS 2 建图环境

在 Ubuntu 24.04 上安装 ROS 2 Jazzy、RViz 2、rosbag2 和 slam_toolbox,并逐项检查命令与图形界面。完成后即可准备录放传感器数据和运行二维激光建图,无需现在连接机器人。

学习目标

  • 确认系统版本、架构和 UTF-8 环境满足 Jazzy 的安装条件。
  • 通过官方软件源安装 ROS 2 桌面版及三个建图工具。
  • 用可重复的命令验证包、录包命令和 RViz 2 是否可用。

检查系统与语言环境

本流程适用于 Ubuntu 24.04(Noble)64 位 amd64 或 arm64,建议使用本机图形桌面;纯 SSH 终端可以安装包,却不能直接验证 RViz 2 窗口。先打开 Bash 终端执行:

bash
# 从系统标识核对版本与发行代号
source /etc/os-release
printf '%s %s\n' "$VERSION_ID" "$VERSION_CODENAME"
dpkg --print-architecture
locale charmap

预期输出(以 amd64 为例):

text
24.04 noble
amd64
UTF-8

arm64 设备第二行会显示 arm64。如果系统不是 24.04,不要照搬 noble 软件源;locale charmap 如果不是 UTF-8,下一步会修复语言环境。还需确保可使用 sudo,并能访问 Ubuntu、GitHub 和 ROS 软件仓库。

配置官方软件源

先启用 Ubuntu 的 universe 仓库,再安装用于管理 ROS 2 软件源及签名密钥的 ros2-apt-source。以下命令采用 Jazzy 官方 deb 安装流程,而不是复制过时的手写 ros2.list 配置:

bash
# 先准备语言环境与 Ubuntu Universe 软件源
sudo apt update
sudo apt install -y locales software-properties-common curl
sudo locale-gen en_US.UTF-8
sudo update-locale LANG=en_US.UTF-8
export LANG=en_US.UTF-8
sudo add-apt-repository -y universe
# 下载官方维护的 ROS 2 apt 软件源配置包
ROS_APT_SOURCE_VERSION=$(curl -fsSL https://api.github.com/repos/ros-infrastructure/ros-apt-source/releases/latest | grep -F '"tag_name"' | awk -F'"' '{print $4}')
curl -fL -o /tmp/ros2-apt-source.deb "https://github.com/ros-infrastructure/ros-apt-source/releases/download/${ROS_APT_SOURCE_VERSION}/ros2-apt-source_${ROS_APT_SOURCE_VERSION}.noble_all.deb"
sudo dpkg -i /tmp/ros2-apt-source.deb
sudo apt update
apt-cache show ros-jazzy-desktop >/dev/null && echo 'PASS ROS repository'

预期输出:最后一行打印 PASS ROS repository;此前的下载进度和索引数量会随镜像源变化。如果 curl 失败或未打印 PASS,先排查网络、GitHub API 访问和 dpkg 安装错误,不要继续安装。可对照ROS 2 Jazzy 官方安装说明。

安装 Jazzy 和建图工具

ros-jazzy-desktop 包含 ROS 2 核心、示例和 RViz 2;这里仍显式列出 RViz 2、rosbag2、slam_toolbox,便于核对建图工具齐全。所有包统一使用 ros-jazzy- 前缀,避免混装不同发行版。

bash
# 桌面版加装录包与建图组件,均选择 Jazzy 版本
sudo apt install -y ros-jazzy-desktop ros-jazzy-rviz2 ros-jazzy-rosbag2 ros-jazzy-slam-toolbox
source /opt/ros/jazzy/setup.bash
printf 'ROS_DISTRO=%s\n' "$ROS_DISTRO"

预期输出:软件包安装无错误,最后显示 ROS_DISTRO=jazzy。source 只对当前终端生效;使用 Bash 时可把它安全地写入启动配置,避免每次手动执行:

bash
# 已存在相同行时不再追加,避免重复加载
grep -qxF 'source /opt/ros/jazzy/setup.bash' ~/.bashrc || echo 'source /opt/ros/jazzy/setup.bash' >> ~/.bashrc

预期结果:若原本没有该行,~/.bashrc 将新增一次;重复执行不会再次追加,新开的 Bash 终端会自动加载 Jazzy。已经装有其他 ROS 发行版时,先检查其 setup.bash 是否也在启动配置中,避免环境混用。

验证命令与图形界面

先检查 ROS 2 是否能找到三个软件包,以及 ros2 bag 子命令是否存在。这一步不依赖激光雷达、里程计或已有地图。

bash
# 无传感器也能检查包索引和 CLI 插件
source /opt/ros/jazzy/setup.bash
for pkg in rviz2 rosbag2 slam_toolbox; do
  if ros2 pkg prefix "$pkg" >/dev/null 2>&1; then
    printf 'PASS %s\n' "$pkg"
  else
    printf 'FAIL %s\n' "$pkg"
  fi
done
ros2 bag --help >/dev/null && echo 'PASS ros2 bag'
# 仅解析 launch 参数,不启动需要激光输入的建图节点
ros2 launch slam_toolbox online_async_launch.py --show-args >/dev/null && echo 'PASS slam launch'

预期输出:

text
PASS rviz2
PASS rosbag2
PASS slam_toolbox
PASS ros2 bag
PASS slam launch

接着在 Ubuntu 图形桌面的终端启动 RViz 2:

bash
# 需要在有图形桌面的会话中启动
rviz2

预期结果:弹出 RViz 2 窗口,可以看到左侧 Displays 面板和中央三维视图;关闭窗口或按 Ctrl+C 结束进程。当前没有 /scan、/tf 和 /map 数据,因此没有地图显示是正常的,不代表安装失败。真正建图还需要激光扫描、里程计和匹配的 TF 变换。

处理常见失败

现象 定位与处理
Unable to locate package ros-jazzy-slam-toolbox 核对 VERSION_CODENAME=noble、软件源安装步骤与 sudo apt update 是否成功,再用 apt-cache policy ros-jazzy-slam-toolbox 查看 Candidate。
ros2: command not found 执行 source /opt/ros/jazzy/setup.bash;若该文件不存在,先检查 ros-jazzy-desktop 是否安装成功。
ROS_DISTRO 不是 jazzy 检查 ~/.bashrc 内其他发行版的 setup.bash;新开终端后仅加载 Jazzy。
RViz 2 无法创建窗口或 OpenGL 上下文 确认正在图形桌面会话中运行,检查 echo "$DISPLAY" 是否为空;远程纯终端或缺少可用图形驱动时,先在本机桌面验证。

至此,以三个包检查均为 PASS、ros2 bag 可调用、RViz 2 能打开作为环境验收条件。slam_toolbox 虽已安装,仍需后续接入 /scan、TF 和里程计数据才能生成有效地图。

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

目录与阅读设置

阅读设置

17

记录一个想法

在 Ubuntu 上配置 ROS 2 建图环境

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

登录哪都通