BEEF-ROS 是一个面向 ROS2 学习者和开发者的实战型教程与代码示例仓库,涵盖 ROS2 从环境安装、核心概念、接口开发、TF2、Launch、DDS、测试调试、rosbag2 等全流程内容。每一章节均配有详细代码、脚本和说明文档,适合初学者入门、进阶者查阅和项目实战。
- Ubuntu 20.04/22.04(推荐桌面版)
- ROS2(建议Humble/Foxy等主流发行版)
- Python 3.8+
- C++17 支持
- 推荐安装
colcon、gnome-terminal、rviz2、turtlesim等依赖
cd src/chapter01_intro_install
chmod +x install_ros2.sh
./install_ros2.shcd ~/Desktop/BEEF-ROS
colcon build
source install/setup.bash以“小海龟Turtlesim”一键演示为例:
cd src/chapter02_core_concepts_turtlesim
chmod +x turtlesim_demo.sh
./turtlesim_demo.sh更多章节的运行方法请参考各自目录下的README或章节文档。
- 提供一键安装ROS2脚本,适合新手快速搭建开发环境。
- 一键启动小海龟仿真、键盘控制与命令终端,体验话题、服务、参数等核心概念。
- C++/Python双版本,包含服务/客户端、计数器、自定义消息发布/订阅等基础节点。
- 演示自定义消息(msg)、服务(srv)、动作(action)接口的完整流程。
- 提供C++/Python节点实现。
- 展示复杂事件处理、条件启动、参数化配置等Launch文件高级用法。
- 详见
event_handling_demo包,支持C++/Python双版本。
- 包含静态/动态/固定帧广播器、监听器、RViz可视化等完整TF2演示。
- 支持turtlesim仿真与3D坐标系树展示。
- 机器人模型描述与仿真(详见配套文档)。
- 演示DDS通信机制、QoS配置、性能测试等。
- 提供C++/Python示例。
- C++/Python单元测试(GTest/pytest)、日志输出、调试节点与一键Launch。
- rviz可视化工具使用与配置(详见配套文档)。
- 机器人仿真环境搭建与实战(详见配套文档)。
- C++/Python API演示数据包录制、读取、回放等高级用法。
install_ros2.sh:一键安装ROS2脚本turtlesim_demo.sh:一键启动小海龟仿真环境- 各章节均配有
README.md、launch/、src/、test/等子目录,便于查阅和运行 - 复杂功能包(如TF2、event_handling_demo)均有详细注释和参数说明
欢迎提交PR、Issue或建议!
- 如发现代码/文档问题,请在GitHub仓库提交Issue
- 贡献新示例或修复bug请提交Pull Request
- 也欢迎在讨论区交流ROS2学习心得
感谢所有为本项目做出贡献的开发者与学习者!
如需详细学习每一章节内容,请查阅各章节目录下的README和配套.md文档。