cmake教程github（cmake教程 爱编程的大丙）



CMake 是一个项目构建工具，并且是跨平台的。关于项目构建我们所熟知的还有Makefile（通过 make 命令进行项目的构建），大多是IDE软件都集成了make，比如：VS 的 nmake、linux 下的 GNU make、Qt 的 qmake等，如果自己动手写 makefile，会发现，makefile 通常依赖于当前的编译平台，而且编写 makefile 的工作量比较大，解决依赖关系时也容易出错。

而 CMake 恰好能解决上述问题， 其允许开发者指定整个工程的编译流程，在根据编译平台，，最后用户只需编译即可，所以可以把CMake看成一款自动生成 Makefile的工具，其编译流程如下图：

• 蓝色虚线表示使用构建项目的过程
• 红色实线表示使用构建项目的过程

介绍完CMake的作用之后，再来总结一下它的优点：

• 跨平台
• 能够管理大型项目
• 简化编译构建过程和编译过程
• 可扩展：可以为 cmake 编写特定功能的模块，扩充 cmake 功能

支持大写、小写、混合大小写的命令。如果在编写文件时使用的工具有对应的命令提示，那么大小写随缘即可，不要太过在意。

使用 进行，可以放在任何位置。

使用 形式进行。

1. 准备工作，为了方便测试，在我本地电脑准备了这么几个测试文件
   • add.c
   • sub.c
   • mult.c
   • div.c
   • head.h
   • main.c
2. 上述文件的目录结构如下：
3. 添加 文件

   在上述源文件所在目录下添加一个新文件 CMakeLists.txt，文件内容如下：

   接下来依次介绍一下在 CMakeLists.txt 文件中添加的三个命令:

   • ：指定使用的 cmake 的最低版本
     • 可选，非必须，如果不加可能会有警告
   • ：定义工程名称，并可指定工程的版本、工程描述、web主页地址、支持的语言（默认情况支持所有语言），如果不需要这些都是可以忽略的，只需要指定出工程名字即可。
   • ：定义工程会生成一个可执行程序
     • 这里的可执行程序名和中的项目名没有任何关系
     • 源文件名可以是一个也可以是多个，如有多个可用空格或间隔
4. 执行 命令

   万事俱备只欠东风，将 CMakeLists.txt 文件编辑好之后，就可以执行 命令了。

   当执行命令之后，CMakeLists.txt 中的命令就会被执行，所以一定要注意给 命令指定路径的时候一定不能出错。

   执行命令之后，看一下源文件所在目录中是否多了一些文件：

   我们可以看到在对应的目录下生成了一个文件，此时再执行命令，就可以对项目进行构建得到所需的可执行程序了。

   最终可执行程序就被编译出来了（这个名字是在中指定的）。

通过上面的例子可以看出，如果在文件所在目录执行了命令之后就会生成一些目录和文件（），如果再基于执行命令，程序在编译过程中还会生成一些中间文件和一个可执行文件，这样会导致整个项目目录看起来很混乱，不太容易管理和维护，此时我们就可以把生成的这些与项目源码无关的文件统一放到一个对应的目录里边，比如将这个目录命名为:

现在命令是在目录中执行的，但是文件是目录的上一级目录中，所以命令后指定的路径为，即当前目录的上一级目录。

当命令执行完毕之后，在目录中会生成一个文件

这样就可以在目录中执行命令编译项目，生成的相关文件自然也就被存储到目录中了。这样通过和生成的所有文件就全部和项目源文件隔离开了，各回各家，各找各妈。

在上面的例子中一共提供了5个源文件，假设这五个源文件需要反复被使用，每次都直接将它们的名字写出来确实是很麻烦，此时我们就需要定义一个变量，将文件名对应的字符串存储起来，在cmake里定义变量需要使用。

• ：变量名
• ：变量值

在编写C++程序的时候，可能会用到C++11、C++14、C++17、C++20等新特性，那么就需要在编译的时候在编译命令中制定出要使用哪个标准：

上面的例子中通过参数指定出要使用c++11标准编译程序，C++标准对应有一宏叫做。在CMake中想要指定C++标准有两种方式：

1. 在 CMakeLists.txt 中通过 set 命令指定
2. 在执行 cmake 命令的时候指定出这个宏的值

在CMake中指定可执行程序输出的路径，也对应一个宏，叫做，它的值还是通过命令进行设置:

• 第一行：定义一个变量用于存储一个绝对路径
• 第二行：将拼接好的路径值设置给宏
  • 如果这个路径中的子目录不存在，会自动生成，无需自己手动创建

