CMAKE初探

最新推荐文章于 2024-06-03 23:17:32 发布
最新推荐文章于 2024-06-03 23:17:32 发布
阅读量461 收藏
点赞数 1
分类专栏： Linux学习 文章标签： Linux cmake
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/jiaolu295/article/details/101128876
版权

前言

折腾了一整天，终于对cmake有了一个初步的了解，掌握了其基本用法和CMakeLists.txt文件的简单编写方法。现在总结一下，主要记录一下有无子文件夹的区别和自己以后编写源文件的目录规范。注意这篇文章的出发点不在于使用复杂的命令来编写CMakeLists.txt，而是比较几种不同情况下其编写的区别和养成良好的规范。如果是想学会更多的命令使用，那么可以参考其他的资料。

cmake入门可以参考这篇文档，写的很全面，从中学到了很多。

cmake的安装

1、首先查看自己的系统有没有安装cmake，使用命令cmake --version
2、如果没有安装，

  • 使用命令sudo apt install cmake安装
  • 使用命令sudo apt install cmake-qt-gui安装gui界面，之后可以利用图形化界面进行操作，参考博文的第三栏的使用教程

cmake的编译流程

在 linux 平台下使用 CMake 生成 Makefile 并编译的流程如下：

 	1、编写 CMake 配置文件 CMakeLists.txt 。
    2、执行命令 cmake PATH 或者 ccmake PATH 生成 Makefile 1 1ccmake 和 cmake 的区别在于前者提供了一个交互式的界面。 。其中， PATH 是 CMakeLists.txt 所在的目录。
    3、使用 make 命令进行编译。

其中最重要的任务就是 CMakeLists.txt 文件的编写。下面分几种不同情况讨论CMakeLists.txt 编写的不同。

CMakeLists.txt 编写示例

写在前面

  • 在你源文件的根目录下创建一个build文件夹，用来放置编译过程产生的中间文件和可执行文件，这个过程叫做OUT OF SOURCE，之所以这么做的原因是因为cmake和make的过程中会产生很多的文件，如果不单独放置的话就会和源文件混杂在一起，这不是我们想要的。
  • 顶层的 CMakeLists.txt 文件必须放在该工程的根目录下
  • 此篇示例基于以下三个文件，不同之处就在于放置的位置不同
  • main.c中头文件必须路径明确：#include “lib/hello.h”（其他文件的路径也得明确，除非在统一目录下）

main.c内容如下

	#include "lib/hello.h"
 	int main()
    {
		 hello("World");
		 return 0;
    }

hello.h内容如下

    #ifndef  __HELLO_
    #define  __HELLO_
	void hello(const char* name);
	#endif

hello.c内容如下

	#include <stdio.h>
	#include "hello.h"
	void hello(const char * name)
 	{
 		printf ("Hello %s!/n", name);
    }

Demo1

main函数放在根目录下，库函数放在/lib子目录下（每个子目录下都有CMakeLists.txt 文件）

根目录下文件如下图：
在这里插入图片描述
/lib目录下文件如下图：
在这里插入图片描述
顶层CMakeLists.txt

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)

#项目信息
project(HELLO)

# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_SRCS 变量
aux_source_directory(. DIR_SRCS)

# 添加子目录
add_subdirectory(lib)

# 指定生成目标 
add_executable(Demo ${DIR_SRCS})

# 添加链接库
target_link_libraries(Demo libhello)

/lib中的CMakeLists.txt

# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_LIB_SRCS 变量
aux_source_directory(. DIR_LIB_SRCS)

#添加库文件
add_library(libhello ${DIR_LIB_SRCS})

编译后/build文件夹下内容
在这里插入图片描述
编译后build/lib文件夹下内容
在这里插入图片描述

注：有没有什么发现？是不是发现/build里面文件目录的架构和你根目录下的架构是一样的。这是由于你每个子目录下都有一个CMakeLists.txt 文件，一层一层向下发展，所以/build里面的架构和你原先的架构是一样的。
还有就是，你的可执行文件在哪里？是不是和你main.c文件的位置是对应的。你的库文件在哪里？是不是和你的/lib是对应的。发现了吧，它们是一一对应的，很重要！！！

