【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() 这条指令的具体使用方式可以看这篇文章:
在这里使用的命令为 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 目录,该命令的具体使用方式也可以参考这篇文章: 有关该函数的参数放在后续学习,先码一下。
最后的 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)