cmake入门教程 跨平台项目构建工具cmake介绍

news2025/7/11 18:30:30

一.初识cmake

在介绍cmake之前,我们先来从工具一个个衍生出来,做过linux c/c++编程的时候一般用过gcc指令或者makefile。我们先来介绍下

gcc(GNU Compiler Collection)将源文件编译(Compile)成可执行文件或者库文件;

而当需要编译的东西很多时,需要说明先编译什么,后编译什么,这个过程称为构建(Build)。常用的工具是make,对应的定义构建过程的文件为Makefile

而编写Makefile对于大型项目又比较复杂,通过CMake就可以使用更加简洁的语法定义构建的流程,CMake定义构建过程的文件为CMakeLists.txt

gcc/make/cmake的关系如下,三个工具就是蓝色框框

二.cmake工具介绍

cmake的安装命令如下:

sudo apt install cmake

CMake提供cmake、ctest和cpack三个命令行工具分别负责构建、测试和打包。本文主要介绍cmake命令。

使用cmake一般流程为:

  • 生成构建系统(buildsystem,比如make工具对应的Makefile);
  • 执行构建(比如make),生成目标文件;
  • 执行测试、安装或打包。

1 .生成构建系统

通过cmake命令生成构建系统。

通过cmake --help可以看到cmake命令支持的详细参数,常用的参数如下:

参数

含义

-S

指定源文件根目录,必须包含一个CMakeLists.txt文件

-B

指定构建目录,构建生成的中间文件和目标文件的生成路径

-D

指定变量,格式为-D <var>=<value>,-D后面的空格可以省略

比如,指明使用当前目录作为源文件目录,其中包含CMakeLists.txt文件;使用build目录作为构建目录;设定变量CMAKE_BUILD_TYPE的值为Debug,变量AUTHOR的值为RealCoolEngineer:

cmake -S . -B build -DCMAKE_BUILD_TYPE=Debug -DAUTHOR=RealCoolEngineer

使用-D设置的变量在CMakeLists.txt中生效,可以设置cmake的内置支持的一些变量控制构建的行为;当然也可以使用自定义的变量,在CMakeLists.txt中自行判断做不同的处理。

2 .执行构建

使用cmake --build [<dir> | --preset <preset>]执行构建。

这里要指定的目录就是生成构建系统时指定的构建目录。常用的参数如下:

参数

含义

--target

指定构建目标代替默认的构建目标,可以指定多个

--parallel/-j [<jobs>]

指定构建目标时使用的进程数

在这一步,如果使用的是make构建工具,则可以在构建目录下直接使用make命令。

三.cmake使用方法

1.简单的一个cmake应用

此实验我们从一个cmake的简单编写/编译/执行做起,最后再讲解内部的原理,语法,一步步带入

1.1 程序源文件

首先先写一个main.c的源文件,实现很简单,就是打印一个hello cmake

#include <stdio.h>

int main()
{
    printf("Hello cmake\r\n");
    return 0;
}

1.2 cmake编译文件编写

然后我们再写一个CMakeLists.txt,内容如下:

PROJECT(HELLO)
ADD_EXECUTABLE(hello main.c)

这里有几个点需要重点强调下

1)CMakeLists.txt 这个文件名称不能修改,这个一个约定俗成的规则,所以不用纠结cmake里面怎么实现的,如果你没有这个文件,敲cmake编译的时候回提示这个错误

2)PROJECT指令的作用,定义工程名称,并可制订工程支持的语言,默认支持所有语言。此指令隐式的定义了两个变量 PROJECT_BINARY_DIR 和 PROJECT_SOURCE_DIR

语法如下:

PROJECT(projectname [CXX] [C] [Java])

# 例:PROJECT(HELLO)

3)ADD_EXECUTABLE指令的作用

定义工程会生成文件名为xx的可执行文件,相关的源文件是根据后面的源文件列表。

语法如下:

ADD_EXECUTABLE(<Executable Filename> ${SRC_LIST})

# 例:ADD_EXECUTABLE(hello ${SRC_LIST})

1.3 cmake编译

cmake的编译指令

cmake .

make

这里有几个重点需要强调下:

1)cmake后面的路径,这个是CMakeLists.txt 的路径

2)敲了cmake会生成什么?

这四个文件重点是Makefile,对,没错,cmake会自动帮我们生成makefile,我们后面敲make编译就能生成对应的可执行程序了!

1.4 编译引发的思考

可以这么多编译目录文件,我想让跟目录变的单纯点有什么办法呢?

我们可以创建一个build目录,然后进入build目录敲

cmake ..

make

可以看到所有的cmake的生成的文件都在build目录下,放跟目录很清洁

2.多文件cmake的应用

2.1 C语言源文件

