ros2_for_beginners_code

一、简介

本项目囊括了书籍《ROS 2机器人编程实战——基于现代C++和Python 3》的各章节配套代码，意在将书中例程完整呈现，以便帮助读者更好地理解书中内容。

二、开发环境配置

本仓库以 GitHub Actions 的完整构建和测试结果作为版本支持依据，目前支持以下组合：

ROS 2 版本	推荐 Ubuntu 版本	官方生命周期	本仓库 CI
Humble	Jammy 22.04	LTS，支持至 2027 年 5 月	✅
Jazzy	Noble 24.04	LTS，支持至 2029 年 5 月	✅
Lyrical	Resolute 26.04	LTS，支持至 2031 年 5 月	✅
Rolling	Resolute 26.04	持续开发版本	✅

具体构建矩阵见 .github/workflows/ci.yml。Rolling 会随 ROS 2 上游持续变化，CI 当前使用 ros2-testing 软件源验证最新可用软件包，不建议将其作为长期稳定的生产环境基线。

ROS 2 Foxy 已于 2023 年 6 月停止官方维护，本仓库不再为 Foxy 提供持续集成和兼容性保证。 历史代码仍可用于学习，但新项目建议选择上表中的受支持 LTS 版本。

1. 安装 ROS 2

建议在对应的 Ubuntu 版本上使用官方二进制软件包安装 ROS 2：

• Humble / Ubuntu Jammy 安装说明
• Jazzy / Ubuntu Noble 安装说明
• Lyrical / Ubuntu Resolute 安装说明
• Rolling / Ubuntu Resolute 安装说明

Windows、macOS 及源码安装方式请从对应版本的官方安装页面进入；本仓库当前只对上表中的 Ubuntu 组合提供自动化构建保证。此部分可结合书中 1.1.3～1.1.4 节完成。

2. 构建与测试本仓库

安装 ROS 2、ros-dev-tools 和 colcon 后，可创建独立工作空间进行构建：

source /opt/ros/$ROS_DISTRO/setup.bash

mkdir -p ~/ros2_ws/src
git clone https://github.com/homalozoa/ros2_for_beginners_code.git \
  ~/ros2_ws/src/ros2_for_beginners_code
cd ~/ros2_ws

rosdep install --from-paths src --ignore-src --rosdistro "$ROS_DISTRO" -r -y
colcon build --symlink-install
colcon test
colcon test-result --verbose

每次打开新终端时，都需要先加载对应 ROS 2 环境；构建完成后再执行 source ~/ros2_ws/install/setup.bash 即可运行本仓库中的节点和示例。

三、示例代码简介

1.功能包的构建与测试

本节对应书中2.1.2节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 通过ros2 pkg生成功能包ch2_pkg_cpp以及ch2_pkg_py的过程

• 如何配置并修改package.xml、setup.py及CmakeLists.txt

• 尝试merge以及symlink两种构建指令，比较构建结果的不同，以及构建指令与test指令的关系

ros2_for_beginners_code
         |
         |-ch2
            |
            |-package
                 |-ch2_pkg_cpp
                 |-ch2_pkg_py

2.节点与节点执行器

本节对应书中2.2.1节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 节点的创建方法

• 节点与线程、进程的关系

• 节点执行器的配置，包括线程配置和回调操作配置

• 节点的package.xml及CmakeLists.txt配置

• 节点的简单调试

ros2_for_beginners_code
         |
         |-ch2
            |-node
               |-ch2_node_cpp
               |-ch2_node_py

3. 日志的基本分类

本节对应书中3.1.1节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 日志的分类，rclcpp和rclpy的日志接口设计

• 收集和查阅历史日志的方法

• 日志使用的技巧

ros2_for_beginners_code
         |
         |-ch3
            |-logging
               |-ch3_logging_cpp
               |-ch3_logging_py

4. 使用启动脚本

本节对应书中3.2节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 使用ros2launch启动单个/多个进程

• 使用colcon进行构建并部署

• 使用扩展功能，配置启动脚本的启动信息

ros2_for_beginners_code
         |
         |-ch3
            |-launch
               |-ch3_launch

5. 节点的参数系统

本节对应书中3.3节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 使用ros2param功能包为节点添加参数

• 使用YAML维护参数，提高可维护性

• 动态获取参数的方法

ros2_for_beginners_code
         |
         |-ch3
            |-param
               |-ch3_param_bringup
               |-ch3_param_cpp
               |-ch3_param_py

6. 插件的创建及使用

