转:CMake快速入门教程-实战

时间  2019-11-18
标签 cmake 快速 入门 教程 实战 繁體版
原文   原文链接
CMake快速入门教程：实战
收藏人：londonKu    
2012-05-07 | 阅：10128  转：34  
 |    来源
  |  分享 
 
 
 
  
 
 

0. 前言
一个多月前，因为工程项目的须要，匆匆的学习了一下cmake的使用方法，如今有时间拿出来整理一下。本文假设你已经学会了cmake的使用方法，若是你还不会使用cmake，请参考相关资料以后再继续向下看。
本文中介绍的是生成可执行程序的方法和步骤，生成动态库和静态库的方法与此有所不一样，随后会介绍动态库和静态库项目中cmake的编写方法。
本文参考《CMake Practice》这篇文章完成，旨在指导用户快速使用CMake，若是须要更详细的内容，请通读《CMake Practice》这篇文章。下载路径：http://sewm.pku.edu.cn/src/paradise/reference/CMake%20Practice.pdf
1. 项目目录结构
咱们项目的名称为CRNode，假设咱们项目的全部文件存放再~/workspace/CRNode，以后没有特殊说明的话，咱们所指的目录都以此目录为相对路径。
咱们的目录结构以下：css

~/workspace/CRNode
  ├─ src
  │  ├─ rpc
  │  │  ├─ CRMasterCaller.h
  │  │  ├─ CRMasterCaller.cc
  │  │  ├─ CRNode.h
  │  │  ├─ CRNode.cc
  │  │  ├─ Schd_constants.h
  │  │  ├─ Schd_constants.cc
  │  │  ├─ CRMaster.h
  │  │  ├─ CRMaster.cc
  │  │  ├─ CRNode_server.skeleton.h
  │  │  ├─ CRNode_server.skeleton.cc
  │  │  ├─ Schd_types.h
  │  │  └─ Schd_types.cc
  │  ├─ task
  │  │  ├─ TaskExecutor.h
  │  │  ├─ TaskExecutor.cc
  │  │  ├─ TaskMonitor.h
  │  │  └─ TaskMonitor.cc
  │  ├─ util
  │  │  ├─ Const.h
  │  │  ├─ Const.cc
  │  │  ├─ Globals.h
  │  │  ├─ Globals.cc
  │  │  ├─ Properties.h
  │  │  ├─ Properties.cc
  │  │  ├─ utils.h
  │  │  └─ utils.cc
  │  ├─ main.cc
  │  └─ CMakeLists.txt
  ├─ doc
  │  └─ crnode.txt
  ├─ COPYRIGHT
  ├─ README
  ├─ crnode.sh
  └─ CMakeLists.txt

其中，src存放源代码文件和一个CMakeLists.txt文件，CMakeLists文件的编写咱们稍候介绍；doc目录中存放项目 的帮助文档，该文档以及COPYRIGHT和README一块儿安装到/usr/share/doc/crnode目录中；COPYRIGHT文件存放项目 的版权信息，README存放一些说明性文字；crnode.sh存放CRNode的启动命令；CMakeLists.txt文件稍候介绍。
除此以外，项目还依赖两个外部库：Facebook开发的thrift库，其头文件存放在/usr/include/thrift目录中；log4cpp库，其头文件存放再/usr/include下。
2. CMakeLists.txt文件
本工程中使用了两个CMakeLists.txt文件，分别项目的根目录（即~/workspace/CRNode目录，下同）和src目录中 （参考以上目录结构）。咱们先给出两个CMakeLists.txt的内容，在下一节中再对两个CMakeLists.txt进行详细介绍。两个 CMakeLists.txt文件的内容分别以下：
2.1 根目录中CMakeLists内容html

1
2
3
4
5
6
7
8
9
10
11
12
13
14
 
cmake_minimum_required (VERSION 2.6)

project (CRNode)

ADD_SUBDIRECTORY(src bin)

#SET(CMAKE_INSTALL_PREFIX ${PROJECT_BINARY_DIR})
SET(CMAKE_INSTALL_PREFIX /usr/local)

INSTALL(PROGRAMS crnode.sh DESTINATION bin)

INSTALL(FILES COPYRIGHT README DESTINATION share/doc/crnode)

INSTALL(DIRECTORY doc/ DESTINATION share/doc/crnode)

2.2 src/CMakeLists.txt内容node

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
 
INCLUDE_DIRECTORIES(/usr/include/thrift)

