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

1.安装cmake

首先需要手动安装cmake

sudo apt-get install cmake
  • 1

2.cmake编译单个源文件

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

cmake超详细入门教程_第2张图片
然后编写 CMakeLists.txt 文件,这个文件会被 cmake 工具解析,可以类比与 Makefile 被 make 解析一样

写下以下内容:

cmake超详细入门教程_第3张图片
此时,当前文件夹下有连个文件:
cmake超详细入门教程_第4张图片
执行cmake 进行编译

cmake ./
  • 1

打印结果如下:
cmake超详细入门教程_第5张图片
然后会生成这些文件

cmake超详细入门教程_第6张图片
到这里,我们直接执行make编译代码就好

cmake超详细入门教程_第7张图片
然后你会发现,已经生成了可执行文件 hello

在这里插入图片描述
运行可执行文件成功,也意味着我们已经学会了如何基础的使用 cmake 工具了

在这里插入图片描述

三、CMakeLixts.txt文件基本语法

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

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

cmake超详细入门教程_第8张图片
第一行 project(HELLO):

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

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

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

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

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

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

在这里插入图片描述

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

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

在这里插入图片描述
新建一个 build 目录,进入目录,执行 cmake …/ , 然后执行 make 编译

cmake超详细入门教程_第9张图片

可以看到,cmake 和 make 生成的构建文件,以及可执行文件,都保存在了build目录下
cmake超详细入门教程_第10张图片
如果要清理工程,直接删除 build 目录即可,这样看起来使得工程文件更加整洁

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

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

hello.c
cmake超详细入门教程_第11张图片
hello.h
cmake超详细入门教程_第12张图片
因为添加了新的源文件,因此还需要修改 CMakeLists.txt 文件

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

在 add_executable 命令引用了该变量

当然也可以不去定义这个变量而直接写入源文件,这样做是为了代码整洁,以后文件多了可以这样操作
cmake超详细入门教程_第13张图片
现在的目录结构是这样:

在这里插入图片描述

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

cmake超详细入门教程_第14张图片

六、使用 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。

cmake超详细入门教程_第15张图片

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

cmake超详细入门教程_第16张图片


总结

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

你可能感兴趣的:(c语言,cmake)