由于可执行程序是基于 cmake 命令生成的 makefile 文件然后再执行 make 命令得到的，所以如果此处指定可执行程序生成路径的时候使用的是相对路径 ./xxx/xxx，那么这个路径中的 ./ 对应的就是 makefile 文件所在的那个目录。

如果一个项目里边的源文件很多，在编写文件的时候不可能将项目目录的各个文件一一罗列出来，这样太麻烦也不现实。所以，在CMake中为我们提供了搜索文件的命令，可以使用命令或者命令。

在 CMake 中使用 命令可以查找某个路径下的，命令格式为：

• ：要搜索的目录
• ：将从目录下搜索到的源文件列表存储到该变量中

如果一个项目里边的源文件很多，在编写文件的时候不可能将项目目录的各个文件一一罗列出来，这样太麻烦了。所以，在CMake中为我们提供了搜索文件的命令，他就是。

• : 将指定目录下搜索到的满足条件的所有文件名生成一个列表，并将其存储到变量中。
• ：递归搜索指定目录，将搜索到的满足条件的文件名生成一个列表，并将其存储到变量中。

搜索当前目录的src目录下所有的源文件，并存储到变量中

• CMAKE_CURRENT_SOURCE_DIR 宏表示当前访问的 CMakeLists.txt 文件所在的路径。
• 关于要搜索的文件路径和类型可加双引号，也可不加:

在编译项目源文件的时候，很多时候都需要将源文件对应的头文件路径指定出来，这样才能保证在编译过程中编译器能够找到这些头文件，并顺利通过编译。在CMake中设置要包含的目录也很简单，通过一个命令就可以搞定了，他就是:

举例说明，有源文件若干，其目录结构如下：

文件内容如下:

其中，第六行指定就是头文件的路径，宏对应的值就是我们在使用cmake命令时，后面紧跟的目录，一般是工程的根目录。

有些时候我们编写的源代码并不需要将他们编译生成可执行程序，而是生成一些静态库或动态库提供给第三方使用，下面来讲解在cmake中生成这两类库文件的方法。

在cmake中，如果要制作静态库，需要使用的命令如下：

在Linux中，静态库名字分为三部分：++，此处只需要指定出库的名字就可以了，另外两部分在生成该文件的时候会自动填充。

在Windows中虽然库名和Linux格式不同，但也只需指定出名字即可。

下面有一个目录，需要将目录中的源文件编译成静态库，然后再使用：

根据上面的目录结构，可以这样编写文件:

这样最终就会生成对应的静态库文件。

在cmake中，如果要制作动态库，需要使用的命令如下：

在Linux中，动态库名字分为三部分：++，此处只需要指定出库的名字就可以了，另外两部分在生成该文件的时候会自动填充。

在Windows中虽然库名和Linux格式不同，但也只需指定出名字即可。

根据上面的目录结构，可以这样编写文件:

这样最终就会生成对应的动态库文件。

方式1 - 适用于动态库

对于生成的库文件来说和可执行程序一样都可以指定输出路径。，所以可以按照生成可执行程序的方式去指定它生成的目录：

对于这种方式来说，其实就是通过命令给宏设置了一个路径，这个路径就是可执行文件生成的路径。

方式2 - 都适用

由于在Linux下生成的静态库默认不具有可执行权限，所以在指定静态库生成的路径的时候就不能使用宏了，而应该使用，这个宏对应静态库文件和动态库文件都适用。

在编写程序的过程中，可能会用到一些系统提供的动态库或者自己制作出的动态库或者静态库文件，cmake中也为我们提供了相关的加载动态库的命令。

现在我们把上面目录中的编译成一个静态库文件。

测试目录结构如下：

在cmake中，链接静态库的命令如下：

用于设置全局链接库，这些库会链接到之后定义的所有目标上。

• 参数1：指定出要链接的静态库的名字
  • 可以是全名
  • 也可以是掐头（）去尾（）之后的名字
• 参数2-N：要链接的其它静态库的名字

如果该静态库不是系统提供的（自己制作或者使用第三方提供的静态库）可能出现静态库找不到的情况，此时可以将静态库的路径也指定出来：

这样，修改之后的文件内容如下:

添加了第8行的代码，就可以根据参数指定的路径找到这个静态库了。

在程序编写过程中，除了在项目中引入静态库，好多时候也会使用一些标准的或者第三方提供的一些动态库，关于动态库的制作、使用以及在内存中的加载方式和静态库都是不同的，在此不再过多赘述，如有疑惑请参考

在中链接动态库的命令如下:

用于指定一个目标（如可执行文件或库）在编译时需要链接哪些库。它支持指定库的名称、路径以及链接库的顺序。

