当前位置：首页 > news >正文

【ROS2】机械臂抓取——gazebo_grasp_plugin编译排障与模型集成实战

news 2026/5/11 21:51:40

1. 环境准备与源码获取

最近在做一个机械臂抓取项目时，遇到了gazebo_grasp_plugin这个神奇的插件。说实话，从下载到成功运行的过程真是踩了不少坑，今天就把这些经验完整分享给大家。首先需要明确的是，我们使用的是ROS2 Humble版本，操作系统是Ubuntu 22.04，这个组合目前来看是最稳定的。

获取源码这一步就有讲究。很多同学会直接去GitHub搜gazebo_grasp_plugin，但这样很容易下载到错误的版本。我建议直接访问作者提供的gazebo-pkgs仓库。这里有个重要提示：2024年4月更新后，原来的humble分支被移除了，现在需要通过问题评论区给出的链接才能找到正确的版本。下载时一定要确认是humble分支，可以用git clone加上--branch humble参数，或者直接下载zip包。

2. 编译前的必要修改

把源码下载到工作空间的src目录后，先别急着编译，有几个关键修改必须做。首先是要删除三个未升级到ROS2的功能包：gazebo_state_plugins、gazebo_world_plugin_loader和gazebo_test_tools。这些包还是基于ROS1的catkin构建系统，留着它们只会导致编译失败。

接下来是重头戏——修改CMakeLists.txt文件。原始文件中的安装路径设置有问题，会导致CMake找不到库文件。具体修改位置在src/gazebo-pkgs/gazebo_grasp_plugin/CMakeLists.txt中，找到install部分：

# 修改前（有问题） install(TARGETS gazebo_grasp_fix gazebo_grasp_msgs ARCHIVE DESTINATION lib/${PROJECT_NAME} LIBRARY DESTINATION lib/${PROJECT_NAME} RUNTIME DESTINATION bin/${PROJECT_NAME} ) # 修改后（正确） install(TARGETS gazebo_grasp_fix gazebo_grasp_msgs ARCHIVE DESTINATION lib LIBRARY DESTINATION lib RUNTIME DESTINATION bin )

这个修改解决了CMake报错找不到库文件的问题。原理很简单：原始配置会把库文件安装到lib/gazebo_grasp_plugin子目录下，而CMake默认只在lib目录下查找。

3. package.xml的适配修改

虽然不改动package.xml也能编译通过，但为了规范起见，建议还是做如下修改。主要是把ROS1的依赖项替换成ROS2对应的版本：

<!-- 修改前 --> <buildtool_depend>catkin</buildtool_depend> <build_depend>roscpp</build_depend> <!-- 修改后 --> <buildtool_depend>ament_cmake</buildtool_depend> <build_depend>rclcpp</build_depend>

同时要在export标签内添加<build_type>ament_cmake</build_type>，明确指定使用ament构建系统。这些修改虽然看起来是小细节，但在后续的依赖管理和包发现机制中很重要。

4. 编译与常见错误处理

完成上述修改后，就可以开始编译了。在工作空间根目录执行：

colcon build --symlink-install

这里使用--symlink-install参数可以创建符号链接，方便后续调试修改。编译过程中可能会遇到几个典型问题：

找不到Gazebo依赖：确保已经安装Gazebo和ROS2的Gazebo插件：
```
sudo apt install ros-humble-gazebo-ros-pkgs
```
库文件路径问题：如果编译通过但运行时找不到库，需要设置GAZEBO_PLUGIN_PATH环境变量。最稳妥的方法是在~/.bashrc中添加：
```
export GAZEBO_PLUGIN_PATH=$GAZEBO_PLUGIN_PATH:$(dirname $(locate libgazebo_grasp_fix.so))
```
版本冲突：有时会遇到与其他Gazebo插件的版本冲突，这时可以尝试创建一个独立的工作空间专门用于抓取仿真。

5. 模型集成与参数配置

编译成功后，接下来就是把这个插件集成到机械臂模型中。最佳实践是将Gazebo相关插件单独放在一个xacro文件中，然后通过include引入主模型。下面是一个典型的配置示例：

<gazebo> <plugin name="gazebo_grasp_fix" filename="libgazebo_grasp_fix.so"> <arm> <arm_name>robot_gripper</arm_name> <palm_link>arm_link5</palm_link> <gripper_link>gripper_left</gripper_link> <gripper_link>gripper_right</gripper_link> </arm> <forces_angle_tolerance>100</forces_angle_tolerance> <update_rate>100</update_rate> <grip_count_threshold>4</grip_count_threshold> <max_grip_count>8</max_grip_count> <release_tolerance>0.005</release_tolerance> <disable_collisions_on_attach>false</disable_collisions_on_attach> <contact_topic>__default_topic__</contact_topic> </plugin> </gazebo>

关键参数说明：