ROS创建工作空间和功能包

    所有的ROS程序，包括我们自己开发的程序，都被组织成功能包，而ROS的功能包被存放在称之为工作空间的目录下。因此，在我们写程序之前，第一步是创建一个工作空间以容纳我们的功能包。

1.创建ROS工作空间

    其实ROS工作空间就是linux下的一个目录，创建ROS工作空间就是创建一个linux目录，只是需要按照ROS的规范在这个目录下添加一个src的子目录，然后执行一个ROS的命令即可。

    我们创建名为catkin_ws的工作空间，当然也可以使用其它名字，命令如下：

$mkdir -p catkin_ws/src

    进入到catkin_ws/src目录下，可以看到catkin_ws和src目录下都是空的。进入到catkin_ws目录下，再执行如下命令：

$catkin_make

    这个命令用于构建该工作空间，并且必须在工作空间的顶层使用catkin_make命令，这时你会发现在catkin_ws这个目录下多出两个目录“build”和“devel”。在devel目录下，还可以看到很多setup.*sh文件。接下来我们输入如下命令：

$source devel/setup.bash

    上面的命令是在catkin_ws目录下执行的，意思是把catkin_ws/devel目录下的setup.bash文件挂载到ROS的文件系统里去，这样当用户执行一些文件系统的命令时，就不会提示找不到

该工作空间里的包或者文件了。

小提示：

    对于许多用户来说,确实没有必要使用多个 ROS 工作空间。但是,ROS 的 catkin 编译系统,试图一次性编译同一个工作空间中的所有功能包。因此,如果你的工作涉及大量的功能包,或者涉及几个相互独立的的项目,则维护数个独立的工作空间可能是有帮助的。

2.创建ROS功能包

    创建了工作空间，接下来就可以在工作空间里创建功能包。

功能包是一个存在于工作空间目录src目录下的一个目录，这个目录中包含一些文件或者目录，一个功能包必须以下几部分组成：

(1) 必须包括一个package.xml文件;

(2) 必须包括一个CMakeLists.txt文件。

    在每一个功能包目录下不允许有其它的功能包，也就是不允许功能包嵌套。一个典型的工作空间结构如下：

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_ws，下面我们来看一下如何在一个工作空间中创建一个功能包。在创建功能包时需要使用catkin_create_pkg命令。

    首先进入到目录catkin_ws/src目录下，创建一个名字为beginner_tutorials的功能包，它直接依赖于三个功能包：std_msgs,rospy以及roscpp，使用如下命令：

$catkin_create_pkg beginner_tutorials std_msgs rospy roscpp

    在创建的beginner_tutorials文件夹下可以看到package.xml和CMakeLists.txt。catkin_create_pkg要求您给出功能包的名字，及选择性的给出所创建的功能包依赖于哪一个功能包，命令的使用方法如下：

catkin_create_pkg <package_name> [depend1] [depend2] [depend3]

    这样，我们的一个包功能就创建好了，我们可能会需要对功能包之间的依赖性做一下解释。我们可以使用rospack命令来查看功能包之间的依赖关系（使用rospack命令的前提是已经安装了该命令）。

    查看直接依赖关系：

$rospack depends1 beginner_tutorials

    可以看到，返回的结果正是我们使用catkin_create_pkg时，所使用的参数。

roscpp
rospy
std_msgs

    我们还可以直接在beginner_tutorials功能包下的package.xml中查看功能包的依赖关系。使用命令：

$cd beginner_tutorials  

$cat package.xml

    结果如下：

<package>
...
<buildtool_depend>catkin</buildtool_depend>
<build_depend>roscpp</build_depend>
<build_depend>rospy</build_depend>
<build_depend>std_msgs</build_depend>
...
</package>

    在通常情况下，一个包所依赖的包又会依赖许多其它的包，这称为间接依赖。我们使用如下命令来查看rospy直接依赖的功能包：

$rospack depends1 rospy

    返回结果如下：

genpy
rosgraph
rosgraph_msgs
roslib
std_msgs

    一个功能包可以有很多的间接依赖关系，我们可以使用命令：

$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

    接下来我们查看package.xml文件，我们将会一个标签一个标签的分析这个xml文件。

    首先是description标签：

<description>The beginner_tutorials package</description>
    这个标签是对功能包的一个简单描述。

    maintainer标签：

<!-- One maintainer tag required, multiple allowed, one person per tag -->
<!-- Example:  -->
<!-- <maintainer email="jane.doe@example.com">Jane Doe</maintainer> -->
<maintainer email="user@todo.todo">user</maintainer>

    根据这个标签知道它的维护者，另外标签的email属性也是必须的，可有多个maintainer标签。

    license标签：

<!-- One license tag required, multiple allowed, one license per tag -->
<!-- Commonly used license strings: -->
<!--   BSD, MIT, Boost Software License, GPLv2, GPLv3, LGPLv2.1, LGPLv3 -->
<license>TODO</license>

    一般我们将license修改为BSD。

    编译依赖性和运行依赖性标签，指明了该功能包所依赖的其它功能包，如果我们在使用catkin_create_pkg命令创建功能包的时候，没有制定我们创建的功能包依赖于哪些功能包，可以手动在这里添加依赖的功能包：

<!-- The *_depend tags are used to specify dependencies -->
<!-- Dependencies can be catkin packages or system dependencies -->
<!-- Examples: -->
<!-- Use build_depend for packages you need at compile time: -->
<!--   <build_depend>genmsg</build_depend> -->
<!-- Use buildtool_depend for build tool packages: -->
<!--   <buildtool_depend>catkin</buildtool_depend> -->
<!-- Use run_depend for packages you need at runtime: -->
<!--   <run_depend>python-yaml</run_depend> -->
<!-- Use test_depend for packages you need only for testing: -->
<!--   <test_depend>gtest</test_depend> -->
<buildtool_depend>catkin</buildtool_depend>
<build_depend>roscpp</build_depend>
<build_depend>rospy</build_depend>
<build_depend>std_msgs</build_depend>
run_depend>roscpp</run_depend>
<run_depend>rospy</run_depend>
<run_depend>std_msgs</run_depend>

    这样一来，功能包就创建好了，可以在功能包目录下添加你的源代码文件了。

小提示：

    ROS功能包的命名遵循一个命名规范,只允许使用小写字母、数字和下划线,而且首字符必须是一个小写字母。一些 ROS工具,包括 catkin,不支持那些不遵循此命名规范的功能包。