• target：指定要加载的库的文件的名字
  • 该文件可能是一个源文件
  • 该文件可能是一个动态库/静态库文件
  • 该文件可能是一个可执行文件
• PRIVATE|PUBLIC|INTERFACE：动态库的访问权限，默认为
  • 如果各个动态库之间没有依赖关系，无需做任何设置，三者没有没有区别，一般无需指定，使用默认的 PUBLIC 即可。
  • ，如果动态库 A 链接了动态库B、C，动态库D链接了动态库A，此时动态库D相当于也链接了动态库B、C，并可以使用动态库B、C中定义的方法。
    • ：在public后面的库会被Link到前面的target中，并且里面的符号也会被导出，提供给第三方使用。
    • ：在private后面的库仅被link到前面的target中，并且终结掉，第三方不能感知你调了啥库
    • ：在interface后面引入的库不会被链接到前面的target中，只会导出符号。

链接系统动态库

动态库的链接和静态库是完全不同的：

• 静态库会在生成可执行程序的链接阶段被打包到可执行程序中，所以可执行程序启动，静态库就被加载到内存中了。
• 动态库在生成可执行程序的链接阶段不会被打包到可执行程序中，当可执行程序被启动并且调用了动态库中的函数的时候，动态库才会被加载到内存

因此，在中指定要链接的动态库的时候，

在中：

• 对应的是最终生成的可执行程序的名字
• ：这是可执行程序要加载的动态库，这个库是系统提供的线程库，全名为，在指定的时候一般会掐头（lib）去尾（.so）。

链接第三方动态库

现在，自己生成了一个动态库，对应的目录结构如下：

假设在测试文件中既使用了自己制作的动态库又使用了系统提供的线程库，此时文件可以这样写：

在第六行中，都是可执行程序要链接的动态库的名字。当可执行程序生成之后并执行该文件，会提示有如下错误信息：

这是因为可执行程序启动之后，去加载这个动态库，但是不知道这个动态库被放到了什么位置，所以就加载失败了，在 CMake 中可以在生成可执行程序之前，通过命令指定出要链接的动态库的位置，指定静态库位置使用的也是这个命令：

所以修改之后的文件应该是这样的：

通过指定了动态库的路径之后，在执行生成的可执行程序的时候，就不会出现找不到动态库的问题了。

target_link_libraries

• 功能: 用于指定一个目标（如可执行文件或库）在编译时需要链接哪些库。它支持指定库的名称、路径以及链接库的顺序。
• 语法:
• 优点:
  • 更精确地控制目标的链接库。
  • 可以指定库的不同链接条件（如调试版本、发布版本）。
  • 支持多个目标和多个库之间的复杂关系。
  • 更加灵活和易于维护，特别是在大型项目中。
• 示例:

link_libraries

• 功能: 用于设置全局链接库，这些库会链接到之后定义的所有目标上。它会影响所有的目标，适用于全局设置，但不如 精确。
• 语法:
• 缺点:
  • 缺乏针对具体目标的控制，不适合复杂的项目结构。
  • 容易导致意外的依赖关系，因为它对所有目标都生效。
  • 一旦设置，全局影响可能导致难以追踪的链接问题。
• 示例:

总结

• 是更推荐的方式，因为它允许更精确的控制和管理链接库的依赖，特别是在大型项目中，它能够避免全局设置可能带来的问题。
• 虽然简单，但在复杂的项目中可能会导致意外的问题，通常适用于简单的项目或临时设置。

建议在 CMake 项目中优先使用 。

在CMake中可以用用户显示一条消息，该命令的名字为：

• ：重要消息
• ：非重要消息
• ：CMake 警告, 会继续执行
• ：CMake 警告 (dev), 会继续执行
• ：CMake 错误, 继续执行，但是会跳过生成的步骤
• ：CMake 错误, 终止所有处理过程

CMake的命令行工具会在stdout上显示消息，在stderr上显示其他所有消息。CMake的GUI会在它的log区域显示所有消息。

CMake警告和错误消息的文本显示使用的是一种简单的标记语言。文本没有缩进，超过长度的行会回卷，段落之间以新行做为分隔符。

有时候项目中的源文件并不一定都在同一个目录中，但是这些源文件最终却需要一起进行编译来生成最终的可执行文件或者库文件。如果我们通过命令对各个目录下的源文件进行搜索，最后还需要做一个字符串拼接的操作，关于字符串拼接可以使用命令也可以使用命令。

使用set拼接

如果使用set进行字符串拼接，对应的命令格式如下：

