【ROS2】含自定义消息的ROS2节点开发流程

ROS 2 自定义消息(.msg)开发核心原则:接口编译必须先于节点编译。

工程规范要求严格分离消息包与功能包。以下为标准开发与迭代流程。


一、 初次创建与运行全流程

Step 1: 创建工作空间与独立包

消息包必须基于 CMake 构建,不受逻辑节点语言限制。

bash 复制代码
mkdir -p ~/dev_ws/src && cd ~/dev_ws/src

# 创建消息包 (必须为 ament_cmake)
ros2 pkg create --build-type ament_cmake custom_msgs

# 创建功能节点包 (以 Python 为例)
ros2 pkg create --build-type ament_python robot_node --dependencies rclpy custom_msgs

Step 2: 定义消息接口

bash 复制代码
cd custom_msgs && mkdir msg
cat <<EOF > msg/RobotStatus.msg
int32 robot_id
string status_text
float64 battery_level
EOF

Step 3: 配置构建依赖

修改 custom_msgs/CMakeLists.txt,追加:

cmake 复制代码
find_package(rosidl_default_generators REQUIRED)

rosidl_generate_interfaces(${PROJECT_NAME}
  "msg/RobotStatus.msg"
)

修改 custom_msgs/package.xml,追加:

xml 复制代码
<buildtool_depend>rosidl_default_generators</buildtool_depend>
<exec_depend>rosidl_default_runtime</exec_depend>
<member_of_group>rosidl_interface_packages</member_of_group>

Step 4: 优先编译消息包(强制前置)

未完成此步将导致逻辑节点报模块缺失错误。

bash 复制代码
cd ~/dev_ws
colcon build --packages-select custom_msgs
source install/setup.bash

Step 5: 编写节点代码

文件:robot_node/robot_node/status_publisher.py

python 复制代码
import rclpy
from rclpy.node import Node
from custom_msgs.msg import RobotStatus 

class StatusPub(Node):
    def __init__(self):
        super().__init__('status_pub_node')
        self.pub = self.create_publisher(RobotStatus, 'robot_status', 10)
        self.timer = self.create_timer(1.0, self.timer_cb)

    def timer_cb(self):
        msg = RobotStatus(robot_id=1, status_text="Nominal", battery_level=98.5)
        self.pub.publish(msg)

def main(args=None):
    rclpy.init(args=args)
    rclpy.spin(StatusPub())
    rclpy.shutdown()

if __name__ == '__main__':
    main()

(注:需在 setup.py 的 entry_points 中完成节点注册)

Step 6: 编译并运行

bash 复制代码
cd ~/dev_ws
colcon build --packages-select robot_node
source install/setup.bash
ros2 run robot_node status_publisher

二、 后续开发迭代循环

根据修改内容,迭代分为两条固定路径。

场景 A:仅修改逻辑代码

未更改 .msg 文件。

  1. 修改代码 :编辑 .py 或 .cpp。
  2. 编译生效:
  • C++ :执行 colcon build --packages-select robot_node。
  • Python :若初次构建包含 --symlink-install 参数,无需重新编译,保存代码即可。
  1. 运行:重启节点。
场景 B:修改自定义消息结构

更改 .msg 字段(如增删变量),必须严格按以下顺序执行:

  1. 修改定义 :更新 .msg 文件。
  2. 重编消息包 :colcon build --packages-select custom_msgs
  3. 刷新环境(关键) :source install/setup.bash,确保终端加载最新接口结构。
  4. 修改代码:在节点代码中适配新字段。
  5. 重编节点包 :colcon build --packages-select robot_node(C++ 节点必须重新链接)。
  6. 运行:重启节点。
相关推荐
民乐团扒谱机19 小时前
Rakazo 智能清洁机器人深度评测报告
机器人
feasibility.20 小时前
英伟达把物理AI的3D模型“应用商店”开放了:2575个SimReady仿真资产,总计约472GB,可让agent装配机器人训练场景
人工智能·3d·机器人·仿真·建模·具身智能·英伟达
wangxiaoxuan2171 天前
机器人软件如何分层:驱动、算法、能力、动作与业务
机器人·科沃斯八界
kyle~1 天前
模型预测控制(MPC)
算法·机器人·控制·传感器
飞Link1 天前
灵巧手是什么?从机械结构、驱动方式到控制原理,认识机器人的精细操作能力
人工智能·python·机器人
mechanical_expert1 天前
以SILVERTHIN SC047CP0为例计算等截面薄壁轴承摩擦损耗和启动扭矩
人工智能·机器人
wangxiaoxuan2171 天前
移动操作机器人如何协同:底盘、升降、机械臂与资源约束
机器人·科沃斯八界
xx z2 天前
directx修复工具下载(DirectX Repair 增强版 使用说明)
windows·系统·工具·软件
天树星智源2 天前
记忆该记「赔率跳变」:机器人长时程十连任务,事件记忆 88.0%,删掉失败记录只剩 1.7%
论文阅读·人工智能·机器人
kyle~2 天前
因子图优化(Factor Graph Optimization)
c++·算法·机器人·传感器