SET(SRC_LIST main.cc
        rpc/CRMasterCaller.cpp
        rpc/CRNode_server.skeleton.cpp
        rpc/Schd_constants.cpp
        rpc/CRMaster.cpp
        rpc/CRNode.cpp
        rpc/Schd_types.cpp
        task/TaskExecutor.cpp
        task/TaskMoniter.cpp
        util/Const.cpp
        util/Globals.cc
        util/utils.cc
        util/Properties.cpp
        )

ADD_EXECUTABLE(crnode ${SRC_LIST})

TARGET_LINK_LIBRARIES(crnode log4cpp thrift)

INSTALL(TARGETS crnode
        RUNTIME DESTINATION bin
)

3. CMake语法
A. 变量使用${}方式取值,可是在 IF 控制语句中是直接使用变量名；
B. 指令(参数 1 参数 2…)，参数使用括弧括起,参数之间使用空格或分号分开；
C. 指令是大小写无关的,参数和变量是大小写相关的。但,推荐你所有使用大写指令。学习

4. CMakeLists.txt剖析
4.1 cmake_minimum_required命令ui

1
 
cmake_minimum_required (VERSION 2.6)

规定cmake程序的最低版本。这行命令是可选的，咱们能够不写这句话，但在有些状况下，若是CMakeLists.txt文件中使用了一些高版本cmake特有的一些命令的时候，就须要加上这样一行，提醒用户升级到该版本以后再执行cmake。spa

4.2 project命令component

3
 
project (CRNode)

指定项目的名称。项目最终编译生成的可执行文件并不必定是这个项目名称，而是由另外一条命令肯定的，稍候咱们再介绍。
可是这个项目名称仍是必要的，在cmake中有两个预约义变量：< projectname >_BINARY_DIR以及< projectname >_SOURCE_DIR，在咱们的项目中，两个变量分别为：CRNode_BINARY_DIR和CRNode_SOURCE_DIR。内部编译 状况下二者相同，后面咱们会讲到外部编译,二者所指代的内容会有所不一样。要理解这两个变量的定义，咱们首先须要了解什么是“外部构建（out-of- source build）”，咱们将在下一小节中介绍“外部构建”。
同时cmake还预约义了PROJECT_BINARY_DIR和PROJECT_SOURCE_DIR变量。在咱们的项目 中，PROJECT_BINARY_DIR等同于CRNode_BINARY_DIR，PROJECT_SOURCE_DIR等同于 CRNode_SOURCE_DIR。在实际的应用用，我强烈推荐使用PROJECT_BINARY_DIR和PROJECT_SOURCE_DIR变 量，这样即便项目名称发生变化也不会影响CMakeLists.txt文件。server

4.3 外部构建
假设咱们此时已经完成了两个CMakeLists.txt文件的编写，能够执行cmake命令生成Makefile文件了。此时咱们由两种方法能够执行cmake、编译和安装：htm

1
2
 
cmake .
make

或者blog

1
2
3
4
 
mkdir build
cd build
cmake ..
make

两种方法最大的不一样在于执行cmake和make的工做路径不一样。第一种方法中，cmake生成的全部中间文件和可执行文件都会存放在项目 目录中；而第二种方法中，中间文件和可执行文件都将存放再build目录中。第二种方法的优势显而易见，它最大限度的保持了代码目录的整洁。同时因为第二 种方法的生成、编译和安装是发生在不一样于项目目录的其余目录中，因此第二种方法就叫作“外部构建”。
回到以前的疑问，再外部构建的状况下，PROJECT_SOURCE_DIR指向的目录同内部构建相同，仍然为~/workspace /CRNode，而PROJECT_BINARY_DIR则有所不一样，指向~/workspace/CRNode/build目录。
固然，cmake强烈推荐使用外部构建的方法。

4.4 ADD_SUBDIRECTORY命令

5
 
ADD_SUBDIRECTORY(src bin)

ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])这个指令用于向当前工程添加存放源文件的子目录,并能够指定中间二进制和目标二进制存放的位置。 EXCLUDE_FROM_ALL 参数的含义是将这个目录从编译过程当中排除。好比,工程的 example,可能就须要工程构建完成后,再进入 example 目录单独进行构建。
在咱们的项目中，咱们添加了src目录到项目中，而把对应于src目录生成的中间文件和目标文件存放到bin目录下，在上一节举例中“外部构建”的状况下，中间文件和目标文件将存放在build/srcobj目录下。

4.5 SET命令

8
 