关于上面的命令其实就是将从第二个参数开始往后所有的字符串进行拼接，最后将结果存储到第一个参数中，如果第一个参数中原来有数据会对原数据就行覆盖。

使用list拼接

如果使用list进行字符串拼接，对应的命令格式如下：

命令的功能比要强大，字符串拼接只是它的其中一个功能，所以需要在它第一个参数的位置指定出我们要做的操作，表示进行数据追加，后边的参数和就一样了。

在CMake中，使用命令可以创建一个。一个在内部是一个由分割的一组字符串。例如，命令将会创建一个，但是最终打印变量值的时候得到的是。

输出的结果:

我们在通过搜索某个目录就得到了该目录下所有的源文件，但是其中有些源文件并不是我们所需要的，比如：

在当前这么目录有五个源文件，其中是一个测试文件。如果我们想要把计算器相关的源文件生成一个动态库给别人使用，那么只需要这四个源文件就可以了。此时，就需要将从搜索到的数据中剔除出去，想要实现这个功能，也可以使用

通过上面的命令原型可以看到删除和追加数据类似，只不过是第一个参数变成了。

可以看到，在把将要移除的文件的名字指定给就可以了。但是一定要注意通过 file 命令搜索源文件的时候得到的是文件的绝对路径（在list中每个文件对应的路径都是一个item，并且都是绝对路径），那么在移除的时候也要将该文件的绝对路径指定出来才可以，否是移除操作不会成功。

关于命令还有其它功能，但是并不常用，在此就不一一进行举例介绍了。

1. 获取 list 的长度。
   • ：子命令LENGTH用于读取列表长度
   • ：当前操作的列表
   • ：新创建的变量，用于存储列表的长度。
2. 读取列表中指定索引的的元素，可以指定多个索引
   • ：当前操作的列表
   • ：列表元素的索引
     • 从0开始编号，索引0的元素为列表中的第一个元素；
     • 索引也可以是负数，表示列表的最后一个元素，表示列表倒数第二个元素，以此类推
     • 当索引（不管是正还是负）超过列表的长度，运行会报错
   • ：新创建的变量，存储指定索引元素的返回结果，也是一个列表。
3. 将列表中的元素用连接符（字符串）连接起来组成一个字符串
   • ：当前操作的列表
   • ：指定的连接符（字符串）
   • ：新创建的变量，存储返回的字符串
4. 查找列表是否存在指定的元素，若果未找到，返回-1
   • ：当前操作的列表
   • ：需要再列表中搜索的元素
   • ：新创建的变量
     • 如果列表中存在，那么返回在列表中的索引
     • 如果未找到则返回-1。
5. 将元素追加到列表中
6. 在list中指定的位置插入若干元素
7. 将元素插入到列表的0索引位置
8. 将列表中最后元素移除
9. 将列表中第一个元素移除
10. 将指定的元素从列表中移除
11. 将指定索引的元素从列表中移除
12. 移除列表中的重复元素
13. 列表翻转
14. 列表排序
    • ：指定排序方法。有如下几种值可选：
      • :按照字母顺序进行排序，为默认的排序方法
      • ：如果是一系列路径名，会使用basename进行排序
      • ：使用自然数顺序排序
    • ：指明是否大小写敏感。有如下几种值可选：
      • : 按照大小写敏感的方式进行排序，为默认值
      • ：按照大小写不敏感方式进行排序
    • ：指明排序的顺序。有如下几种值可选：
      • :按照升序排列，为默认值
      • ：按照降序排列

在进行程序测试的时候，我们可以在代码中添加一些宏定义，通过这些宏来控制这些代码是否生效，如下所示：

在程序的第七行对宏进行了判断，如果该宏被定义了，那么第八行就会进行日志输出，如果没有定义这个宏，第八行就相当于被注释掉了，因此最终无法看到日志输入出（上述代码中并没有定义这个宏）。

为了让测试更灵活，我们可以不在代码中定义这个宏，而是在测试的时候去把它定义出来，其中一种方式就是在命令中去指定，如下：

在命令中通过参数 指定出要定义的宏的名字，这样就相当于在代码中定义了一个宏，其名字为。

在中我们也可以做类似的事情，对应的命令叫做:

针对于上面的源文件编写一个，内容如下：

通过这种方式，上述代码中的第八行日志就能够被输出出来了。

下面的列表中为大家整理了一些中常用的宏：

版权声明：

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若内容造成侵权、违法违规、事实不符，请将相关资料发送至xkadmin@xkablog.com进行投诉反馈，一经查实，立即处理！

转载请注明出处，原文链接：https://www.xkablog.com/cjjbc/70577.html