本节对应书中3.4节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 插件的创建方法

• 使用参数动态加载插件的方法

ros2_for_beginners_code
         |
         |-ch3
            |-plugin
               |-ch3_plugin_alpha
               |-ch3_plugin_base
               |-ch3_plugin_beta
               |-ch3_plugin_main

7. 组件系统的使用

本节对应书中3.5节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 自定义组件的方法

• 使用组件容器加载多个组件

ros2_for_beginners_code
         |
         |-ch3
            |-component
                 |-ch3_component

8. ROS 2通信——topic

本节对应书中4.1节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 理解topic的通信机制，实现发布器与订阅器，思考topic的适用场景

• 运用ros2topic对topic的通信进行调试

• 了解QoS的策略及其兼容性，并正确配置使用

ros2_for_beginners_code
         |
         |-ch4
            |-topic
               |-ch4_topic_cpp
               |-ch4_topic_py

9. ROS 2通信——service

本节对应书中4.2节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 理解基于主从式架构service的通信机制，实现发布器与订阅器，对比topic思考service的适用场景

• 运用ros2service对service的通信进行调试

ros2_for_beginners_code
         |
         |-ch4
            |-service
               |-ch4_service_cpp
               |-ch4_service_py

10. ROS 2通信——action

本节对应书中5.1节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 理解基于主从式架构action的通信机制，实现发布器与订阅器，对比service思考action的适用场景

• 对使用action过程中发生的抢占和队列根据使用场景灵活处理

ros2_for_beginners_code
         |
         |-ch5
            |-action
               |-ch5_action_cpp
               |-ch5_action_interfaces
               |-ch5_action_py

11. ROS 2自定义action消息

本节对应书中5.2节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 使用ros2pkg创建自定义接口功能包的方法

• 使用ros2interface进行接口查看及调试

• 实践中灵活应用ros2/common_interfaces项目中提供的机器人通用功能的接口

ros2_for_beginners_code
         |
         |-ch5
            |-interface
               |-ch5_v_interfaces

12. 基于topic实现坐标系统

本节对应书中5.3节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 使用tf2_ros完成静态坐标变换的广播

• 使用tf2_ros完成动态坐标变换的广播

• 使用tf2_echo，tf2_monitor，buffer_server，static_transform_publisher对tf2进行调试

• 坐标变换监听器的实现

ros2_for_beginners_code
         |
         |-ch5
            |-tf2
               |-ch5_tf2_cpp

13. 使用GDB调试

本节对应书中6.1节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 在项目总添加调试属性的方法

• 使用GDB运行ch6_debug_cpp的可执行程序，进行调试过程的学习

ros2_for_beginners_code
         |
         |-ch6
            |-ch6_debug_cpp

14. 使用rosbag2实现持久记录

本节对应书中6.2节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 使用ros2bag启用压缩/不启用压缩的录制方法

• 使用ros2bag播放和处理bag文件

ros2_for_beginners_code
         |
         |-ch6
            |-ch6_bag_cpp

15. 编写单元测试

本节对应书中6.3节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 使用GooleTest实现单元测试的框架

• 使用lcov统计测试覆盖率

ros2_for_beginners_code
         |
         |-ch6
            |-ch6_unittest_cpp

16. 构建ROS 2的vendor功能包

本节对应书中7.2节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 构建vendor功能包的原因和重要性

• 引入CMake项目的方法

• 引入Autoconf项目的方法

ros2_for_beginners_code
         |
         |-ch7
            |-vendor_pkgs
                  |-grpc_vendor
                  |-mpg123_vendor
                  |-opencv_vendor

17. 使用sensor_msgs接口

本节对应书中7.3节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 熟悉common_interfaces中传感器的消息描述类型

• 多源数据的时间同步策略

ros2_for_beginners_code
         |
         |-ch7
            |-sensor
               |-ch7_msgfltr_cpp
               |-ch7_msgfltr_py

18. 诊断系统

本节对应书中7.4节的内容，在此项目中目录结构如下图，学习的关键点为以下几点：

• 熟悉诊断系统的消息定义及基本组成部分

• 诊断数据的更新器的构建与使用

• 使用更新器功能包DiagnosedPublisher、TopicDiagnostic和HeaderlessTopicDiagnostic帮助检测topic发布频率的异常

• 使用AnalyzerGroup对数据进行收集分析

ros2_for_beginners_code
         |
         |-ch7
            |-diagnostics
                  |-ch7_diagnostics_cpp

四、封面插画