【机器人】ROS2 功能包创建与 CMake 编译链路探秘

优质文章学习记录

— 8 min read
【机器人】ROS2 功能包创建与 CMake 编译链路探秘
请添加图片描述
在这里插入图片描述
🔥大奇个人主页 ：https://blog.ZEEKLOG.net/m0_75192474?type=blog
⚡本文所属专栏：https://blog.ZEEKLOG.net/m0_75192474/category_13131150.html

ros2 pkg create 是 ROS2（Robot Operating System 2）中用于快速初始化功能包的官方核心命令行工具。其核心作用是自动生成功能包所需的完整目录结构、配置文件及可选示例节点，避免手动创建文件和配置的繁琐操作，大幅提升开发效率。

该命令支持两种主流构建类型（C++/Python），可直接指定依赖包、维护者信息、开源协议等关键配置，生成的功能包完全符合 ROS2 官方规范，可直接用于编译、运行及后续开发扩展

⏰ 创建工作空间

首先需要再主目录中新建一个文件夹，带src目录

mkdir-p test_ws/src &&cd test_ws/src

📸 创建功能包命令参数详解

命令基本格式

基础语法（必填项与可选参数分离，清晰易懂）：

ros2 pkg create [可选参数]<功能包名称>

关键说明：

  • <功能包名称>：必填项，自定义功能包名称，需遵循 ROS2 命名规范（小写英文、可搭配下划线，禁止大写、特殊符号及中文）。
  • [可选参数]：用于配置功能包的构建类型、依赖、创建路径、描述信息等，按需选择使用。

基础配置参数

  • --help：显示该命令的所有参数说明及使用方法，快速查阅帮助信息后退出。
  • --package-name ：显式指定功能包名称，用于解决“目录名与包名不一致”的场景，优先级高于默认目录名（也可以直接写名字不加该参数）
  • --description：设置功能包的描述信息，描述内容将写入 package.xml 的 <description> 标签，便于他人理解包的用途。
  • --license：指定功能包的开源协议，常用协议：Apache-2.0、MIT、BSD，协议信息写入 package.xml
  • --maintainer：设置功能包维护者的姓名，写入 package.xml 的 <maintainer> 标签，便于后续维护和沟通。

核心构建类型参数（必选）

  • --build-type ament_cmake：构建类型为C++ 包，

默认构建类型，自动生成 CMakeLists.txt、src 目录（用于存放 C++ 源码），支持 C++ 节点开发、自定义消息编译等

ros2 pkg create my_cpp_pkg --build-type ament_cmake
  • --build-type ament_python :构建类型为Python 包

自动生成 setup.py、setup.cfg、功能包同名目录（用于存放 Python 源码），支持 Python 节点开发，语法简洁、开发效率高。

依赖配置参数

--dependencies ：参数用于指定功能包依赖的其他 ROS2 包，创建包时会自动将依赖写入 package.xml和 CMakeLists.txt避免手动配置依赖导致的编译错误，是开发中最常用的参数之一

  • rclcpp：C++ 节点开发核心依赖
  • rclpy：Python 节点开发核心依赖
  • std_msgs：标准消息类型依赖（如 String、Int32）
  • sensor_msgs：传感器消息依赖（如激光雷达、IMU 数据）
  • geometry_msgs：几何消息依赖（如速度、姿态、坐标）
  • rosidl_default_generators：自定义消息（.msg/.srv）编译依赖
ros2 pkg create my_nav_pkg --build-type ament_cmake --dependencies rclcpp std_msgs sensor_msgs

创建基础 C++ 包

ros2 pkg create my_cpp_node \\ --build-type ament_cmake \\--dependencies rclcpp std_msgs \\ --node-name my_first_node \\--description"ROS2 C++ 基础节点包，用于演示简单消息发布"\\--license MIT \\--maintainer"Zhang San"\\ --maintainer-email "[email protected]"\\ --destination-directory ./src

创建基础 Python 包

ros2 pkg create my_py_node \\ --build-type ament_python \\--dependencies rclpy \\ --node-name my_py_node \\--description"ROS2 Python 基础节点包"\\--license Apache-2.0

创建自定义消息接口包

ros2 pkg create my_custom_msgs \\ --build-type ament_cmake \\--dependencies rosidl_default_generators std_msgs \\--description"ROS2 自定义消息包，用于定义专属消息类型"\\--license MIT

创建导航相关 C++ 包

ros2 pkg create my_navigation \\ --build-type ament_cmake \\--dependencies rclcpp geometry_msgs nav2_msgs sensor_msgs \\--description"ROS2 导航功能包，用于机器人路径规划与控制"\\ --destination-directory ./src

🌗 CMakeLists.txt 相关语法

