【CMake】如何使用CMake构建一个工程

1.如何使用CMake构建一个工程

1. 使用 CMakelists.txt 构建工程

一个最简单 CMake 的项目是将某个源文件构建成为可执行文件，使用CMake 构建项目时，你需要创建一个 CMakeLists.txt 文件，通常情况下，下面三条命令在每个 CMakeLists.txt 文件中都会包含：

cmake_minimum_required()：指定了当前文件中的所有 CMake 指令所需要的最低 CMake版本。

project() ：指定当前的项目名称，该命令需要在每个项目中调用，并且调用顺序在cmake_minimum_required() 之后，该命令也可以用来区分其他项目的级别信息又或者是语言和版本号。

add_executable() ：该条指令告诉 CMake 创建可执行文件所使用的源文件。

具体代码如下图所示：

2. 指定 C++ 标准

CMake 通过一些以 CMAKE_ 开头的变量来指定某些参数，例如本节中的 C++ 标准，需要指定下面两个宏：

CMAKE_CXX_STANDARD

CMAKE_CXX_STANDARD_REQUIRED

具体用到的命令为 set() ,如下图所示：

3. 添加版本号和配置头文件

我们可以给自己的项目指定版本号，同时希望能够打印出版本号的内容，使用一个配置头文件可以实现上述操作

首先在项目后面添加版本号：

project(Tutorial VERSION 1.0)

然后创建一个配置头文件 TutorialConfig.h.in ，在文件内指定版本号：

#define Tutorial_VERSION_MAJOR @Tutorial_VERSION_MAJOR@
#define Tutorial_VERSION_MINOR @Tutorial_VERSION_MINOR@

这里的 @Tutorial_VERSION_MAJOR@ 和 @Tutorial_VERSION_MINOR@ 在之后都会被替换为相应设定的版本号。

然后在 CMakeLists.txt 文件中将该文件输出到 cmake build 目录中，使用的命令为configure_file() 这条指令的具体使用方式可以看这篇文章：【CMake】CMake的configure_file指令_cmake configure_file_Yngz_Miao的博客-CSDN博客

在这里使用的命令为 configure_file(TutorialConfig.h.in TutorialConfig.h) ，其中TutorialConfig.h.in为我们刚创建好的文件，TutorialConfig.h 为指定输出的文件名，输出文件存放在 build 目录：

如果想使用该头文件，还需要使用一条命令：target_include_directories() 来对头文件进行链接，target_include_directories(Tutorial PUBLIC "${PROJECT_BINARY_DIR}")

意思是将项目的二进制文件夹（编译的 build 文件夹）作为 include 目录，该命令的具体使用方式也可以参考这篇文章：cmake：target_include_directories、include_directories、add_executable_cmake target_include_directories_OceanStar的学习笔记的博客-CSDN博客 有关该函数的参数放在后续学习，先码一下。

最后的 CMakelists.txt 如下：

在cpp中简单测试一下：

cmd中输入：./Tutorial

Reference: [Step 1: A Basic Starting Point](https://cmake.org/cmake/help/latest/guide/tutorial/A Basic Starting Point.html)