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

原创 专注于无线通信的蓬勃 2022-11-26 15:11

一.初识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的目录的

专注于无线通信的蓬勃 朝气蓬勃——不积跬步 无以至千里, 不积小流 无以成江海
评论 (0)
  • 文/Leon编辑/cc孙聪颖‍步入 2025 年,国家进一步加大促消费、扩内需的政策力度,家电国补政策将持续贯穿全年。这一利好举措,为行业发展注入强劲的增长动力。(详情见:2025:消费提振要靠国补还是“看不见的手”?)但与此同时,也对家电企业在战略规划、产品打造以及市场营销等多个维度,提出了更为严苛的要求。在刚刚落幕的中国家电及消费电子博览会(AWE)上,家电行业的竞争呈现出胶着的态势,各大品牌为在激烈的市场竞争中脱颖而出,纷纷加大产品研发投入,积极推出新产品,试图提升产品附加值与市场竞争力。
    华尔街科技眼 2025-04-01 19:49 206浏览
  • 文/郭楚妤编辑/cc孙聪颖‍不久前,中国发展高层论坛 2025 年年会(CDF)刚刚落下帷幕。本次年会围绕 “全面释放发展动能,共促全球经济稳定增长” 这一主题,吸引了全球各界目光,众多重磅嘉宾的出席与发言成为舆论焦点。其中,韩国三星集团会长李在镕时隔两年的访华之行,更是引发广泛热议。一直以来,李在镕给外界的印象是不苟言笑。然而,在论坛开幕前一天,李在镕却意外打破固有形象。3 月 22 日,李在镕与高通公司总裁安蒙一同现身北京小米汽车工厂。小米方面极为重视此次会面,CEO 雷军亲自接待,小米副董
    华尔街科技眼 2025-04-01 19:39 209浏览
  • 据先科电子官方信息,其产品包装标签将于2024年5月1日进行全面升级。作为电子元器件行业资讯平台,大鱼芯城为您梳理本次变更的核心内容及影响:一、标签变更核心要点标签整合与环保优化变更前:卷盘、内盒及外箱需分别粘贴2张标签(含独立环保标识)。变更后:环保标识(RoHS/HAF/PbF)整合至单张标签,减少重复贴标流程。标签尺寸调整卷盘/内盒标签:尺寸由5030mm升级至**8040mm**,信息展示更清晰。外箱标签:尺寸统一为8040mm(原7040mm),提升一致性。关键信息新增新增LOT批次编
    大鱼芯城 2025-04-01 15:02 196浏览
  • 在智能交互设备快速发展的今天,语音芯片作为人机交互的核心组件,其性能直接影响用户体验与产品竞争力。WT588F02B-8S语音芯片,凭借其静态功耗<5μA的卓越低功耗特性,成为物联网、智能家居、工业自动化等领域的理想选择,为设备赋予“听得懂、说得清”的智能化能力。一、核心优势:低功耗与高性能的完美结合超低待机功耗WT588F02B-8S在休眠模式下待机电流仅为5μA以下,显著延长了电池供电设备的续航能力。例如,在电子锁、气体检测仪等需长期待机的场景中,用户无需频繁更换电池,降低了维护成本。灵活的
    广州唯创电子 2025-04-02 08:34 148浏览
  • 提到“质量”这两个字,我们不会忘记那些奠定基础的大师们:休哈特、戴明、朱兰、克劳士比、费根堡姆、石川馨、田口玄一……正是他们的思想和实践,构筑了现代质量管理的核心体系,也深远影响了无数企业和管理者。今天,就让我们一同致敬这些质量管理的先驱!(最近流行『吉卜力风格』AI插图,我们也来玩玩用『吉卜力风格』重绘质量大师画象)1. 休哈特:统计质量控制的奠基者沃尔特·A·休哈特,美国工程师、统计学家,被誉为“统计质量控制之父”。1924年,他提出世界上第一张控制图,并于1931年出版《产品制造质量的经济
    优思学院 2025-04-01 14:02 145浏览
  • 引言在语音芯片设计中,输出电路的设计直接影响音频质量与系统稳定性。WT588系列语音芯片(如WT588F02B、WT588F02A/04A/08A等),因其高集成度与灵活性被广泛应用于智能设备。然而,不同型号在硬件设计上存在关键差异,尤其是DAC加功放输出电路的配置要求。本文将从硬件架构、电路设计要点及选型建议三方面,解析WT588F02B与F02A/04A/08A的核心区别,帮助开发者高效完成产品设计。一、核心硬件差异对比WT588F02B与F02A/04A/08A系列芯片均支持PWM直推喇叭
    广州唯创电子 2025-04-01 08:53 188浏览
  • 北京贞光科技有限公司作为紫光同芯授权代理商,专注于为客户提供车规级安全芯片的硬件供应与软件SDK一站式解决方案,同时配备专业技术团队,为选型及定制需求提供现场指导与支持。随着新能源汽车渗透率突破40%(中汽协2024数据),智能驾驶向L3+快速演进,车规级MCU正迎来技术范式变革。作为汽车电子系统的"神经中枢",通过AEC-Q100 Grade 1认证的MCU芯片需在-40℃~150℃极端温度下保持μs级响应精度,同时满足ISO 26262 ASIL-D功能安全要求。在集中式
    贞光科技 2025-04-02 14:50 120浏览
  • 探针本身不需要对焦。探针的工作原理是通过接触被测物体表面来传递电信号,其精度和使用效果取决于探针的材质、形状以及与检测设备的匹配度,而非对焦操作。一、探针的工作原理探针是检测设备中的重要部件,常用于电子显微镜、坐标测量机等精密仪器中。其工作原理主要是通过接触被测物体的表面,将接触点的位置信息或电信号传递给检测设备,从而实现对物体表面形貌、尺寸或电性能等参数的测量。在这个过程中,探针的精度和稳定性对测量结果具有至关重要的影响。二、探针的操作要求在使用探针进行测量时,需要确保探针与被测物体表面的良好
    锦正茂科技 2025-04-02 10:41 69浏览
  • 退火炉,作为热处理设备的一种,广泛应用于各种金属材料的退火处理。那么,退火炉究竟是干嘛用的呢?一、退火炉的主要用途退火炉主要用于金属材料(如钢、铁、铜等)的热处理,通过退火工艺改善材料的机械性能,消除内应力和组织缺陷,提高材料的塑性和韧性。退火过程中,材料被加热到一定温度后保持一段时间,然后以适当的速度冷却,以达到改善材料性能的目的。二、退火炉的工作原理退火炉通过电热元件(如电阻丝、硅碳棒等)或燃气燃烧器加热炉膛,使炉内温度达到所需的退火温度。在退火过程中,炉内的温度、加热速度和冷却速度都可以根
    锦正茂科技 2025-04-02 10:13 64浏览
  • 随着汽车向智能化、场景化加速演进,智能座舱已成为人车交互的核心承载。从驾驶员注意力监测到儿童遗留检测,从乘员识别到安全带状态判断,座舱内的每一次行为都蕴含着巨大的安全与体验价值。然而,这些感知系统要在多样驾驶行为、复杂座舱布局和极端光照条件下持续稳定运行,传统的真实数据采集方式已难以支撑其开发迭代需求。智能座舱的技术演进,正由“采集驱动”转向“仿真驱动”。一、智能座舱仿真的挑战与突破图1:座舱实例图智能座舱中的AI系统,不仅需要理解驾驶员的行为和状态,还要同时感知乘员、儿童、宠物乃至环境中的潜在
    康谋 2025-04-02 10:23 95浏览
  • 职场之路并非一帆风顺,从初入职场的新人成长为团队中不可或缺的骨干,背后需要经历一系列内在的蜕变。许多人误以为只需努力工作便能顺利晋升,其实核心在于思维方式的更新。走出舒适区、打破旧有框架,正是让自己与众不同的重要法宝。在这条道路上,你不只需要扎实的技能,更需要敏锐的观察力、不断自省的精神和前瞻的格局。今天,就来聊聊那改变命运的三大思维转变,让你在职场上稳步前行。工作初期,总会遇到各式各样的难题。最初,我们习惯于围绕手头任务来制定计划,专注于眼前的目标。然而,职场的竞争从来不是单打独斗,而是团队协
    优思学院 2025-04-01 17:29 198浏览
我要评论
0
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