CMakeLists.txt 是 ROS2 C++ 功能包（ament_cmake 类型）的核心构建配置文件，负责定义编译规则、依赖管理、目标安装等，

  • find_package(<依赖包> REQUIRED)

查找当前功能包依赖的 ROS2 包或第三方库，REQUIRED 表示该依赖是必需的，找不到会直接报错；若依赖多个包，可分多行书写。

find_package(ament_cmake REQUIRED)find_package(rclcpp REQUIRED)find_package(std_msgs REQUIRED)
  • ament_package()

ROS2 专属核心指令，标记当前包为 ament 包，用于生成 package.xml 关联配置、注册包到 ament 索引，必须放在 CMakeLists.txt 的最后一行，且每个包只能调用一次。

  • add_executable(<节点名> <源码路径>)

将指定的 C++ 源码文件编译为可执行节点，<节点名> 是编译后生成的可执行文件名称，<源码路径> 是 .cpp 文件的相对路径（通常在 src 目录下），这是最后可以ros2 run的依据

add_executable(talker src/talker.cpp)
  • ament_target_dependencies(<节点名> <依赖包>...)

为可执行节点或库绑定依赖包，自动处理依赖包的头文件路径和编译宏，替代传统的 target_include_directories 指令，简化配置，必须在 add_executable 之后调用。

ament_target_dependencies(talker rclcpp std_msgs)
  • target_link_libraries(<节点名> <库文件>...)

将指定的库文件（如自定义消息类型支持库、第三方库）链接到可执行节点，常用于链接自定义消息的类型支持库

  • rosidl_generate_interfaces(<包名> <消息文件> [DEPENDENCIES <依赖包>])

ROS2 自定义消息（.msg/.srv/.action）编译核心指令，用于解析消息文件、生成对应的 C++/Python 代码和头文件，若消息依赖其他包（如 std_msgs），需通过 DEPENDENCIES 声明。

rosidl_generate_interfaces(${PROJECT_NAME} msg/MyMsg.msg DEPENDENCIES std_msgs)
  • rosidl_get_typesupport_target(<变量名> <包名> "rosidl_typesupport_cpp")

查找当前包生成的自定义消息 C++ 类型支持库，将其赋值给指定变量，便于后续通过 target_link_libraries 链接到节点，是 ROS2 Humble 及以后的推荐写法。

  • install(TARGETS <节点名/库名> DESTINATION <路径>)

该命令式将生成的可执行节点安装在指定路径，这是后续ros2 run xxx的关键，ROS2 规范路径为 lib/${PROJECT_NAME}（节点/库）、include/${PROJECT_NAME}（头文件）

◀️ package.xml 相关语法

package.xml 是 ROS2 功能包的元数据配置文件，用于声明包的基本信息、依赖关系、维护者信息等，ROS2 编译工具（colcon）通过该文件识别包的类型、依赖和构建规则，

基础信息标签

标签说明
name声明功能包名称，必须与 CMakeLists.txt 中 project() 指令的包名一致，遵循 ROS2 命名规范（小写、英文、下划线）。
version声明包的版本号，遵循语义化版本规范（主版本号.次版本号.修订号，如 1.0.0），用于版本管理和迭代。
description简要描述功能包的用途和功能，便于他人理解包的作用，支持简单的文本描述。
maintainer声明包的维护者信息，必须包含 email 属性（邮箱地址），标签内容为维护者姓名，可多个维护者。
license声明包的开源协议，常用协议：Apache-2.0、MIT、BSD，需填写标准协议名称，可多个协议标签。

依赖关系标签

  • <buildtool_depend>

构建工具依赖，声明构建该包所需的工具包，C++ 包默认依赖 ament_cmake，Python 包默认依赖 ament_python，是必需依赖。

<buildtool_depend>ament_cmake</buildtool_depend>
  • <build_depend>

构建依赖，声明编译该包时所需的依赖包（如头文件、编译宏），仅在构建阶段生效，运行时无需依赖。

<build_depend>rclcpp</build_depend>
  • <exec_depend>

执行依赖，声明运行该包时所需的依赖包（如库文件、节点），仅在运行阶段生效，构建时无需依赖。

<exec_depend>std_msgs</exec_depend>
  • <depend>

通用依赖，等价于同时声明 build_depend、exec_depend 和 test_depend，适用于“构建、运行、测试都需要”的依赖，简化配置。

<depend>rclcpp</depend>
  • <test_depend>

测试依赖，声明运行包的测试用例时所需的依赖包（如 gtest、ament_lint_auto），仅在测试阶段生效。

<test_depend>ament_lint_auto</test_depend><test_depend>ament_lint_common</test_depend>
  • <member_of_group>

