Cmake 的使用

布满荆棘的人生 2022-05-26 05:05 196阅读 0赞

参考出处：

IBM的developerWorks:

https://www.ibm.com/developerworks/cn/linux/l-cn-cmake/

1、CMake 简介

2、多源文件目录处理

3、工程中查找并使用其它库

4、使用cmake 生成Debug和Release 版本

5、附一个Cmakelist.txt

linux 安装cmake，

sudo apt-get install cmake

## CMake 简介 ##

CMake 是一个跨平台的自动化建构系统,它使用一个名为 CMakeLists.txt 的文件来描述构建过程,可以产生标准的构建文件,如 Unix 的 Makefile 或Windows Visual C++ 的 projects/workspaces 。文件 CMakeLists.txt 需要手工编写,也可以通过编写脚本进行半自动的生成。CMake 提供了比 autoconfig 更简洁的语法。在 linux 平台下使用 CMake 生成 Makefile 并编译的流程如下:

1.  `编写``CmakeLists.txt``。```
2.  `执行命令“cmake PATH”或者“ccmake PATH”生成 Makefile ( PATH 是 CMakeLists.txt 所在的目录 )。`
3.  `使用 make 命令进行编译。`

## `第一个工程` ##

`现假设我们的项目中只有一个源文件 main.cpp`

##### `清单 1 源文件 main.cpp` #####

为了构建该项目,我们需要编写文件 CMakeLists.txt 并将其与 main.cpp 放在 同一个目录下:

##### 清单 2 CMakeLists.txt #####

CMakeLists.txt 的语法比较简单,由命令、注释和空格组成,其中命令是不区分大小写的,符号"\#"后面的内容被认为是注释。命令由命令名称、小括号和参数组成,参数之间使用空格进行间隔。例如对于清单2的 CMakeLists.txt 文件:第一行是一条命令,名称是 PROJECT ,参数是 main ,该命令表示项目的名称是 main 。第二行的命令限定了 CMake 的版本。第三行使用命令 AUX\_SOURCE\_DIRECTORY 将当前目录中的源文件名称赋值给变量 DIR\_SRCS 。 CMake 手册中对命令 AUX\_SOURCE\_DIRECTORY 的描述如下:

该命令会把参数 <dir> 中所有的源文件名称赋值给参数 <variable> 。 第四行使用命令 ADD\_EXECUTABLE 指示变量 DIR\_SRCS 中的源文件需要编译 成一个名称为 main 的可执行文件。

完成了文件 CMakeLists.txt 的编写后需要使用 cmake 或 ccmake 命令生成Makefile 。 ccmake 与命令 cmake 的不同之处在于 ccmake 提供了一个图形化的操作界面。cmake 命令的执行方式如下:

这里我们进入了 main.cpp 所在的目录后执行 “cmake .” 后就可以得到 Makefile 并使用 make 进行编译,如下图所示。

##### 图 1. camke 的运行结果 #####

![camke 的运行结果][camke]

## 处理多源文件目录的方法 ##

`CMake``处理源代码分`布在不同目录中的情况也十分简单。现假设我们的源代码`分布情况如下``:`

##### 图 2. 源代码分布情况 #####

![源代码分布情况][step2-files.JPG]

其中 src 目录下的文件要编译成一个链接库。

### 第一步，项目主目录中的 CMakeLists.txt ###

在目录 step2 中创建文件 CMakeLists.txt 。文件内容如下:

##### 清单 3 目录 step2 中的 CMakeLists.txt #####

相对于清单 2，该文件添加了下面的内容: 第三行，使用命令 ADD\_SUBDIRECTORY 指明本项目包含一个子目录 src 。第六行，使用命令 TARGET\_LINK\_LIBRARIES 指明可执行文件 main 需要连接一个名为Test的链接库 。

### 第二步，子目录中的 CmakeLists.txt ###

在子目录 src 中创建 CmakeLists.txt。文件内容如下:

##### 清单 4. 目录 src 中的 CmakeLists.txt #####

在该文件中使用命令 ADD\_LIBRARY 将 src 目录中的源文件编译为共享库。

### 第三步，执行 cmake ###

至此我们完成了项目中所有 CMakeLists.txt 文件的编写,进入目录 step2 中依次执行命令 “cmake .” 和 “make” 得到结果如下:

##### 图3. 处理多源文件目录时 cmake 的执行结果 #####

![处理多源文件目录时 cmake 的执行结果][cmake]

在执行 cmake 的过程中,首先解析目录 step2 中的 CMakeLists.txt ,当程序执行命令 ADD\_SUBDIRECTORY( src ) 时进入目录 src 对其中的 CMakeLists.txt 进行解析。

## 在工程中查找并使用其他程序库的方法 ##

在开发软件的时候我们会用到一些函数库,这些函数库在不同的系统中安装的位置可能不同,编译的时候需要首先找到这些软件包的头文件以及链接库所在的目录以便生成编译选项。例如一个需要使用博克利数据库项目,需要头文件db\_cxx.h 和链接库 libdb\_cxx.so ,现在该项目中有一个源代码文件 main.cpp ，放在项目的根目录中。

### 第一步，程序库说明文件 ###

在项目的根目录中创建目录 cmake/modules/ ，在 cmake/modules/ 下创建文件 Findlibdb\_cxx.cmake ，内容如下：

##### 清单 5. 文件 Findlibdb\_cxx.cmake #####

<table style="width:940px;font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px 0px 30px;padding:0px;vertical-align:baseline;background:none;border:0px;float:none;height:auto;"> 
 <tbody style="margin:0px;padding:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;"> 
  <tr style="margin:0px;padding:0px;vertical-align:baseline;background:none;border-top:0px;float:none;height:auto;width:auto;"> 
   <td style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;vertical-align:baseline;background:none;border-width:0px;float:none;height:auto;width:auto;color:rgb(112,112,112);"> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      1 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      2 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      3 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      4 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      5 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      6 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      7 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      8 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      9 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      10 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      11 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      12 
    </div></td> 
   <td style="width:899px;font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;vertical-align:baseline;background:none;border-width:0px;float:none;height:auto;"> 
    <div style="margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;"> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">01 MESSAGE(STATUS "Using bundled Findlibdb.cmake...")</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">0203 FIND_PATH(</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">04&nbsp;&nbsp; LIBDB_CXX_INCLUDE_DIR</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">05&nbsp;&nbsp; db_cxx.h </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">06&nbsp;&nbsp; /usr/include/ </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">07&nbsp;&nbsp; /usr/local/include/ </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">08&nbsp;&nbsp; )</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">09 </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">10 FIND_LIBRARY(</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">11&nbsp;&nbsp; LIBDB_CXX_LIBRARIES NAMES&nbsp; db_cxx</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">12&nbsp;&nbsp; PATHS /usr/lib/ /usr/local/lib/</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">13&nbsp;&nbsp; )</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

文件 Findlibdb\_cxx.cmake 的命名要符合规范: FindlibNAME.cmake ,其中NAME 是函数库的名称。Findlibdb\_cxx.cmake 的语法与 CMakeLists.txt 相同。这里使用了三个命令： MESSAGE ， FIND\_PATH 和 FIND\_LIBRARY 。

`` `命令` `MESSAGE` `会` `将参数` `的内容` `输出到终端` `。` `命令` `FIND_PATH` `指明头文件查找的路径，` `原型如下` `：` `find_path(<VAR> name1 [path1 path2 ...])` `该命令在参数` `path*` `指示的目录中查找文件` `name1` `并将查找到的路径保存在变量` `VAR` `中。清单` `5` `第` `3` `－` `8` `行的意思是在` `/usr/include/` `和` `/usr/local/include/` `中查找文件` `db_cxx.h ,` `并将` `db_cxx.h 所在的路径保存在 LIBDB_CXX_INCLUDE_DIR中。` `命令 FIND_LIBRARY 同 FIND_PATH 类似,用于查找链接库并将结果保存在变量中。清单5第10－13行的意思是在目录 /usr/lib/和 /usr/local/lib/ 中寻找名称为 db_cxx 的链接库,并将结果保存在 LIBDB_CXX_LIBRARIES。`

### `第二步, 项目的根目录中的 CmakeList.txt` ###

`在项目的根目录中创建 CmakeList.txt ：`

##### `清单 6. 可以查找链接库的 CMakeList.txt` #####