在小节1的接触上,我们现在写两个.c文件,分别是main.c test.c

#include <stdio.h>
extern int test()

int main()
{
	printf("Hello cmake 002\r\n");
	test();
	return 0;
}
#include <stdio.h>

int test()
{
	printf("This is test func\r\n");
	return 0;
}

很简单哈,就是test.c定义一个函数test,然后在main.c中调用

2.2 CMakeLists.txt文件

PROJECT(HELLO)
ADD_EXECUTABLE(hello main.c test.c)

很简单,我们就在实例1的基础上增加了一个test.c

2.3 编译运行

cmake .

make

2.4 引发思考

问题1:现在两个文件可以通过ADD_EXECUTABLE(hello main.c test.c) 这种方式一个个文件添加,但是如果是大型工程呢?这里可以通过两种方法来进行管理

1)通过引入变量自己通过变量来管理源文件,使管理更清晰

2)通过通配符来进行匹配,增加文件不需要再手动更改CMakeLists.txt

下面我们就来一一介绍下

1)通过引入变量自己通过变量来管理源文件,使管理更清晰

这种方式比较简单,就是引入了一个定义变量的概念,CMakeLists.txt实现如下:

PROJECT(HELLO)
SET(SRC_LIST main.c test.c)
ADD_EXECUTABLE(hello ${SRC_LIST})

先介绍下SET语法复制变量跟取值变量的语法

SET指令可以用来显示的定义变量即可

SET(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])

其中VAR就是变量名称 VALUE就是变量的值

使用${}方式来取得变量中的值,而在IF语句中则直接使用变量名。

懂了这个语法再看上面的CMakeLists.txt应该就没有难度了吧

2)通过通配符来进行匹配,增加文件不需要再手动更改CMakeLists.txt

PROJECT(HELLO)
file(GLOB SRC_LIST "./*.c")
ADD_EXECUTABLE(hello ${SRC_LIST})

问题2:不同的路径下多文件怎么管理?

假设现在有3个路径test1 test2 test3,分别里面有test1.c test2.c test.3,目录结构如下:

现在我们有两种方法去管理:

1)沿用之前的思路,暴力写CMakeLists.txt

2)增加子文件夹CMakeLists.txt的例子

我们首先来看下第一种方法

1)沿用之前的思路,暴力写CMakeLists.txt

PROJECT(HELLO)
SET(SRC_LIST 
	main.c 
	./test1/test1.c
	./test2/test2.c
	./test3/test3.c)
ADD_EXECUTABLE(hello ${SRC_LIST})

这种方法感觉没有引入什么新的概念,所以一看就懂了·,不需要多多重复

2)通过静态库的方式链接

整个文件夹目录为:

其中顶层的CMakeLists.txt为

cmake_minimum_required(VERSION 3.25)
PROJECT(HELLO)
ADD_SUBDIRECTORY("test1")
ADD_SUBDIRECTORY("test2")
ADD_SUBDIRECTORY("test3")

SET(STATIC_LIBRARIES 
	test1	
	test2
	test3
)


ADD_EXECUTABLE(hello main.c)
TARGET_LINK_LIBRARIES(hello ${STATIC_LIBRARIES})

整个设计实现为就是增加3个子集文件夹test1/test2/test3

然后编译的时候main.c编译为hello,并且把test1.a test2.a test3.a链接到hello中

test1的CMakeLists.txt为

cmake_minimum_required(VERSION 3.25)

PROJECT("test1")
SET(TEST_NAME "test1")
file(GLOB TEST1_SRC_LIST "./*.c")
add_library(${TEST_NAME} STATIC ${TEST1_SRC_LIST})

整个设计思路就是把test1目录下的所有.c链接为test1.a

test2的CMakeLists.txt为

cmake_minimum_required(VERSION 3.25)

PROJECT("test2")
SET(TEST_NAME "test2")
file(GLOB TEST1_SRC_LIST "./*.c")
add_library(${TEST_NAME} STATIC ${TEST1_SRC_LIST})

整个设计思路就是把test2目录下的所有.c链接为test2.a

test3的CMakeLists.txt为

cmake_minimum_required(VERSION 3.25)

PROJECT("test3")
SET(TEST_NAME "test3")
file(GLOB TEST1_SRC_LIST "./*.c")
add_library(${TEST_NAME} STATIC ${TEST1_SRC_LIST})

整个设计思路就是把test3目录下的所有.c链接为test3.a

里面有几个新的概念在里面:

1)增加子文件夹命令ADD_SUBDIRECTORY ,这个命令是增加子目录,也就是cmake会自动进入这个目录寻找子集CMakeLists.txt

2)ADD_LIBRAY 是把某一个source file打包成一个库