将包归类到指定组，ROS2 自定义消息包必须添加该标签，值为 rosidl_interface_packages，告诉编译系统该包是接口包

<member_of_group>rosidl_interface_packages</member_of_group>

Read more

如何轻松分析大疆无人机信号？DJI DroneID 信号解析工具全指南

如何轻松分析大疆无人机信号？DJI DroneID 信号解析工具全指南 🛸 【免费下载链接】dji_droneid 项目地址: https://gitcode.com/gh_mirrors/dj/dji_droneid DJI DroneID 信号分析项目（dji_droneid）是一个开源工具集，专为无人机爱好者和研究人员设计，通过软件定义无线电（SDR）技术捕获、解码和分析大疆无人机发射的DroneID信号。该项目提供完整的信号处理流程，从原始IQ数据捕获到最终数据帧解析，支持Octave和MATLAB环境运行，帮助用户深入理解无人机通信机制。 📌 项目核心功能与技术架构 🔍 信号捕获与处理全流程 项目实现了从射频信号到数据帧的完整解析链路，主要包括： * 原始信号采集：支持32位浮点IQ数据文件输入（需配合SDR设备录制） * ZC序列检测：通过归一化互相关算法定位信号中的Zadoff-Chu序列 * 频率校正：自动检测并补偿信号中的频率偏移 * OFDM符号提取：精准提取9个OFDM符号（含2个ZC序列符号） * 相位校正与均衡：解决无线信道引入的

低代码集成：将PDF-Extract-Kit-1.0接入Power Platform的完整教程

低代码集成：将PDF-Extract-Kit-1.0接入Power Platform的完整教程 你是不是也遇到过这样的情况：公司里每天都有大量PDF格式的合同、发票、报告需要处理，手动复制粘贴不仅费时费力，还容易出错？而开发一个完整的自动化系统又太复杂，API调用、身份验证、数据解析……光是想想就头大。 别担心，今天我要分享的这个方法，完全不需要写一行后端代码，就能把强大的AI驱动PDF解析能力——PDF-Extract-Kit-1.0，轻松集成到你的Power Apps应用中。哪怕你是零编程基础的业务人员，也能在30分钟内完成整个流程。 PDF-Extract-Kit-1.0 是目前开源社区中表现最出色的PDF内容提取工具之一。它不仅能精准识别文本、表格、图像和公式，还能理解文档的布局结构，即便是扫描件或模糊文件也能保持高准确率。更重要的是，它的模型已经预置在ZEEKLOG星图镜像广场中，支持一键部署为HTTP服务，这为我们通过Power Automate调用提供了极大便利。 本文将带你从零开始，一步步实现： * 如何快速部署 PDF-Extract-Kit-1.0 镜像

OpenClaw基础-3-telegram机器人配置与加入群聊

OpenClaw基础-3-telegram机器人配置与加入群聊 💡 大家好，我是可夫小子，《小白玩转ChatGPT》专栏作者，关注AI编程、AI自动化和自媒体。 Openclaw的优势是接入各种聊天工作，在前面的文章里，已经介绍了如何接入飞书。但之前我也提到了，飞书的最大的问题是请求多的限制，以及无法在非认证企业账号下面组建群聊。但这些限制另一个聊天工具可以打破，那就是Telegram，今天就跟大家分享一下，如果在OpenClaw里面接入Telegram。 第一步：Openclaw端配置 通过命令openclaw config，local→channels→telegrams 这里等待输入API Token，接下来我们去Telegram里面获取 第二步：Telegram端配置 1. 1. 在聊天窗口找到BotFather，打开对话与他私聊 2. 3. 然后再输入一个机器人，再输入一个账号名username，这里面要求以Bot或者Bot结尾，这个是全网的id，要 2. /newbot 来创建一个机器人，输入一个名字name
Neo4j-Desktop2.0安装教程(更改安装路径)

Neo4j-Desktop2.0安装教程(更改安装路径)

引言        由于neo4j-desktop2.0版本是不提供安装页面（默认安装在C盘），从而让你选择安装路径的，这对于C盘内存来说是灾难性的。因此，需要手动设置安装路径。 参考文献： 1. https://zhuanlan.zhihu.com/p/1935104156433121644https://zhuanlan.zhihu.com/p/1935104156433121644 2. https://blog.ZEEKLOG.net/WMXJY/article/details/150649084 安装包下载：https://neo4j.com/deployment-center/?desktop-gdbhttps://neo4j.com/deployment-center/?desktop-gdb 1文件夹创建及环境变量设置     首先需要在C盘以外的位置先创建一个Neo4j2文件夹，再在下面创建两个文件夹：App，PROData来存放软件本体和相关数据 然后打开“高级系统设置”——“环境变量”——系统变量下方的“新建”