Demo2

main函数放在/src子目录下，库函数放在/lib子目录下（每个子目录下都有CMakeLists.txt 文件）

根目录下文件如下图：
在这里插入图片描述
/src子目录下文件如下图：
在这里插入图片描述
/lib子目录下文件如下图：
在这里插入图片描述
顶层CMakeLists.txt

# CMake 最低版本号要求
CMAKE_MINIMUM_REQUIRED (VERSION 2.8)

# 项目信息
PROJECT(hello)

# 增加静态库子目录
ADD_SUBDIRECTORY(src)
ADD_SUBDIRECTORY(lib)

/src中的CMakeLists.txt

# 查找目录下所有源文件
AUX_SOURCE_DIRECTORY(. DIR_SRCS)

# 指定生成目标
ADD_EXECUTABLE(hello ${DIR_SRCS})

#指定连接库
TARGET_LINK_LIBRARIES(hello libhello)

/lib中的CMakeLists.txt

# 查找目录下所有源文件
AUX_SOURCE_DIRECTORY(. DIR_LIB_SRCS)

#增加库函数
ADD_LIBRARY(libhello ${DIR_LIB_SRCS})

编译后/build文件夹下内容
在这里插入图片描述
编译后/build/src文件夹下内容
在这里插入图片描述
编译后/build/lib文件夹下内容
在这里插入图片描述

注：有没有什么发现？是不是发现/build里面文件目录的架构和你根目录下的架构是一样的。这是由于你每个子目录下都有一个CMakeLists.txt 文件，一层一层向下发展，所以/build里面的架构和你原先的架构是一样的。
还有就是，你的可执行文件在哪里？是不是和你main.c文件的位置是对应的。你的库文件在哪里？是不是和你的/lib是对应的。发现了吧，它们是一一对应的，很重要！！！

Demo3

main函数放在/src子目录下，库函数放在/src子目录下的/lib子目录下（每个子目录下都CMakeLists.txt 文件）

根目录下文件如下图：
在这里插入图片描述
/src子目录下文件如下图：
在这里插入图片描述
src/lib子目录下文件如下图：
在这里插入图片描述
顶层CMakeLists.txt

# CMake 最低版本号要求
CMAKE_MINIMUM_REQUIRED (VERSION 2.8)

# 项目信息
PROJECT(hello)

# 增加静态库子目录
ADD_SUBDIRECTORY(src)

/src中的CMakeLists.txt

# 查找目录下所有源文件
AUX_SOURCE_DIRECTORY(. DIR_SRCS)

# 增加静态库子目录
ADD_SUBDIRECTORY(lib)

# 指定生成目标
ADD_EXECUTABLE(hello ${DIR_SRCS})

#指定连接库
TARGET_LINK_LIBRARIES(hello libhello)

/lib中的CMakeLists.txt

# 查找目录下所有源文件
AUX_SOURCE_DIRECTORY(. DIR_LIB_SRCS)

#增加库文件
ADD_LIBRARY(libhello ${DIR_LIB_SRCS})

编译后/build文件夹下内容
在这里插入图片描述
编译后/build/src文件夹下内容
在这里插入图片描述
编译后/build/lib文件夹下内容
在这里插入图片描述

注：有没有什么发现？是不是发现/build里面文件目录的架构和你根目录下的架构是一样的。这是由于你每个子目录下都有一个CMakeLists.txt 文件，一层一层向下发展，所以/build里面的架构和你原先的架构是一样的。
还有就是，你的可执行文件在哪里？是不是和你main.c文件的位置是对应的。你的库文件在哪里？是不是和你的/lib是对应的。发现了吧，它们是一一对应的，很重要！！！

Demo4

main函数放在/src子目录下，库函数放在/src子目录下的/lib子目录下（只有一个顶层CMakeLists.txt 文件，子目录下不包含CMakeLists.txt 文件）

根目录下文件如下图：
在这里插入图片描述
/src子目录下文件如下图：
在这里插入图片描述
/lib子目录下文件如下图：
在这里插入图片描述
顶层CMakeLists.txt

