【CMake系列】（一）入门

自从上次在为什么 C++ 静态连接库顺序很重要捡回了 C++，自此开始了不归路。

今天咱们来讲说，CMake 这个现代 C++ 项目的利器。

前言

为何咱们须要 CMake ？ 对于 C++ 开发者来讲，他们会习惯于使用 GNU Make 来编译 C++ 项目，对于简单项目来讲，这无可厚非，再加上有那么多的开源工具可用，尤为是 autotools 系列，用起来仍是挺方便的。目前仍有很是多的 C++ 项目，须要你先使用 ./configure 来预处理，而后再进行编译，这比只用 Make 来讲，方便不少倍，也就是对初学者很是友好 (高阶用户在此就不说了，毕竟如能把 Vim 用到飞起的高手并很少)。

在我我的看来，autotools 系列不那么简洁（当我看见当前目录生成一堆临时文件的时候，会很是讨厌，相对的，CMake 能够有专门的编译目录真是拯救了个人强迫症），因为没有怎么使用过，不便于说出更多其它意见，也没法细致对比。有兴趣的也能够看看 What are the differences between Autotools, Cmake and Scons? 上的讨论。

从入手难度来讲，CMake 是初学者的福音，不过有点麻烦的是，你须要学习一门新的语言，只是相对于编程语言来讲，它仍是很是简单的。

准备

大多数状况下，你只须要直接安装便可，好比下面三个命令你能够按照本身的机器选择：

brew install cmake
sudo apt install cmake
pip install cmake

其它的方式就能够直接在官网去下载后安装。

一个简单例子

让咱们从一个最简单的项目开始。

// main.cpp
#include <stdio.h>

int main(int argc, char *argv[])
{
    printf("Hello world");
    return 0;
}

咱们就能够在当前目录下建立一个 CMakeLists.txt：

# CMake 最低版本号要求，你也能够设置版本范围，好比 3.1...3.15
cmake_minimum_required (VERSION 3.0)

# 项目信息，可设置版本号以及描述
project (demo VERSION 0.1.0 DESCRIPTION "Demo project")

# 生成一个 demo 的可执行文件
add_executable(demo main.cpp)

而后，执行经典的四条命令，就能够编译出可执行文件了：

mkdir build
cd build
cmake ..
make

不一样于 Make，CMake 能够将配置的过程大大简化，三行语句，你就能够写出强大的跨平台编译脚本了，你能够从输出看到，一系列的步骤，都自动化完成了：

-- The C compiler identification is GNU 7.4.0
-- The CXX compiler identification is GNU 7.4.0                                               
-- Check for working C compiler: /usr/bin/cc                                                                 
-- Check for working C compiler: /usr/bin/cc -- works            
-- Detecting C compiler ABI info          
-- Detecting C compiler ABI info - done
-- Detecting C compile features
-- Detecting C compile features - done                                                           
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Configuring done
-- Generating done
-- Build files have been written to: /home/xizhibei/demo/build

是不很简单？再来个复杂点的例子。

一个稍复杂的例子

如今，随着你加入了更多的功能，你会须要改下你的 CMakeLists.txt。

好比你如今的项目结构是这样的：

--- root
  |-- CMakeLists.txt
  |-- main.cpp
  |-- include/
  |------ a.h
  |------ b.h
  |-- lib/
  |------ a.cpp
  |------ b.cpp

那么，对应着的修改以下：

cmake_minimum_required (VERSION 3.0)

project (demo VERSION 0.1.0 DESCRIPTION "Demo project")

# 添加 demo_lib 静态库
add_libary(demo_lib STATIC lib/a.cpp lib/b.cpp)

# 指定头文件所在位置
target_include_directories(demo_lib PUBLIC ${CMAKE_SOURCE_DIR}/include}

# 同上
add_executable(demo main.cpp)

# 这里不须要再次 target_include_directories 了，由于咱们在设置了 include 是 demo_lib 须要的，CMake 会自动添加

# 将 demo_lib 库连接至 demo 执行文件
target_link_libraries(demo demo_lib)

其实按照标准一些的方式，咱们应该在 lib 下建立一个新的 CMakeLists.txt，而后经过 add_subdirectory(lib) 来作，这里这样作是为了节约篇幅。

因而，一个简单的 C++ 项目就完成了。

其它

一个简单的例子完成了，可是该如何添加第三方依赖？怎么添加编译选项？怎么测试？怎么添加文档？

不急，以后我会慢慢道来，争取写一个比较长的系列。

Ref

1. http://www.cmake.org/

---

感谢阅读，本文首发于 Github issues: https://github.com/xizhibei/b... (Star 以及 Watch 强烈暗示 :P)；另外这篇文章也能在本人博客内阅读：https://blog.xizhibei.me/2020... 。

本文采用 署名-非商业性使用-相同方式共享（BY-NC-SA）进行许可。