cmake超详细入门教程

https://blog.csdn.net/qq_43257914/article/details/128409831

文章目录

• 前言
• 一、cmake是什么？
• 二、动手写一个简单的cmake
• • 1.安装cmake
  • 2.cmake编译单个源文件
• 三、CMakeLixts.txt文件基本语法
• 四、如何将编译文件与源文件分离
• 五、使用 cmake 编译多个源文件
• 六、使用 cmake 生成库文件
• 总结

---

前言

我们在平时编译代码的时，面对简单的代码，直接GCC编译就好，稍微多一点，可以编写Makefile来编译，以上编译起来都很轻松，可是平时工作的时候基本都是大工程呀，代码文件少则几十个文件了，这种情况下就头疼了，咋办呢？今天我来教你使用cmake轻松解决问题~

---

提示：以下是本篇文章正文内容，下面案例可供参考

一、cmake是什么？

Makefile想必大家都不陌生吧，它能够解决我们的自动化编译问题，大多是IDE软件都集成了make，譬如 Visual C++的 nmake、linux 下的 GNU make、Qt 的 qmake 等等。

不同的IDE所集成的make工具所遵循的规范和标准都不同，也就导致其语法、格式不同，也就不能很好的跨平台编译，会再次使得工作繁琐起来

那么cmake为了解决这个问题而诞生了，其允许开发者指定整个工程的编译流程，在根据编译平台，生成本地化的Makefile和工程文件，最后用户只需make编译即可

简而言之，可以把cmake看成一款自动生成 Makefile的工具，所以编译流程就变成了：cmake—>make–>用户代码–>可执行文件

二、动手写一个简单的cmake

1.安装cmake

首先需要手动安装cmake

sudo apt-get install cmake

• 1

2.cmake编译单个源文件

我们首先编写一个经典的 “hello world” 代码

然后编写 CMakeLists.txt 文件，这个文件会被 cmake 工具解析，可以类比与 Makefile 被 make 解析一样

写下以下内容：

此时，当前文件夹下有连个文件：

执行cmake 进行编译

cmake ./

• 1

打印结果如下：

然后会生成这些文件

到这里，我们直接执行make编译代码就好

然后你会发现，已经生成了可执行文件 hello

运行可执行文件成功，也意味着我们已经学会了如何基础的使用 cmake 工具了

三、CMakeLixts.txt文件基本语法

刚刚我们已经自己动手写了一个CMakeLists.txt 文件，并已经成功的编译出了可执行文件，但是你肯定还是处于一种似懂非懂的状态，所以，在这里我们稍微讲下他的语法结构

回到刚刚写的 CMakeLists.txt 文件，我们了解一下他的意思

第一行 project(HELLO):

project 命令用于设置工程的名称,括号中的参数 HELLO 便是我们要设置的工程名称;设置工程名称并
不是强制性的,但是最好加上。

第二行 add_executable(hello ./main.c):

add_executable 同样也是一个命令,用于生成一个可执行文件,
在本例中传入了两个参数,第一个参数表示生成的可执行文件对应的文件名,第二个参数表示对应的源文件;

所以 add_executable(hello ./main.c)表示需要生成一个名为 hello 的可执行文件,所需源文件为当前目录下的 main.c。

四、如何将编译文件与源文件分离

之前我们编译完代码后，会发现编译构建过程产生的文件与我们的源文件混杂在一起了

这样看起来会很不舒服，因此我们可以使用以下方法进行分离

首先，我们把之前构造过程产生的文件都删了，变成这样

新建一个 build 目录，进入目录，执行 cmake …/ , 然后执行 make 编译

可以看到，cmake 和 make 生成的构建文件，以及可执行文件，都保存在了build目录下

如果要清理工程,直接删除 build 目录即可，这样看起来使得工程文件更加整洁

五、使用 cmake 编译多个源文件

在之前的基础上，我们新建两个文件，hello.c 、hello.h

hello.c

hello.h

因为添加了新的源文件，因此还需要修改 CMakeLists.txt 文件

我们定义了一个 SRC_LIST 变量,SRC_LIST 变量是一个源文件列表,记录生
成可执行文件 hello 所需的源文件 main.c 和 hello.c

在 add_executable 命令引用了该变量

当然也可以不去定义这个变量而直接写入源文件，这样做是为了代码整洁，以后文件多了可以这样操作

现在的目录结构是这样：

接下来的环节和之前一样,进入到build目录下，cmake ，最后make 编译出可执行文件

六、使用 cmake 生成库文件

在我们平时的开发过程中，也有很多场景需要将我们的源码编译成库文件来提供使用，这个需求也可以使用cmake做到，

这就需要用到一条命令：

add_library(libhello 静态/动态库 hello.c)

没设置参数的话，默认就是生成静态库文件，可以加参数，设置指定的库文件

add_library(libhello SHARED hello.c) #生成动态库文件
add_library(libhello STATIC hello.c) #生成静态库文件

修改生成的库文件名字

可以看到刚刚的库文件名： liblibhello.a ，非常不优雅
那么我们可以使用这条命令来进行库文件的设置

set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")

• 1

set_target_properties 用于设置目标 的属性,这里通 过 set_target_properties 命令 对 libhello 目标 的
OUTPUT_NAME 属性进行了设置,将其设置为 hello。

同样的操作，进入build目录 ,进行以下操作，我们就得到了hello的动态库：libhello.so

---

总结

关于cmake的使用方法还有很多，这里只是做了一个最基本的介绍，后期有机会在进行详细补充~