CMake使用详解一（单文件编译）

1 什么是CMake

你或许听过好几种 Make 工具，例如 GNU Make ，QT 的 qmake ，微软的 MS nmake，BSD Make（pmake），Makepp，等等。这些 Make 工具遵循着不同的规范和标准，所执行的 Makefile 格式也千差万别。这样就带来了一个严峻的问题：如果软件想跨平台，必须要保证能够在不同平台编译。而如果使用上面的 Make 工具，就得为每一种标准写一次 Makefile ，这将是一件让人抓狂的工作。

CMake就是针对上面问题所设计的工具：它首先允许开发者编写一种平台无关的 CMakeList.txt 文件来定制整个编译流程，然后再根据目标用户的平台进一步生成所需的本地化 Makefile 和工程文件，如 Unix 的 Makefile 或 Windows 的 Visual Studio 工程。从而做到“Write once, run everywhere”。显然，CMake 是一个比上述几种 make 更高级的编译配置工具。一些使用 CMake 作为项目架构系统的知名开源项目有 VTK、ITK、KDE、OpenCV、OSG 等 。

在 linux 平台下使用 CMake 生成 Makefile 并编译的流程如下：

1. 编写 CMake 配置文件 CMakeLists.txt 。
2. 执行命令 cmake PATH 或者 ccmake PATH 生成 Makefile 。其中， PATH 是 CMakeLists.txt 所在的目录。
3. 使用 make 命令进行编译。

2 单个源文件编译

2.1 编写单个cpp文件

假设现在我们的项目中只有一个源文件main.cpp，该程序的用途是计算一个数的指数幂，新建这个cpp文件

$ cd 
$ mkdir mathPowerDemo
$ cd mathPowerDemo
$ gedit main.cpp

键入代码如下

#include <stdio.h>
#include <stdlib.h>
/**
 * power - Calculate the power of number.
 * @param base: Base value.
 * @param exponent: Exponent value.
 *
 * @return base raised to the power exponent.
 */
double power(double base, int exponent)
{
    int result = base;
    int i;
    
    if (exponent == 0) {
        return 1;
    }
    
    for(i = 1; i < exponent; ++i){
        result = result * base;
    }
    return result;
}
int main(int argc, char *argv[])
{
    if (argc < 3){
        printf("Usage: %s base exponent \n", argv[0]);
        return 1;
    }
    double base = atof(argv[1]);
    int exponent = atoi(argv[2]);
    double result = power(base, exponent);
    printf("%g ^ %d is %g\n", base, exponent, result);
    return 0;
}

2.2 编写CMakeLists.txt

首先编写CMakeLists.txt文件，并保存在与main.cpp源文件同个目录下：

$ gedit CMakeLists.txt

在CMakeLists.txt中输入：

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息
project (mathPowerDemo)
# 指定生成目标
add_executable(mathPowerDemo main.cpp)

CMakeLists.txt 的语法比较简单，由命令、注释和空格组成，其中命令是不区分大小写的。符号 # 后面的内容被认为是注释。命令由命令名称、小括号和参数组成，参数之间使用空格进行间隔。

对于上面的 CMakeLists.txt 文件，依次出现了几个命令：

1. cmake_minimum_required：指定运行此配置文件所需的 CMake 的最低版本；
2. project：参数值是 mathPowerDemo，该命令表示项目的名称是 mathPowerDemo 。
3. add_executable： 将名为 main.cpp的源文件编译成一个名称为 mathPowerDemo 的可执行文件。

此时文件夹目录下有如下两个文件：

2.3 使用cmake .和make编译项目

2.3.1 执行cmake .

在当前目录执行 cmake . ，得到 Makefile

此时文件夹下面多了3个文件，分别是CMakeCache.txt，cmake_install.camke，Makefile。

和1个文件夹/CMakeFiles，里面有很多cmake相关的文件。

2.3.2 执行make

再使用 make 命令编译得到 mathPowerDemo 可执行文件。

此时文件夹下又多了一个可执行文件’mathPowerDemo’。

2.3.3 执行./运行测试

计算9的平方

$ sudo chmod 777 mathPowerDemo 
$ ./mathPowerDemo 9 2

得到结果：81

3 CMake使用详解二（多文件编译）

我的下一篇博客：CMake使用详解二（多文件编译）

# 参考文献：

1. CMake入门实战
2. CMake学习