导读

本节将引导你完成开发环境的搭建,并运行第一个机器人演示。

请按此顺序阅读(与侧边栏一致):

  1. 安装环境

  2. 快速演示(公开版)

  3. open-deploy-ws 配置 / fa-deploy-ws 配置

  4. 常见问题(若出错)

在安装 ROS 2 Jazzy + rosdep 之前,不要先做快速演示。

前提条件

开始之前,请确保已具备:

  • Ubuntu 24.04(Jazzy Jalisco 目标平台)

  • 已安装 ROS 2 Jazzy

  • Python 3.12(Jazzy 基线;不要混用 3.10/3.11 虚拟环境)

  • Git 需能访问 GitHub(SSH 密钥,或 HTTPS / gh 认证 — .gitmodules 远程仍是 SSH)

  • 进行含仿真的编译时,建议配备 16GB 及以上内存

  • NVIDIA GPU(可选;使用 Isaac Sim 时必需)

选择你的路径

如果你是……

请从……开始

从零开始搭建环境

安装环境

环境已安装

快速演示(公开版)

使用公开机器人

open-deploy-ws 配置

FiveAges 团队成员

fa-deploy-ws 配置

故障排除

常见问题

路径速览

        flowchart LR
    A[Install ROS 2 Jazzy] --> B{Which path?}
    B -->|Public| C[Clone open-deploy-ws]
    B -->|Internal| D[Clone fa-deploy-ws]
    C --> E[./init_repo.sh]
    D --> F[./init_repo.sh]
    E --> G[colcon build]
    F --> G
    G --> H[Run demo.launch.py]
    

预计耗时

任务

时间

安装 ROS 2 Jazzy

15-30 分钟

克隆工作空间并初始化

5-10 分钟

完整编译工作空间

10-30 分钟

首次启动演示

2-5 分钟

接下来

完成环境搭建后:

  1. 按照学习路径进行系统性学习

  2. 按角色继续看更多应用(现场调试、传统方案算法工程师、VLA 采训推、仿真工程师

  3. 查阅操作指南以完成具体任务

  4. 需要了解整体背景时,请参阅架构