<table style="width:940px;font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px 0px 30px;padding:0px;vertical-align:baseline;background:none;border:0px;float:none;height:auto;"> 
 <tbody style="margin:0px;padding:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;"> 
  <tr style="margin:0px;padding:0px;vertical-align:baseline;background:none;border-top:0px;float:none;height:auto;width:auto;"> 
   <td style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;vertical-align:baseline;background:none;border-width:0px;float:none;height:auto;width:auto;color:rgb(112,112,112);"> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      1 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      2 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      3 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      4 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      5 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      6 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      7 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      8 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      9 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      10 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      11 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      12 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      13 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      14 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      15 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      16 
    </div> 
    <div style="margin:0px;padding:0px .5em 0px 1em;border-width:0px 3px 0px 0px;border-right-style:solid;border-right-color:rgb(0,118,112);vertical-align:baseline;background-image:none;float:none;height:auto;text-align:right;width:auto;white-space:pre;">
      17 
    </div></td> 
   <td style="width:899px;font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;vertical-align:baseline;background:none;border-width:0px;float:none;height:auto;"> 
    <div style="margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;"> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">01 PROJECT(main)</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">02 CMAKE_MINIMUM_REQUIRED(VERSION 2.6)</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">03 SET(CMAKE_SOURCE_DIR .)</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">04 SET(CMAKE_MODULE_PATH ${CMAKE_ROOT}/Modules ${CMAKE_SOURCE_DIR}/cmake/modules) </code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">05 AUX_SOURCE_DIRECTORY(. DIR_SRCS)</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">06 ADD_EXECUTABLE(main ${DIR_SRCS})</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">0708 FIND_PACKAGE( libdb_cxx REQUIRED)</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">09 MARK_AS_ADVANCED(</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">10 LIBDB_CXX_INCLUDE_DIR</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">11 LIBDB_CXX_LIBRARIES</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">12 )</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">13 IF (LIBDB_CXX_INCLUDE_DIR AND LIBDB_CXX_LIBRARIES)</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">14 MESSAGE(STATUS "Found libdb libraries")</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">15&nbsp;&nbsp;&nbsp; INCLUDE_DIRECTORIES(${LIBDB_CXX_INCLUDE_DIR})</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">16&nbsp;&nbsp;&nbsp;&nbsp; MESSAGE( ${LIBDB_CXX_LIBRARIES} )</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">17&nbsp;&nbsp;&nbsp;&nbsp; TARGET_LINK_LIBRARIES(main ${LIBDB_CXX_LIBRARIES}18 )</code> 
     </div> 
     <div style="margin:0px;padding:0px 1em;border:0px;vertical-align:baseline;background-image:none;float:none;height:auto;width:auto;white-space:pre;"> 
      <code style="font-family:'ibm-plex-mono', Menlo, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', Courier, monospace;margin:0px;padding:0px;border:0px;vertical-align:baseline;background:none;float:none;height:auto;width:auto;color:#000000;">19 ENDIF (LIBDB_CXX_INCLUDE_DIR AND LIBDB_CXX_LIBRARIES)</code> 
     </div> 
    </div></td> 
  </tr> 
 </tbody> 
</table>

在该文件中第4行表示到目录 ./cmake/modules 中查找 Findlibdb\_cxx.cmake ,8-19 行表示查找链接库和头文件的过程。第8行使用命令 FIND\_PACKAGE 进行查找,这条命令执行后 CMake 会到变量 CMAKE\_MODULE\_PATH 指示的目录中查找文件 Findlibdb\_cxx.cmake 并执行。第13-19行是条件判断语句,表示如果 LIBDB\_CXX\_INCLUDE\_DIR 和 LIBDB\_CXX\_LIBRARIES 都已经被赋值,则设置编译时到 LIBDB\_CXX\_INCLUDE\_DIR 寻找头文件并且设置可执行文件 main 需要与链接库 LIBDB\_CXX\_LIBRARIES 进行连接。

### 第三步，执行 cmake ###

完成 Findlibdb\_cxx.cmake 和 CMakeList.txt 的编写后在项目的根目录依次执行 “cmake . ” 和 “make ” 可以进行编译,结果如下图所示：

##### 图 4. 使用其他程序库时 cmake 的执行结果 #####

![使用其他程序库时 cmake 的执行结果][cmake 1]

## 使用 cmake 生成 debug 版和 release 版的程序 ##

在 Visual Studio 中我们可以生成 debug 版和 release 版的程序,使用 CMake 我们也可以达到上述效果。debug 版的项目生成的可执行文件需要有调试信息并且不需要进行优化,而 release 版的不需要调试信息但需要优化。这些特性在 gcc/g++ 中是通过编译时的参数来决定的,如果将优化程度调到最高需要设置参数-O3,最低是 -O0 即不做优化;添加调试信息的参数是 -g -ggdb ,如果不添加这个参数,调试信息就不会被包含在生成的二进制文件中。

CMake 中有一个变量 CMAKE\_BUILD\_TYPE ,可以的取值是 Debug Release RelWithDebInfo 和 MinSizeRel。当这个变量值为 Debug 的时候,CMake 会使用变量 CMAKE\_CXX\_FLAGS\_DEBUG 和 CMAKE\_C\_FLAGS\_DEBUG 中的字符串作为编译选项生成 Makefile ,当这个变量值为 Release 的时候,工程会使用变量 CMAKE\_CXX\_FLAGS\_RELEASE 和 CMAKE\_C\_FLAGS\_RELEASE 选项生成 Makefile。

现假设项目中只有一个文件 main.cpp ,下面是一个可以选择生成 debug 版和 release 版的程序的 CMakeList.txt ：

##### 清单 7 #####

第 5 和 6 行设置了两个变量 CMAKE\_CXX\_FLAGS\_DEBUG 和 CMAKE\_CXX\_FLAGS\_RELEASE, 这两个变量是分别用于 debug 和 release 的编译选项。 编辑 CMakeList.txt 后需要执行 ccmake 命令生成 Makefile 。在进入项目的根目录,输入 "ccmake ." 进入一个图形化界面,如下图所示：

##### 图 5. ccmake 的界面 #####

![ccmake 的界面][ccmake]

按照界面中的提示进行操作,按 "c" 进行 configure ,这时界面中显示出了配置变量 CMAKE\_BUILD\_TYPE 的条目。如下图所示：

##### 图 6. 执行了 configure 以后 ccmake 的界面 #####

![执行了 configure 以后 ccmake 的界面][configure _ ccmake]

下面我们首先生成 Debug 版的 Makefile ：将变量 CMAKE\_BUILD\_TYPE 设置为 Debug ,按 "c" 进行 configure ，按 "g" 生成 Makefile 并退出。这时执行命令 find \* | xargs grep "O0" 后结果如下:

##### 清单 8 find \* | xargs grep "O0"的执行结果 #####

这个结果说明生成的 Makefile 中使用了变量 CMAKE\_CXX\_FLAGS\_DEBUG 作为编译时的参数。

下面我们将生成 Release 版的 Makefile ：再次执行命令 "ccmake ." 将变量CMAKE\_BUILD\_TYPE 设置为 Release ,生成 Makefile 并退出。执行命令 find \* | xargs grep "O0" 后结果如下：

##### 清单 9 find \* | xargs grep "O0"的执行结果 #####

而执行命令 find \* | xargs grep "O3" 后结果如下:

##### 清单 10. find \* | xargs grep "O3"的执行结果 #####

这两个结果说明生成的 Makefile 中使用了变量 CMAKE\_CXX\_FLAGS\_RELEASE 作为编译时的参数。

![70][]

**主目录中的CMakelists.txt文件**：

PROJECT(lora)  
cmake\_minimum\_required(VERSION 2.6)  
  
MESSAGE($\{PROJECT\_SOURCE\_DIR\})  
MESSAGE($\{PROJECT\_BINARY\_DIR\})  
  
SET(CMAKE\_BUILD\_TYPE RELEASE)  
  
SET(OS\_TYPE linux)  
  
IF($\{CMAKE\_BUILD\_TYPE\} MATCHES "RELEASE")  
SET(BUILDTYPE\_NAME release)  
ELSE()  
SET(BUILDTYPE\_NAME debug)  
ENDIF()  
  
  
IF($\{CMAKE\_SYSTEM\_VERSION\} MATCHES ".\*i686.\*")  
MESSAGE("OS 32")  
SET(OS\_BIT\_NUM 32)  
ELSE()  
MESSAGE("OS 64")  
SET(OS\_BIT\_NUM 64)  
ENDIF()  
  
  
SET(BUILD\_CLASSIFIER "l$\{OS\_BIT\_NUM\}\_$\{BUILDTYPE\_NAME\}")  
  
  
SET(OS\_LIB\_DIR $\{OS\_TYPE\})  
IF(OS\_TYPE MATCHES linux)  
SET(OS\_LIB\_DIR $\{OS\_TYPE\}$\{OS\_BIT\_NUM\})  
ENDIF(OS\_TYPE MATCHES linux)  
  
  
IF(OS\_BIT\_NUM MATCHES 64)  
SET (OS\_BIT\_NUM 64)  
SET(CMAKE\_CXX\_FLAGS\_DEBUG "$ENV\{CXXFLAGS\} -O0 -Wall -g -ggdb -D\_WIN64 -DTIXML\_USE\_STL")  
SET(CMAKE\_CXX\_FLAGS\_RELEASE "$ENV\{CXXFLAGS\} -O0 -g -ggdb -Wall -D\_WIN64 -DTIXML\_USE\_STL")  
ELSE(OS\_BIT\_NUM MATCHES 64)  
SET (OS\_BIT\_NUM 32)  
SET(CMAKE\_CXX\_FLAGS\_DEBUG "$ENV\{CXXFLAGS\} -O0 -Wall -g -ggdb -DTIXML\_USE\_STL")  
SET(CMAKE\_CXX\_FLAGS\_RELEASE "$ENV\{CXXFLAGS\} -O0 -g -ggdb -Wall -DTIXML\_USE\_STL")  
ENDIF(OS\_BIT\_NUM MATCHES 64)  
  
  
MESSAGE( STATUS "OS\_LIB\_DIR=" $\{OS\_LIB\_DIR\} )  
MESSAGE( STATUS "OS\_TYPE=" $\{OS\_TYPE\})  
  
  
\# Develop Dir  
SET(REPORT $\{PROJECT\_SOURCE\_DIR\})  
  
  
SET(LIB\_WIRINGPI wiringPi)  
  
  
\# Deploy dir  
SET(DEPLOY\_DIR $\{PROJECT\_SOURCE\_DIR\})  
SET(DEPLOY\_BIN\_DIR $\{DEPLOY\_DIR\}/bin)  
SET(DEPLOY\_LIB\_DIR $\{PROJECT\_SOURCE\_DIR\}/lib)  
  
  
ADD\_SUBDIRECTORY(loralib)

ADD\_SUBDIRECTORY(test)

**loralib文件夹中的CMakelists.txt**

AUX\_SOURCE\_DIRECTORY($\{PROJECT\_SOURCE\_DIR\}/loralib LORA\_SRCLIST)

ADD\_LIBRARY(lora SHARED $\{LORA\_SRCLIST\})

**test文件夹中的CMakelists.txt**

AUX\_SOURCE\_DIRECTORY($\{PROJECT\_SOURCE\_DIR\}/test TEST\_SRCLIST)  
INCLUDE\_DIRECTORIES($\{PROJECT\_SOURCE\_DIR\}/loralib /include)  
ADD\_EXECUTABLE(testlora $\{TEST\_SRCLIST\})  
SET\_TARGET\_PROPERTIES(testlora PROPERTIES COMPILE\_FLAGS "-Wno-deprecated")  
TARGET\_LINK\_LIBRARIES(testlora lora $\{LIB\_WIRINGPI\})  
\# Set the output directory  
SET(EXECUTABLE\_OUTPUT\_PATH $\{DEPLOY\_BIN\_DIR\})

[camke]: /images/20220526/706890949dba490bb9ebe5d88d059a8b.png
[step2-files.JPG]: /images/20220526/f38aeaa01726426381f15d01c102c4c3.png
[cmake]: /images/20220526/2c71eb05e76f4eb8a161c0563121491c.png
[cmake 1]: /images/20220526/f3b4aaa014d04f5c97269bdd1c7674a0.png
[ccmake]: /images/20220526/50116139cbee43b89c0e155ba5e15551.png
[configure _ ccmake]: /images/20220526/7e3f1ce0c5ac4714afdb747cec613df2.png
[70]: /images/20220526/6ccacbb1e0f147c39ac47b5e9c42187b.png