机器人 / 系统课时

安装 Jazzy 版 Nav2

安装 Jazzy 版 Nav2

在 Ubuntu 24.04 上安装 ROS 2 Jazzy、Nav2 启动包及 Gazebo Harmonic 仿真依赖,并验证 ROS 环境、包路径和启动文件均可识别。完成后,终端将具备运行 Nav2 TurtleBot3 最小仿真示例的条件,不必从源码编译导航栈。

学习目标

  • 核对 Ubuntu 版本、处理器架构与 ROS 软件源。
  • 安装 Jazzy 桌面版、Navigation2、nav2_bringup 和仿真组件。
  • 用环境变量、包查询及启动参数检查安装是否完整。

核对 Ubuntu 与运行条件

以下命令面向 Ubuntu 24.04(Noble)64 位系统,支持 amd64 和 arm64,使用 Bash、APT 和具备 sudo 权限的账户。打开终端检查系统版本与字符集:

bash
# 发行版必须为 24.04 noble,字符集应为 UTF-8
(. /etc/os-release; printf '%s %s\n' "$VERSION_ID" "$VERSION_CODENAME")
dpkg --print-architecture
locale charmap

预期输出(以 x86-64 机器为例):

text
24.04 noble
amd64
UTF-8

ARM64 机器第二行应为 arm64。如果是 Ubuntu 22.04,不要直接套用这组 Jazzy 二进制包安装步骤。后续运行 Gazebo 和 RViz 图形界面还需要可用的桌面显示会话;仅检查安装时不必启动图形仿真。

配置 ROS 软件源与桌面版

若 /opt/ros/jazzy/setup.bash 已存在,可跳过本节安装 ROS 的命令。首次安装先启用 Ubuntu Universe 仓库,再使用官方维护的 ros2-apt-source 配置 ROS 软件源,避免手工维护旧式密钥地址:

bash
sudo apt update
sudo apt install -y software-properties-common curl
sudo add-apt-repository -y universe
# 读取 ros2-apt-source 的最新发布标签,下载适配 noble 的安装包
ROS_APT_SOURCE_VERSION="$(curl -fsSL https://api.github.com/repos/ros-infrastructure/ros-apt-source/releases/latest | grep -F '"tag_name"' | cut -d '"' -f 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
sudo apt install -y ros-jazzy-desktop

预期结果:命令正常结束,APT 不再提示找不到 ros-jazzy-desktop;桌面版包含 ROS 命令行工具及 RViz 2。下载时的版本号和软件包日志会随仓库更新而变化。若 GitHub 请求失败,应先排查网络,勿把空的发布标签继续用于下载。安装依据可对照 ROS 2 Jazzy 官方 Ubuntu 指南。

安装 Nav2 与 Gazebo 依赖

Nav2 的 navigation2 包提供规划、控制、定位等组件,nav2_bringup 提供启动文件与示例配置。Jazzy 的官方最小 TurtleBot3 仿真使用现代 Gazebo;nav2_minimal_tb3_sim 提供示例机器人资源,ros_gz 提供 Gazebo 与 ROS 2 的集成组件。

bash
# 安装导航栈、启动文件、最小机器人仿真和 Gazebo 桥接
sudo apt update
sudo apt install -y \
  ros-jazzy-navigation2 \
  ros-jazzy-nav2-bringup \
  ros-jazzy-nav2-minimal-tb3-sim \
  ros-jazzy-ros-gz

预期结果:四个软件包及其依赖安装完成,APT 无 Unable to locate package 错误。ros-jazzy-ros-gz 对应 Jazzy 推荐的 Gazebo Harmonic 集成;不要混用面向 Gazebo Classic 的旧版 turtlebot3_gazebo 教程。这里使用 Nav2 自带的最小仿真包,不等于已经安装 ROBOTIS 完整 TurtleBot3 项目。

加载环境并执行验收

每个新终端都要加载 Jazzy 的环境脚本,否则 ros2 可能不可用,或找不到 Nav2 包。先在当前 Bash 中执行检查:

bash
# 先加载 Jazzy,再确认导航包与 Gazebo 命令可被终端找到
source /opt/ros/jazzy/setup.bash
printf 'ROS_DISTRO=%s\n' "$ROS_DISTRO"
ros2 pkg prefix nav2_bringup
ros2 pkg prefix nav2_minimal_tb3_sim
ros2 pkg prefix ros_gz_bridge
command -v gz >/dev/null && printf 'Gazebo CLI OK\n'

预期输出(使用 APT 安装且没有其他工作空间覆盖时):

text
ROS_DISTRO=jazzy
/opt/ros/jazzy
/opt/ros/jazzy
/opt/ros/jazzy
Gazebo CLI OK

如需新终端自动加载,执行一次以下命令;它会避免向 ~/.bashrc 重复添加同一行:

bash
grep -qxF 'source /opt/ros/jazzy/setup.bash' ~/.bashrc || printf '%s\n' 'source /opt/ros/jazzy/setup.bash' >> ~/.bashrc

预期结果:命令无错误;重新打开 Bash 后执行 echo "$ROS_DISTRO" 会输出 jazzy。接着仅查询仿真启动文件的参数,不启动仿真或占用图形资源:

bash
ros2 launch nav2_bringup tb3_simulation_launch.py --show-args

预期结果:终端列出启动参数,其中包含 headless、use_sim_time 等选项,而非 Package 'nav2_bringup' not found 或启动文件不存在。正式启动仿真需另行运行启动文件,并在 RViz 中设置初始位姿。

定位安装失败原因

如果安装时提示 Unable to locate package,先检查 ROS 软件源是否就绪,再查看包候选版本:

bash
dpkg-query -W -f='${Status}\n' ros2-apt-source
apt-cache policy ros-jazzy-navigation2

预期结果:第一条命令输出 install ok installed;第二条命令的 Candidate 应为具体版本,而不是 (none)。若缺少仓库,按前面的源配置步骤修复并重新运行 sudo apt update;不要用 Ubuntu 默认仓库中名称相近的包代替 Jazzy 包。

若出现 ros2: command not found,重新执行 source /opt/ros/jazzy/setup.bash,并确认该文件存在。若 ROS_DISTRO 不是 jazzy,在干净的 Bash 终端只加载 Jazzy,避免混入 Humble 或其他工作空间。包查询全部成功且启动参数能打印出来,即达到本课的安装验收标准;实际导航是否成功,还需要启动 Gazebo、定位和导航节点后验证。

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

目录与阅读设置

阅读设置

17

记录一个想法

安装 Jazzy 版 Nav2

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

登录哪都通