SET(CMAKE_INSTALL_PREFIX /usr/local)

现阶段,只须要了解SET命令能够用来显式的定义变量便可。在以上的例子中，咱们显式的将CMAKE_INSTALL_PREFIX的值定 义为/usr/local，如此在外部构建状况下执行make install命令时，make会将生成的可执行文件拷贝到/usr/local/bin目录下。
固然，可执行文件的安装路径CMAKE_INSTALL_PREFIX也能够在执行cmake命令的时候指定，cmake参数以下：

cmake -DCMAKE_INSTALL_PREFIX=/usr ..

若是cmake参数和CMakeLists.txt文件中都不指定该值的话，则该值为默认的/usr/local。

4.6 INCLUDE_DIRECTORIES命令

1
 
INCLUDE_DIRECTORIES(/usr/include/thrift)

INCLUDE_DIRECTORIES相似gcc中的编译参数“-I”，指定编译过程当中编译器搜索头文件的路径。当项目须要的头文件不在 系统默认的搜索路径时，须要指定该路径。在咱们的项目中，log4cpp所需的头文件都存放在/usr/include下，不须要指定；但thrift的 头文件没有存放在系统路径下，须要指定搜索其路径。

4.7 ADD_EXECUTABLE和ADD_LIBRARY

3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
 
SET(SRC_LIST main.cc
        rpc/CRMasterCaller.cpp
        rpc/CRNode_server.skeleton.cpp
        rpc/Schd_constants.cpp
        rpc/CRMaster.cpp
        rpc/CRNode.cpp
        rpc/Schd_types.cpp
        task/TaskExecutor.cpp
        task/TaskMoniter.cpp
        util/Const.cpp
        util/Globals.cc
        util/utils.cc
        util/Properties.cpp
        )

ADD_EXECUTABLE(CRNode ${SRC_LIST})

ADD_EXECUTABLE定义了这个工程会生成一个文件名为 CRNode 的可执行文件,相关的源文件是 SRC_LIST 中定义的源文件列表。须要注意的是，这里的CRNode和以前的项目名称没有任何关系，能够任意定义。

4.8 EXECUTABLE_OUTPUT_PATH和LIBRARY_OUTPUT_PATH
咱们能够经过 SET 指令从新定义 EXECUTABLE_OUTPUT_PATH 和 LIBRARY_OUTPUT_PATH 变量来指定最终的目标二进制的位置(指最终生成的CRNode可执行文件或者最终的共享库，而不包含编译生成的中间文件)。
命令以下：

SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)

须要注意的是，在哪里 ADD_EXECUTABLE 或 ADD_LIBRARY,若是须要改变目标存放路径,就在哪里加入上述的定义。

4.9 TARGET_LINK_LIBRARIES命令

20
 
TARGET_LINK_LIBRARIES(CRNode log4cpp thrift)

这句话指定在连接目标文件的时候须要连接的外部库，其效果相似gcc的编译参数“-l”，能够解决外部库的依赖问题。

4.10 INSTALL命令
在执行INSTALL命令的时候须要注意CMAKE_INSTALL_PREFIX参数的值。该参数在3.5中已经有所介绍。其命令形式以下：

INSTALL(TARGETS targets...
	[[ARCHIVE|LIBRARY|RUNTIME]
	[DESTINATION < dir >]
	[PERMISSIONS permissions...]
	[CONFIGURATIONS
	[Debug|Release|...]]
	[COMPONENT < component >]
	[OPTIONAL]
	] [...])

参数中的 TARGETS 后面跟的就是咱们经过 ADD_EXECUTABLE 或者 ADD_LIBRARY 定义的目标文件,多是可执行二进制、动态库、静态库。
DESTINATION 定义了安装的路径,若是路径以/开头,那么指的是绝对路径,这时候CMAKE_INSTALL_PREFIX 其实就无效了。若是你但愿使用 CMAKE_INSTALL_PREFIX 来定义安装路径,就要写成相对路径,即不要以/开头,那么安装后的路径就是${CMAKE_INSTALL_PREFIX} /< destination 定义的路径>
你不须要关心 TARGETS 具体生成的路径,只须要写上 TARGETS 名称就能够了。
非目标文件的可执行程序安装(好比脚本之类):

INSTALL(PROGRAMS files... DESTINATION < dir >
	[PERMISSIONS permissions...]
	[CONFIGURATIONS [Debug|Release|...]]
	[COMPONENT < component >]
	[RENAME < name >] [OPTIONAL])

