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的目录的

专注于无线通信的蓬勃 朝气蓬勃——不积跬步 无以至千里, 不积小流 无以成江海
评论
  •         霍尔传感器是根据霍尔效应制作的一种磁场传感器。霍尔效应是磁电效应的一种,这一现象是霍尔(A.H.Hall,1855—1938)于1879年在研究金属的导电机构时发现的。后来发现半导体、导电流体等也有这种效应,而半导体的霍尔效应比金属强得多,利用这现象制成的各种霍尔元件,广泛地应用于工业自动化技术、检测技术及信息处理等方面。霍尔效应是研究半导体材料性能的基本方法。通过霍尔效应实验测定的霍尔系数,能够判断半导体材料的导电类型、载流子浓度及载流子
    锦正茂科技 2024-12-10 11:07 64浏览
  • 智能汽车可替换LED前照灯控制运行的原理涉及多个方面,包括自适应前照灯系统(AFS)的工作原理、传感器的应用、步进电机的控制以及模糊控制策略等。当下时代的智能汽车灯光控制系统通过车载网关控制单元集中控制,表现特殊点的有特斯拉,仅通过前车身控制器,整个系统就包括了灯光旋转开关、车灯变光开关、左LED前照灯总成、右LED前照灯总成、转向柱电子控制单元、CAN数据总线接口、组合仪表控制单元、车载网关控制单元等器件。变光开关、转向开关和辅助操作系统一般连为一体,开关之间通过内部线束和转向柱装置连接为多,
    lauguo2013 2024-12-10 15:53 78浏览
  • 全球知名半导体制造商ROHM Co., Ltd.(以下简称“罗姆”)宣布与Taiwan Semiconductor Manufacturing Company Limited(以下简称“台积公司”)就车载氮化镓功率器件的开发和量产事宜建立战略合作伙伴关系。通过该合作关系,双方将致力于将罗姆的氮化镓器件开发技术与台积公司业界先进的GaN-on-Silicon工艺技术优势结合起来,满足市场对高耐压和高频特性优异的功率元器件日益增长的需求。氮化镓功率器件目前主要被用于AC适配器和服务器电源等消费电子和
    电子资讯报 2024-12-10 17:09 84浏览
  •         在有电流流过的导线周围会感生出磁场,再用霍尔器件检测由电流感生的磁场,即可测出产生这个磁场的电流的量值。由此就可以构成霍尔电流、电压传感器。因为霍尔器件的输出电压与加在它上面的磁感应强度以及流过其中的工作电流的乘积成比例,是一个具有乘法器功能的器件,并且可与各种逻辑电路直接接口,还可以直接驱动各种性质的负载。因为霍尔器件的应用原理简单,信号处理方便,器件本身又具有一系列的du特优点,所以在变频器中也发挥了非常重要的作用。  &nb
    锦正茂科技 2024-12-10 12:57 76浏览
  • 一、SAE J1939协议概述SAE J1939协议是由美国汽车工程师协会(SAE,Society of Automotive Engineers)定义的一种用于重型车辆和工业设备中的通信协议,主要应用于车辆和设备之间的实时数据交换。J1939基于CAN(Controller Area Network)总线技术,使用29bit的扩展标识符和扩展数据帧,CAN通信速率为250Kbps,用于车载电子控制单元(ECU)之间的通信和控制。小北同学在之前也对J1939协议做过扫盲科普【科普系列】SAE J
    北汇信息 2024-12-11 15:45 68浏览
  • 概述 通过前面的研究学习,已经可以在CycloneVGX器件中成功实现完整的TDC(或者说完整的TDL,即延时线),测试结果也比较满足,解决了超大BIN尺寸以及大量0尺寸BIN的问题,但是还是存在一些之前系列器件还未遇到的问题,这些问题将在本文中进行详细描述介绍。 在五代Cyclone器件内部系统时钟受限的情况下,意味着大量逻辑资源将被浪费在于实现较大长度的TDL上面。是否可以找到方法可以对此前TDL的长度进行优化呢?本文还将探讨这个问题。TDC前段BIN颗粒堵塞问题分析 将延时链在逻辑中实现后
    coyoo 2024-12-10 13:28 101浏览
  • 天问Block和Mixly是两个不同的编程工具,分别在单片机开发和教育编程领域有各自的应用。以下是对它们的详细比较: 基本定义 天问Block:天问Block是一个基于区块链技术的数字身份验证和数据交换平台。它的目标是为用户提供一个安全、去中心化、可信任的数字身份验证和数据交换解决方案。 Mixly:Mixly是一款由北京师范大学教育学部创客教育实验室开发的图形化编程软件,旨在为初学者提供一个易于学习和使用的Arduino编程环境。 主要功能 天问Block:支持STC全系列8位单片机,32位
    丙丁先生 2024-12-11 13:15 45浏览
  • 【萤火工场CEM5826-M11测评】OLED显示雷达数据本文结合之前关于串口打印雷达监测数据的研究,进一步扩展至 OLED 屏幕显示。该项目整体分为两部分: 一、框架显示; 二、数据采集与填充显示。为了减小 MCU 负担,采用 局部刷新 的方案。1. 显示框架所需库函数 Wire.h 、Adafruit_GFX.h 、Adafruit_SSD1306.h . 代码#include #include #include #include "logo_128x64.h"#include "logo_
    无垠的广袤 2024-12-10 14:03 69浏览
  • 我的一台很多年前人家不要了的九十年代SONY台式组合音响,接手时只有CD功能不行了,因为不需要,也就没修,只使用收音机、磁带机和外接信号功能就够了。最近五年在外地,就断电闲置,没使用了。今年9月回到家里,就一个劲儿地忙着收拾家当,忙了一个多月,太多事啦!修了电气,清理了闲置不用了的电器和电子,就是一个劲儿地扔扔扔!几十年的“工匠式”收留收藏,只能断舍离,拆解不过来的了。一天,忽然感觉室内有股臭味,用鼻子的嗅觉功能朝着臭味重的方向寻找,觉得应该就是这台组合音响?怎么会呢?这无机物的东西不会腐臭吧?
    自做自受 2024-12-10 16:34 136浏览
  • RK3506 是瑞芯微推出的MPU产品,芯片制程为22nm,定位于轻量级、低成本解决方案。该MPU具有低功耗、外设接口丰富、实时性高的特点,适合用多种工商业场景。本文将基于RK3506的设计特点,为大家分析其应用场景。RK3506核心板主要分为三个型号,各型号间的区别如下图:​图 1  RK3506核心板处理器型号场景1:显示HMIRK3506核心板显示接口支持RGB、MIPI、QSPI输出,且支持2D图形加速,轻松运行QT、LVGL等GUI,最快3S内开
    万象奥科 2024-12-11 15:42 65浏览
  • 习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习笔记&记录学习习笔记&记学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记录学习学习笔记&记
    youyeye 2024-12-10 16:13 105浏览
  • 时源芯微——RE超标整机定位与解决详细流程一、 初步测量与问题确认使用专业的电磁辐射测量设备,对整机的辐射发射进行精确测量。确认是否存在RE超标问题,并记录超标频段和幅度。二、电缆检查与处理若存在信号电缆:步骤一:拔掉所有信号电缆,仅保留电源线,再次测量整机的辐射发射。若测量合格:判定问题出在信号电缆上,可能是电缆的共模电流导致。逐一连接信号电缆,每次连接后测量,定位具体哪根电缆或接口导致超标。对问题电缆进行处理,如加共模扼流圈、滤波器,或优化电缆布局和屏蔽。重新连接所有电缆,再次测量
    时源芯微 2024-12-11 17:11 65浏览
  • 近日,搭载紫光展锐W517芯片平台的INMO GO2由影目科技正式推出。作为全球首款专为商务场景设计的智能翻译眼镜,INMO GO2 以“快、准、稳”三大核心优势,突破传统翻译产品局限,为全球商务人士带来高效、自然、稳定的跨语言交流体验。 INMO GO2内置的W517芯片,是紫光展锐4G旗舰级智能穿戴平台,采用四核处理器,具有高性能、低功耗的优势,内置超微高集成技术,采用先进工艺,计算能力相比同档位竞品提升4倍,强大的性能提供更加多样化的应用场景。【视频见P盘链接】 依托“
    紫光展锐 2024-12-11 11:50 44浏览
我要评论
0
点击右上角,分享到朋友圈 我知道啦
请使用浏览器分享功能 我知道啦