# CMake 最低版本号要求
CMAKE_MINIMUM_REQUIRED (VERSION 2.8)

# 查找目录下所有源文件
AUX_SOURCE_DIRECTORY(src DIR_SRCS)
AUX_SOURCE_DIRECTORY(src/lib DIR_LIB_SRCS)

# 项目信息
PROJECT(hello)

# 指定生成目标
ADD_EXECUTABLE(QuadrupedRobotCtrlProg ${DIR_SRCS} ${DIR_LIB_SRCS})

#指定连接库
#TARGET_LINK_LIBRARIES(QuadrupedRobotCtrlProg m)

编译后/build文件夹下内容
在这里插入图片描述

注：有没有什么发现？是不是发现/build里面文件目录的架构和你根目录下的架构不一样啦。这是由于你子目录下不包含CMakeLists.txt 文件了，所以/build里面的架构和你原先的架构不一样啦。
还有什么发现，这个示例和Demo3除了CMakeLists.txt 文件只在顶层有之外，其它地方完全一样。
你会发现你的可执行文件在/build目录下，这样在你编译完成要执行的时候就不用再切换目录到你的可执行文件下啦，因为我们就在这里。

这就是下面编写源文件目录规范的来源啦。我们来看看

源文件目录架构规范

注：这只是个人的规范，希望自己尽量这么来架构，因为有几点方便之处：
1、只需要编写一个CMakeLists.txt 文件
2、可执行文件直接放在/build下，可直接执行而不用切换目录
既然只是个人的规范，那肯定就不会适用于所有人，大家参考一下就可以啦。由于自己现在编写项目的经验有限，可能也只适用于现在的自己，之后有更新再来补充。大家有任何建议也可以一起讨论。

  • 根目录下放置/build、/src和CMakeLists.txt
  • main.c文件放在/src顶层
  • 其他库文件和功能文件放在/src中的子目录下

大致来说就是下面这样的：

根目录下架构：
在这里插入图片描述
/src子目录下架构：（当然除了main.c以外还可以放置其他一些必要的文件）
在这里插入图片描述/app子目录下架构：
在这里插入图片描述
/dev子目录下架构：
在这里插入图片描述
/usr_lib子目录下架构：(可以看到下面可以继续放置子文件夹)
在这里插入图片描述
/usr_lib/CMAT子目录下架构：（其他子文件夹类似）
在这里插入图片描述顶层CMakeLists.txt 文件：

# CMake 最低版本号要求
CMAKE_MINIMUM_REQUIRED (VERSION 2.8)

# 查找目录下所有源文件
AUX_SOURCE_DIRECTORY(src DIR_SRCS)
AUX_SOURCE_DIRECTORY(src/usr_lib/CMAT DIR_CMAT_SRCS)
AUX_SOURCE_DIRECTORY(src/usr_lib/RC DIR_RC_SRCS)
AUX_SOURCE_DIRECTORY(src/usr_lib/TP DIR_TP_SRCS)
AUX_SOURCE_DIRECTORY(src/usr_lib/FILTER DIR_FILTER_SRCS)
AUX_SOURCE_DIRECTORY(src/usr_lib/QUEUE DIR_QUEUE_SRCS)
AUX_SOURCE_DIRECTORY(src/usr_lib/PID DIR_PID_SRCS)
AUX_SOURCE_DIRECTORY(src/dev DIR_DEV_SRCS)
AUX_SOURCE_DIRECTORY(src/app DIR_APP_SRCS)

# 项目信息
PROJECT(QuadrupedRobotCtrlProg)

# 指定生成目标
ADD_EXECUTABLE(QuadrupedRobotCtrlProg ${DIR_SRCS} ${DIR_CMAT_SRCS} ${DIR_PID_SRCS} ${DIR_RC_SRCS} ${DIR_TP_SRCS} ${DIR_DEV_SRCS} ${DIR_FILTER_SRCS} ${DIR_QUEUE_SRCS} ${DIR_APP_SRCS})