跟上面的 FILES 指令使用方法同样,惟一的不一样是安装后权限为OWNER_EXECUTE, GROUP_EXECUTE, 和 WORLD_EXECUTE,即 755 权限目录的安装。
安装一个目录的命令以下：

INSTALL(DIRECTORY dirs... DESTINATION < dir >
	[FILE_PERMISSIONS permissions...]
	[DIRECTORY_PERMISSIONS permissions...]
	[USE_SOURCE_PERMISSIONS]
	[CONFIGURATIONS [Debug|Release|...]]
	[COMPONENT < component >]
	[[PATTERN < pattern > | REGEX < regex >]
	[EXCLUDE] [PERMISSIONS permissions...]] [...])

DIRECTORY 后面链接的是所在 Source 目录的相对路径,但务必注意:abc 和 abc/有很大的区别。若是目录名不以/结尾,那么这个目录将被安装为目标路径下的 abc,若是目录名以/结尾,表明将这个目录中的内容安装到目标路径,但不包括这个目录自己。咱们来看一个例子:

1
2
3
4
5
 
INSTALL(DIRECTORY icons scripts/ DESTINATION share/myproj
	PATTERN "CVS" EXCLUDE
	PATTERN "scripts/*"
	PERMISSIONS OWNER_EXECUTE OWNER_WRITE OWNER_READ
	GROUP_EXECUTE GROUP_READ)

这条指令的执行结果是:
将 icons 目录安装到 < prefix >/share/myproj,将 scripts/中的内容安装到< prefix >/share/myproj，不包含目录名为 CVS 的目录,对于 scripts/*文件指定权限为 OWNER_EXECUTE OWNER_WRITE OWNER_READ GROUP_EXECUTE GROUP_READ。
由于crnode.txt 要安装到/< prefix >/share/doc/crnode,因此咱们不能直接安装整个 doc 目录,这里采用的方式是安装 doc 目录中的内容,也就是使用”doc/”在工程文件中添加:

1
 
INSTALL(DIRECTORY doc/ DESTINATION share/doc/crnode)

5. 编译安装
编译安装结果以下：

[root@sim91 build]# cmake ..
-- Configuring done
-- Generating done
-- Build files have been written to: /home/fify/workspace/CRNode/build

[root@sim91 build]# make
Scanning dependencies of target crnode
[  7%] Building CXX object srcobj/CMakeFiles/crnode.dir/main.cc.o
[ 15%] Building CXX object srcobj/CMakeFiles/crnode.dir/rpc/CRMasterCaller.cpp.o
[ 23%] Building CXX object srcobj/CMakeFiles/crnode.dir/rpc/CRNode_server.skeleton.cpp.o
[ 30%] Building CXX object srcobj/CMakeFiles/crnode.dir/rpc/Schd_constants.cpp.o
[ 38%] Building CXX object srcobj/CMakeFiles/crnode.dir/rpc/CRMaster.cpp.o
[ 46%] Building CXX object srcobj/CMakeFiles/crnode.dir/rpc/CRNode.cpp.o
[ 53%] Building CXX object srcobj/CMakeFiles/crnode.dir/rpc/Schd_types.cpp.o
[ 61%] Building CXX object srcobj/CMakeFiles/crnode.dir/task/TaskExecutor.cpp.o
[ 69%] Building CXX object srcobj/CMakeFiles/crnode.dir/task/TaskMoniter.cpp.o
[ 76%] Building CXX object srcobj/CMakeFiles/crnode.dir/util/Const.cpp.o
[ 84%] Building CXX object srcobj/CMakeFiles/crnode.dir/util/Globals.cc.o
[ 92%] Building CXX object srcobj/CMakeFiles/crnode.dir/util/utils.cc.o
[100%] Building CXX object srcobj/CMakeFiles/crnode.dir/util/Properties.cpp.o
Linking CXX executable crnode

[root@sim91 build]# make install
[100%] Built target crnode
Install the project...
-- Install configuration: ""
-- Installing: /usr/local/bin/crnode.sh
-- Installing: /usr/local/share/doc/crnode/COPYRIGHT
-- Installing: /usr/local/share/doc/crnode/README
-- Installing: /usr/local/share/doc/crnode
-- Installing: /usr/local/share/doc/crnode/crnode.txt
-- Installing: /usr/local/bin/crnode

大功告成！更多内容请参考《CMake Practice》，再次对《CMake Practice》的做者表示感谢！
相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程