功能包是ROS2中组织代码的基本容器,方便我们编译、安装、分发开发的代码,一般来讲,每个功能包都是用来完成某项具体的功能相对完整的单元。 ROS2中的功能包可以使用CMake或者Python两种方式来编译,其本身是一个“文件夹”,但和文件夹不同的是,每个功能包中都会有这些文件: CMake包:
- package.xml:功能包的描述信息
- CMakeLists.txt:描述CMake编译该功能包的规则
Python包:
- package.xml:功能包的描述信息
- setup.py:包含如何安装该包的说明
- setup.cfg:如果包内有可执行文件,需要设置该文件来让ros2 run命令找到它
- /<package_name>:包含 __init__.py 的文件夹,和功能包同名
每个工作空间中可以有多个功能包,CMake或者Python包都可以,但是功能包是不能嵌套的。典型的一个工作空间内功能包的结构如下:
workspace_folder/
src/
package_1/
CMakeLists.txt
package.xml
package_2/
setup.py
package.xml
resource/package_2
...
package_n/
CMakeLists.txt
package.xml
1.创建功能包
还是使用之前已经创建好的dev_ws工作空间,我们在其中的src文件夹中来创建新功能包。 打开终端后进入到dev_ws/src路径下:
cd ~/dev_ws/src
然后就可以使用如下语法来创建功能包了(以下二选一): CMake包:
ros2 pkg create --build-type ament_cmake <package_name>
Python包:
ros2 pkg create --build-type ament_python <package_name>
创建功能包的指令还允许设置节点名,自动生成一个helloworld的例程代码(以下二选一)。 CMake包:
ros2 pkg create --build-type ament_cmake --node-name my_node my_package
Python包:
ros2 pkg create --build-type ament_python --node-name my_node my_package
运行成功后就可以在src中看到一个新的文件夹叫做my_package,同时在终端中有很多日志信息: CMake包: Python包:
2.编译功能包
接下来进入编译流程,一定要将终端cd到dev_ws的路径下来:
cd ~/dev_ws
然后就可以编译啦:
colcon build
这个命令会编译工作空间中的所有功能包,如果只想编译某一个包的话,可以这样:
colcon build --packages-select my_package
3.设置环境变量
打开一个新的终端,运行下工作空间的环境变量,这样才能让该终端找到新创建的包:
. install/setup.bash
接下来就可以在该终端中愉快的运行新建的功能包了。
4.运行功能包中的节点
在终端中使用如下命令即可运行新建功能包的节点啦:
ros2 run my_package my_node
5.功能包里有什么
不管你是用CMake还是python创建的包,打开看一下,里边有哪些默认的文件: CMake包: src中有一个 my_node.cpp 文件,就是实现上边看到hello world的例程代码。 Python包: my_package中有一个 my_node.py 文件,就是实现上边看到hello world的例程代码。
6.修改package.xml文件
新建功能包中的package.xml文件需要我们手动完善一下,包括其中的功能包描述、版本信息、使用许可证等,默认都有加“TODO”标志。 CMake包: Python包: 完善以上描述信息、许可证和作者邮箱,关于许可证的详细介绍可以参考: https://opensource.org/licenses/alphabetical 除了这些基本信息之外,还可以看到不少以“ _depend”结尾的标签,这些就是用来描述功能包依赖的,如果我们在编写代码过程中新增加了什么依赖,都可以手动添加到这里来。 如果使用的是Python包,还需要多修改一个文件setup.py: 其中第16~19行的内容需要修改的和package.xml文件一致。 OK,这就是ROS2中创建功能包的方法。