#指定连接库
TARGET_LINK_LIBRARIES(QuadrupedRobotCtrlProg m)	#里面的参数m表示math	lib

/build下的文件长这样：
在这里插入图片描述

是不是清晰明了，没有子文件夹，可执行文件就在这里的顶层，可以直接编译完成后执行而不用更改当前目录

备注

aux_source_directory 查找在某个路径下的所有源文件。

aux_source_directory(< dir > < variable >)

搜集所有在指定路径下的源文件的文件名，将输出结果列表储存在指定的变量中。该命令主要用在那些使用显式模板实例化的工程上，这样可以避免手工罗列所有的实例。
使用该命令来避免为一个库或可执行目标写源文件的清单，是非常具有吸引力的。但是如果该命令貌似可以发挥作用，那么CMake就不需要生成一个感知新的源文件何时被加进来的构建系统了（也就是说，新文件的加入，并不会导致CMakeLists.txt过时，从而不能引起CMake重新运行。——译注）。正常情况下，生成的构建系统能够感知它何时需要重新运行CMake，因为需要修改CMakeLists.txt来引入一个新的源文件。当源文件仅仅是加到了该路径下，但是没有修改这个CMakeLists.txt文件，使用者只能手动重新运行CMake来产生一个包含这个新文件的构建系统

