创建ros的程序包--3

创建ros的程序包（原创博文，转载请标明出处--周学伟http://www.cnblogs.com/zxouxuewei/）

　　1.一个catkin程序包由什么组成?

　　一个程序包要想称为catkin程序包必须符合以下要求：

该程序包必须包含catkin compliant package.xml文件

这个package.xml文件提供有关程序包的元信息。

程序包必须包含一个catkin 版本的CMakeLists.txt文件，而Catkin metapackages中必须包含一个对CMakeList.txt文件的引用。

每个目录下只能有一个程序包。

这意味着在同一个目录下不能有嵌套的或者多个程序包存在。

　　　　最简单的程序包也许看起来就像这样：

my_package/
CMakeLists.txt
package.xml

　　2.在catkin工作空间中的程序包

　　开发catkin程序包的一个推荐方法是使用catkin工作空间，但是你也可以单独开发(standalone)catkin 软件包。一个简单的工作空间也许看起来像这样：

workspace_folder/        -- WORKSPACE
src/                   -- SOURCE SPACE
CMakeLists.txt       -- 'Toplevel' CMake file, provided by catkin
package_1/
CMakeLists.txt     -- CMakeLists.txt file for package_1
package.xml        -- Package manifest for package_1
...
package_n/
CMakeLists.txt     -- CMakeLists.txt file for package_n
package.xml        -- Package manifest for package_n

　　在继续本教程之前请先按照创建catkin工作空间教程创建一个空白的catkin工作空间。

　　3.创建一个catkin程序包

　　本部分教程将演示如何使用catkin_create_pkg命令来创建一个新的catkin程序包以及创建之后都能做些什么。

　　首先切换到之前通过创建catkin工作空间教程创建的catkin工作空间中的src目录下：

# You should have created this in the Creating a Workspace Tutorial
root@zxwubuntu-Aspire-V3-572G: cd ~/catkin_ws/src

　　现在使用catkin_create_pkg命令来创建一个名为'beginner_tutorials'的新程序包，这个程序包依赖于std_msgs、roscpp和rospy：

root@zxwubuntu-Aspire-V3-572G: catkin_create_pkg beginner_tutorials std_msgs rospy roscpp

　　这将会创建一个名为beginner_tutorials的文件夹，这个文件夹里面包含一个package.xml文件和一个CMakeLists.txt文件，这两个文件都已经自动包含了部分你在执行catkin_create_pkg命令　　　　时提供的信息。



　　catkin_create_pkg命令会要求你输入package_name，如果有需要你还可以在后面添加一些需要依赖的其它程序包：

# This is an example, do not try to run this
# catkin_create_pkg <package_name> [depend1] [depend2] [depend3]

　　catkin_create_pkg命令也有更多的高级功能，这些功能在catkin/commands/catkin_create_pkg中有描述。

　　4.程序包依赖关系

　　4.1.一级依赖

　　之前在使用catkin_create_pkg命令时提供了几个程序包作为依赖包，现在我们可以使用rospack命令工具来查看一级依赖包。

Jan 9, 2013) There is a bug reported and already fixed in rospack in groovy, which takes sometime until the change gets reflected on your computer. If you see a similar issue like this with the next command, you can skip to the next command.

root@zxwubuntu-Aspire-V3-572G: rospack depends1 beginner_tutorials

　　就像你看到的，rospack列出了在运行catkin_create_pkg命令时作为参数的依赖包，这些依赖包随后保存在package.xml文件中。

root@zxwubuntu-Aspire-V3-572G: roscd beginner_tutorials
root@zxwubuntu-Aspire-V3-572G: cat package.xml

　　4.2.间接依赖

　　(Jan 9, 2013) There is a bug reported and already fixed in rospack in groovy, which takes sometime until the change gets reflected on your computer. If you see a similar issue like this with the next command, you can skip to the next command.

root@zxwubuntu-Aspire-V3-572G: rospack depends1 rospy

一个程序包还可以有好几个间接的依赖包，幸运的是使用rospack可以递归检测出所有的依赖包。

root@zxwubuntu-Aspire-V3-572G: rospack depends beginner_tutorials

cpp_common
rostime
roscpp_traits
roscpp_serialization
genmsg
genpy
message_runtime
rosconsole
std_msgs
rosgraph_msgs
xmlrpcpp
roscpp
rosgraph
catkin
rospack
roslib
rospy

　　5.自定义你的程序包

　　本部分教程将剖析catkin_create_pkg命令生成的每个文件并详细描述这些文件的组成部分以及如何自定义这些文件。

　　5.1.自定义 package.xml

　　自动生成的package.xml文件应该在你的新程序包中。现在让我们一起来看看新生成的package.xml文件以及每一个需要你注意的标签元素。

　　首先用vim编辑器打开package.xml

　　

root@zxwubuntu-Aspire-V3-572G: vim package.xml

　　5.1.1.描述标签：：

　　　　


　　　　将描述信息修改为任何你喜欢的内容，但是按照约定第一句话应该简短一些，因为它覆盖了程序包的范围。如果用一句话难以描述完全那就需要换行了

　　5.1.2.维护者标签：：

　　　　


　　　　这是package.xml中要求填写的一个重要标签，因为它能够让其他人联系到程序包的相关人员。至少需要填写一个维护者名称，但如果有需要的话你可以添加多个。除了在标签里面填写维护者的名称　　　　外，还应该在标签的email属性中填写邮箱地址：

　　5.1.3.许可标签::

　　　　


　　　　你应该选择一种许可协议并将它填写到这里。一些常见的开源许可协议有BSD、MIT、Boost Software License、GPLv2、GPLv3、LGPLv2.1和LGPLv3。你可以在Open Source Initiative中阅读其中　　　　的若干个许可协议的相关信息。对于本教程我们将使用BSD协议，因为ROS核心组件的剩余部分已经使用了该协议：

　　5.1.4.依赖项标签::

　　　　


　　　　除了catkin中默认提供的buildtool_depend，所有我们列出的依赖包都已经被添加到build_depend标签中。在本例中，因为在编译和运行时我们需要用到所有指定的依赖包，因此还需要将每一个　　　　依赖包分别添加到run_depend标签中：去掉注释和没有的依赖 后最终的文件内容：：

　　　　

1 <?xml version="1.0"?>
2 <package>
3   <name>beginner_tutorials</name>
4   <version>0.1.0</version>
5   <description>The beginner_tutorials package</description>
6
7   <maintainer email="you@yourdomain.tld">Your Name</maintainer>
8   <license>BSD</license>
9   <url type="website">http://wiki.ros.org/beginner_tutorials</url>
10   <author email="you@yourdomain.tld">Jane Doe</author>
11
12   <buildtool_depend>catkin</buildtool_depend>
13
14   <build_depend>roscpp</build_depend>
15   <build_depend>rospy</build_depend>
16   <build_depend>std_msgs</build_depend>
17
18   <run_depend>roscpp</run_depend>
19   <run_depend>rospy</run_depend>
20   <run_depend>std_msgs</run_depend>
21
22 </package

　　5.2.自定义 CMakeLists.txt

到此，这个包含程序包元信息的package.xml文件已经按照需要完成了裁剪整理，现在你可以继续下面的教程了。catkin_create_pkg命令生成的CMakeLists.txt文件将在后续关于编译ROS程序代码的教程中讲述。

现在你已经创建了一个新的ROS程序包，接下来我们开始编译这个程序包