准备终端
终端是输入命令、查看运行结果的窗口。本指南使用两个普通终端窗口:终端 A 运行仿真,终端 B 查看传感器数据或发送控制指令。A、B 只是便于区分用途的名称,并不是不同的软件。
在哪里打开这两个窗口
| 安装方式 | 终端 A 和 B |
|---|---|
| Ubuntu 原生安装 | 在 Ubuntu 中打开两个终端窗口 |
| Linux 上的 Docker | 打开两个 Linux 终端,从两边进入同一个容器 |
| Windows 上的 WSL | 在 Windows Terminal 中打开同一 WSL 发行版的两个 Ubuntu 标签页 |
| Windows 上的 WSL + Docker | 打开两个 Ubuntu 标签页,从两边进入同一个容器 |
| macOS 上的 Docker + RDP | 连接 RDP 后,在 Linux 桌面内打开两个终端 |
Linux 和 Windows 的 Docker 安装使用名为 posim 的容器。在宿主机的两个终端中分别运行:
docker exec -it posim bash
macOS 使用的 RDP 桌面已经位于容器内,ROS 命令应在该桌面的 Linux 终端中执行。PowerShell 和 macOS 终端用于启动容器等宿主机操作。
什么是工作空间
ROS 工作空间用于组织源代码和编译后的软件包。src/ 存放源码,build/ 存放编译中间文件,install/ 存放供 ROS 加载的软件包。
| 安装方式 | 路径 |
|---|---|
| Ubuntu 或 WSL 原生安装 | ~/posim_ws |
| AMD64 Docker 镜像 | /opt/posim_ws |
| ARM64 RDP 镜像 | /home/docker/posim_ws |
路径中的 ~ 表示当前 Linux 用户的主目录。下面的 POSIM_WS 变量用于保存工作空间路径,后续示例会沿用它。
在 A、B 中分别加载环境
Ubuntu 或 WSL 原生安装:
export POSIM_WS="$HOME/posim_ws"
source /opt/ros/lyrical/setup.bash
source "$HOME/.ros_ardusub_env/env"
source "$POSIM_WS/install/setup.bash"
cd "$POSIM_WS"
Docker,包括通过 RDP 打开的 Linux 桌面:
export POSIM_WS="${POSIM_WS:-${POSIM_UNDERLAY:-/home/docker/posim_ws}}"
source /opt/ros/lyrical/setup.bash
source "$POSIM_WS/install/setup.bash"
cd "$POSIM_WS"
source 用于加载路径和设置,让当前终端能够找到 ROS 和 POSIM。每次打开新终端后,都需要执行相应命令。
启动前检查
ros2 pkg prefix posim_demos
ros2 pkg prefix ros_gz_sim
两个路径都应位于工作空间的 install/ 目录中。如果找不到软件包,请回到安装指南检查。如果 ros_gz_sim 指向 /opt/ros/lyrical,说明当前终端尚未加载工作空间中的版本。
接下来运行第一次仿真。持续输出消息的命令仍在运行;请在运行它的终端中按 Ctrl+C 停止,等待命令提示符重新出现,再输入下一条命令。