jiaolu☞
关注
  • 1
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
专栏目录
【CMake 入门与进阶（4）】 CMakeLists.txt 语法规则基础及部分常用指令-续（附使用代码）
cj_lsk的博客
06-06 688
使用 include_directories 命令将当前目录下的 include 文件夹添加到头文件搜索列表中，进入 build 目录下，执行 cmake、make 进行构建、编译，编译过程是没有问题的，不会报错提示头文件找不到；与 include_directories 命令相同，当调用 add_subdirectory 命令加载子源码时，会将 link_directories 命令包含的目录列表以及 link_libraries 命令包含的链接库列表向下传递给子源码（子源码从父源码中继承过来）。
【CMake】顶层 CMakeList.txt 常用命令总结
weixin_45725295的博客
03-09 808
功能：为项目设置cmake的最低要求版本命令格式命令详解和major：主版本号minor：次版本号patch：补丁版本号tweak：微调版本号如果执行构建的cmake版本低于，项目构建会停止并且会报告错误如果指定，必须至少为，影响策略设置。
CMake详解
顺其自然~专栏
01-07 7153
CMake（cross platform make）是一个跨平台的安装（编译）工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。只是 CMake 的组态档取名为 CMakeLists.txt。Cmake 并不直接建构出最终的软件，而是产生标准的建构档（如 Unix 的 Makefile 或 Windows Visual C++ 的 projects/workspaces），然后
CMake4-指令7：aux_source_directory【自动查找所有“源码文件”放入变量中】、file【自动查找所有“头文件”放入变量中】【添加头文件和源码文件后不用修改cmake代码】
u013250861的博客
06-03 200
​aux_source_directory 查找在某个路径下的所有源文件​搜集所有在指定路径下的源文件的文件名，并将输出结果列表储存在指定的变量中。
Makefile静态库动态库的构建和链接之工程实用篇
taifyang的博客
02-25 2463
现有C++工程目录结构如下：add.hadd.cppmain.cpp。
Cmake(3)——Cmake找文件命令和头文件路径命令
IVY_WANG_QAQ的博客
01-23 2256
在处理大型项目时，如果项目目录下存在大量源文件，逐个添加会非常耗时。要解决这个问题，我们可以利用Cmake提供的其他命令，例如文件搜索命令。通过这些命令，我们可以轻松地解决这个问题，提高构建效率。
Professional CMake pdf
02-01
### 专业知识点：《Professional CMake》概览与核心概念 #### 一、CMake简介与背景 - **定义**：CMake是一款跨平台的自动构建系统，它使用一种简单的域特定语言（DSL）来描述软件编译流程，能够自动生成特定构建...
cmake-3.14.0
04-08
安装cmake，若通过yum已经安装cmake,应该 卸载系统的低版本cmake yum remove cmake #卸载yum安装的版本，若无安装则忽略 cd /usr/local/src wget https://cmake.org/files/v3.14/cmake-3.14.0.tar.gz tar vzxf ...
Modern CMake
最新发布
06-15
### Modern CMake：深入解析与应用实践 #### 引言：现代CMake的引入 现代CMake是指CMake 3.5及更高版本，它在功能性和易用性上都有了显著提升。随着C++的发展，尤其是C++11及后续版本的出现，构建系统也面临着新的...
CMAKE 3.25 windows版本
11-30
CMake是一款跨平台的自动化构建系统，用于管理软件构建过程，尤其在C++项目中广泛应用。CMake 3.25是CMake的一个特定版本，它在先前版本的基础上进行了优化和增强，旨在提供更稳定、高效和功能丰富的构建环境。 在...
modern_cmake
05-14
使用现代cmake（target_ *） 例子： # create library add_library(Box2D file.cpp) target_compile_features(Box2D PUBLIC cxx_std_11) target_include_directories(Box2D PUBLIC ${CMAKE_CURRENT_SOURCE_DIR}) #...
Cmake--aux_source_directory
weixin_33721344的博客
03-28 818
2019独角兽企业重金招聘Python工程师标准>>> ...
Cmakelist知识总结
niewei120的博客
10-08 9223
本文章从静态库 到动态库的基本概念和基本知识讲起，详细讲解了cmakelist的基本用法，保证实现代码的编译和运行
cmake 编译boost库遇到的坑
m0_37981386的博客
05-26 1万+
错误：CMakeFiles/main.dir/main.cpp.o: In function `boost::asio::detail::posix_event::posix_event()':/usr/local/include/boost/asio/detail/impl/posix_event.ipp:42: undefined reference to `pthread_condattr_...
cmake学习笔记
qq_31507523的博客
03-20 339
cmake学习笔记 文章目录cmake学习笔记一、入门案列1二、案列2   一、入门案列1 vim main.c #include <stdio.h> int main(){ printf("Hello World!\n"); return 0; } vim CMakeLists.txt # 表示需要cmake的最低版本 make_minimum_required (VERSION 2.8) # 工程名 project (p_hello) # 二进制elf文件名
cmake的file命令
sinat_31608641的博客
03-30 8861
一、介绍 CMake的文件操作命令 Reading file(READ <filename> <out-var> [...]) file(STRINGS <filename> <out-var> [...]) file(<HASH> <filename> <out-var>) file(TIMESTAMP <filename> <out-var> [...]) Writing
CMake入门指南
weixin_34302561的博客
05-22 5509
CMake是一个比make更高级的编译配置工具，它可以根据不同平台、不同的编译器，生成相应的Makefile或者vcproj项目。通过编写CMakeLists.txt，可以控制生成的Makefile，从而控制编译过程。CMake自动生成的Makefile不仅可以通过make命令构建项目生成目标文件，还支持安装（make install）、测试安装的程序是否能正确执行（make test，或者cte...
CMake学习（二）
abc869788668的博客
07-05 532
转自http://blog.csdn.net/sinat_31135199/article/details/69562995 一、基本使用 安装：下载二进制包后可直接解压使用 从源码安装则执行命令：./bootstrap; make; make install——尝试执行bootstrap失败 使用：cmake dir_path，生成工程文件或makefile文件 二、概念 out
CMakeLists.txt 语法介绍与实例演练
热门推荐
阿飞的博客
07-25 23万+
一、Cmake 简介 cmake 是一个跨平台、开源的构建系统。它是一个集软件构建、测试、打包于一身的软件。它使用与平台和编译器独立的配置文件来对软件编译过程进行控制。 二、常用命令 1. 指定 cmake 的最小版本 cmake_minimum_required(VERSION 3.4.1) 这行命令是可选的，我们可以不写这句话，但在有些情况下，如果 CMakeLists.tx...
Professional CMake实践指南
"Professional CMake: A Practical Guide" 《Professional CMake》是一本深入介绍CMake构建系统的实践指南，由Craig Scott撰写。这本书涵盖了CMake的基础到高级应用，旨在帮助开发者更有效地管理和构建C++项目。第...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值