SHARED 动态库
STATIC 静态库
MODULE 在使用dyld的系统有效,如果不支持dyld,则被当做SHARED对待。
EXCLUDE_FROM_ALL参数的意思是这个不会被默认构建,除非有其他的组件依赖或者手工构建。

3)TARGET_LINK_LIBRARIES 增加link文件

3.头文件引用

首先我们来看下文件的目录为:

其中根目录下有main.c test1.c 以及有一个cmake的编译文件,另外还有inc文件夹下有test1.h的头文件夹

其中main.c的源码为:

#include <stdio.h>
#include "test1.h"

int main()
{
    printf("Hello cmake 005\r\n");
    test1();

    return 0;
}

其中test.c的源码为:

#include <stdio.h>

int test1()
{
	printf("This is test1 func\r\n");
	return 0;
}

其中test1.h的源码为

#ifndef TEST1_H_H_H
#define TEST1_H_H_H

int test1();

#endif

其中CMakeLists.txt的文件为:

cmake_minimum_required(VERSION 3.25)
PROJECT(HELLO)

INCLUDE_DIRECTORIES(./inc)
ADD_EXECUTABLE(hello main.c test1.c)

新的内容只有这一块,主要是INCLUDE_DIRECTORIES,这个命令就是增加头文件include的目录的

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处:http://www.coloradmin.cn/o/38583.html

如若内容造成侵权/违法违规/事实不符,请联系多彩编程网进行投诉反馈,一经查实,立即删除!

相关文章

若依框架解读(前后端分离版)—— 1.Spring Security相关配置(@Anonymous注解)

有关Spring Security与JWT相关知识可以看我之前写的文章&#xff1a;SpringBoot整合SpringSecurityJWT(三更草堂) 这边需要对RBAC模型有一点了解&#xff0c;比较简单可自行百度。 首先查看Security配置类SecurityConfig&#xff0c;如果我们想要放行自己写的接口是可以在此配置…

数学建模国赛/美赛常见赛题类型及建模方案(纯干货)

目录 一&#xff0c;评价类问题 1&#xff0c;建模步骤如下图所示&#xff1a; 2&#xff0c;主客观评价问题的区别 3&#xff0c;如何选择合适的评价方法 二&#xff0c;预测类赛题 1&#xff0c;预测类赛题的基本解题步骤 2&#xff0c;预测类问题的区别 3&#xff0c;…

什么是Tomcat?如何使用Tomcat?如何部署一个静态页面?

目录 1、Tomcat是什么&#xff1f; 2、下载安装 3、目录结构 4、启动服务器 5、部署静态页面&#xff08;简单举例&#xff09; 1、Tomcat是什么&#xff1f; Tomcat是一个HTTP服务器&#xff0c;Tomcat就是基于Java实现的一个开源免费的HTTP服务器 2、下载安装 下载网…

virtualbox安装openEuler-方案二

下载的讲解在另一篇&#xff1a;VirtualBox安装openEuler 方案一 安装&#xff1a; 1&#xff0c;配置网卡 2&#xff0c;加载光驱设置 选择对应的iso文件即可。 3&#xff0c;启动openEuler 选择第一个即可&#xff0c;第二个选项一般是在生成环境中使用。 经过一段…

std::weak_ptr(分析、仿写)

目录 一、为什么会有weak_ptr? 1、看一个例子 2.weak_ptr 是什么? 3.weak_ ptr 如何使用? 1、如何创建weak_ ptr 实例 2、如何判断weak_ptr指向的对象是否存在 3、weak_ptr的使用 二、仿写std::weak_ptr 1、c参考手册 2、代码 一、为什么会有weak_ptr? 1、看一个例子…

18uec++多人游戏【服务器为两个角色发枪,并能在线开枪】

打开主角类&#xff0c;生成枪的代码逻辑在游戏开始函数里 所以在生成之前&#xff0c;我们需要判断该对象是否在服务器端&#xff08;服务器端视角&#xff09; void ASCharacter::BeginPlay() {Super::BeginPlay();DefaultsFOV CameraComp->FieldOfView;//判断是否在服务…

支付系统 — 支付路由

本文主要介绍下支付中路由系统的主要流程。 支付路由的作用 降低成本&#xff1a;越便宜越好&#xff1b; 提高用户体验&#xff1a;用户支付的越爽越好&#xff1b;越快越好&#xff1b;成功率越高越好。 确保有可用通道&#xff1a;多个选择&#xff0c;确保能完成支付。 …

【JVM】PC程序计数器和PC寄存器

一、JVM体系结构 本文所讲内容主要是 JVM 体系结构图中 运行时数据区 中的 PC寄存器&#xff0c;如下图所示&#xff1a; 二、PC寄存器是什么&#xff1f; 这里引用别人的一句话&#xff1a; 首先这里的PC寄存器并非广义上所指的物理寄存器&#xff0c;或许将其翻译为PC计数…

antd Carousel 重写dot样式

antd的Carousel走马灯组件的dot也就是下面那个滑动的按钮非常的不起眼。 白色背景的时候完全看不到。 但是我们大部分时候又都是白色背景&#xff0c;于是来自己重写一下样式。 在控制台看了一下&#xff0c;应该是这个属性在控制dot的颜色&#xff0c;重写这个属性就可以了。…

Nginx源码解析 --红黑树

预读知识 红黑树是一种自平衡二叉树&#xff0c;不仅可以使用二分法快速查找&#xff0c;而且插入和删除操作的效率也很高&#xff0c;常用于构造关联数组&#xff08;例如C标准库里的set和 map)。 在Nginx里红黑树主要用在事件机制里的定时器&#xff0c;检查连接超时&#…

Debian11之基于kubeadm安装K8S集群

官方安装教程 硬件要求 每台机器的内存要 2GB、CPU2 核心及以上 集群中的所有机器的网络彼此均能相互连接&#xff08;公网和内网都可以&#xff09; 节点之中不可以有重复的主机名、MAC 地址或 product_uuid 开启机器上的某些端口 为了保证 kubelet 正常工作&#xff0c;必须…

FluentCRM 2.6.0:更多功能、集成改进等等!

FluentCRM 2.6.0最新版发布了&#xff0c;它是一个主要的更新版本&#xff0c;为您带来了更多的功能、改进的集成、升级和错误修复&#xff01;让我们来看看 FluentCRM 2.6.0 提供了什么新功能&#xff01; 目录 FluentCRM 2.6的更高级过滤条件 电子邮件活动条件 基于自动化…

STC32G 单片机EEPROM 操作实例

一 STC32G 单片机EEPROM简介 STC32G系列单片机内部集成了大量的EEPROM&#xff0c;特别是STC32G12K128集成多达128K EEPROM。 STC32G内部EEPROM可擦写10万次&#xff0c;分若干扇区&#xff0c;每个扇区512字节。EEPROM的写操作只能将1写为0。要将0写为1&#xff0c;必须擦除…

Hive之函数

Hive之函数 第九章 函数 9.1 系统内置函数 9.1.1 理论 查看内置函数&#xff1a; show functions; 显示函数的详细信息&#xff1a; desc function abs; 显示函数的扩展信息&#xff1a; desc function extended concat; 一、关系运算&#xff1a; 1. 等值比较: 2. 等值…

VSCode:使用CMakeLists.txt构建C++项目

vscode配置 插件&#xff1a; CMake插件主要功能是CMake语法高亮、自动补全CMake Tools的功能主要是结合VSCode IDE使用CMake这个工具&#xff0c;比如生成CMake项目、构建CMake项目等CMake Tools Helper CMake工具本身还是要下载到本地&#xff0c;并且配置环境变量。 项目…

足球二三事 - 世界杯征文

征文活动链接&#xff1a; https://bbs.csdn.net/topics/609601920 从报纸上时候看 1982 年的世界杯&#xff0c;当时我们家里没有电视&#xff0c;晚上的时候听到马路对面的房子里传来惊呼声&#xff0c;也不知道为啥。 1983 年的春节前&#xff0c;家里要打扫房间&#xff…

UE4,UE5虚幻引擎源码版下载

1、进入Epic的GitHub仓库 https://github.com/EpicGames/Signup GitHub - EpicGames/Signup: Information about signing up for a free Epic Games account, and getting access to UnrealEngine source code. 2、加入EpicTeamAdmin 3、进入UnrealEngine仓库 4、找到需要下…

Linux系统中curl命令用法详解

在Linux系统中curl是一个利用URL规则在命令行下工作的文件传输工具&#xff0c;是一款强大的http命令行工具。它支持文件的上传和下载&#xff0c;是综合传输工具。 curl 是常用的命令行工具&#xff0c;用来请求 Web 服务器。它的名字就是客户端&#xff08;client&#xff09…

(C语言)printf打印的字符串太长了,我想分两行!

本文来自于公众号&#xff1a;C语言编程技术分享 一、提问 有下述C程序&#xff1a; #include <stdio.h> #include <stdlib.h>int main() { printf("123456789012345678901234567890\n");system("pause");return 0; } printf函数要打印的字…

tomcat启动配置java_home,启动网址等,点击startup.bat直接启动

自己开发了一个网址&#xff08;基于angular&#xff09;&#xff0c;想共享给别人&#xff0c;直接点击运行&#xff0c;通过tomcat部署网站方式执行。 1、下载tomcat 从官网上下载tomcat&#xff0c;我下载的是tomcat9.0.36,下载完成后&#xff0c;解压&#xff1a; 双击b…