CMake

已于 2022-08-27 22:37:42 修改
阅读量416 收藏
点赞数
分类专栏： Linux-tools 文章标签： linux
于 2022-08-27 22:30:58 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/heartbeat196/article/details/126563467
版权

简介

官网 : https://cmake.org/cmake/help/v3.15/

CMake是跨平台的 免费和开源软件，用于使用独立于编译器的方法构建自动化、测试、打包和安装软件。CMake 本身并不是一个构建系统；它生成另一个系统的构建文件。它支持目录层次结构和依赖于多个库的应用程序。它与原生构建环境结合使用，例如Make、Qt Creator、Ninja、Android Studio、Apple 的Xcode和Microsoft Visual Studio。（摘自Wiki）

CMakeLists.txt

常用命令

  1. cmake要求最低版本(选择性添加)

    cmake_minimum_required(VERSION 3.0.0)

  2. 编译工程名

    project(xxx)
//会自动创建两个变量，PROJECT_SOURCE_DIR和PROJECT_NAME
//${PROJECT_SOURCE_DIR}：本CMakeLists.txt所在的文件夹路径
//${PROJECT_NAME}：本CMakeLists.txt的project名称

  3. 给部分文件或路径组合起别名, 通过${变量}获取变量内容

    set(变量 文件名/路径/...)

  4. 设置c / c++ 编译编译参数

    set (CMAKE_C_FLAGS -Wall -O2)
set (CMAKE_CXX_FLAGS -Wall -std=C++11)
add_compile_options( -Wall )				//该命令译选项是针对所有编译器的(包括c和c++编译器)

  5. 为当前路径以及子目录的源文件加入由-D引入的define flag

    add_definitions(-DFOO -DDEBUG ...)

  6. 对子文件夹进行cmake编译

    add_subdirectory(子文件夹名)

  7. 打印信息

    message() 			//直接添加打印的内容和变量即可,不需要双引号
message("PROJECT_SOURCE_DIR = ${PROJECT_SOURCE_DIR}")

  8. 帮助信息

    1. 查看cmake默认变量		cmake --help-variable-list

判断语句

用法：根据某个宏确定编译内容。比较字符串，相同返回true

if (CPU_PLATFORM_BIT STREQUAL "64")
    add_library(mylib generic_64bit.c)
else()
    add_library(mylib generic_32bit.c)
endif()

编译目标

二进制文件

add_executable(目标文件名字xxx 源文件)
//example: add_executable(${PROJECT_NAME} example_person.cpp)

动态 / 静态库

将指定的源文件生成链接文件，然后添加到工程中去

add_library(<name> [STATIC | SHARED | MODULE]
[EXCLUDE_FROM_ALL]
[source1] [source2] [...])

//<name>表示库文件的名字，该库文件会根据命令里列出的源文件来创建。生成的库自动补全,如libxxx.so 
//STATIC、SHARED和MODULE的作用是指定生成的库文件的类型。STATIC库是目标文件的归档文件，在链接其它目标的时候使用。SHARED库会被	动态链接（动态链接库），在运行时会被加载。MODULE库是一种不会被链接到其它目标中的插件，但是可能会在运行时使用dlopen-系列的函数	。默认状态下，库文件将会在于源文件目录树的构建目录树的位置被创建，该命令也会在这里被调用。
//source1 source2分别表示各个源文件

链接/路径

头文件路径

添加头文件的查找路径, 相当于命令行的 -l 参数

include_directories(../thirdparty/comm/include)

链接库路径

添加需要链接的库文件目录, 相当于命令行 -L 参数

link_directories("/home/server/third/lib")

链接库

将目标文件与库文件进行链接

target_link_libraries(<target> [item1] [item2] [...] [[debug|optimized|general] <item>] ...)
 
//<target>是指通过add_executable()和add_library()指令生成已经创建的目标文件
//[item]表示库文件没有后缀的名字。默认情况下，库依赖项是传递的。当这个目标链接到另一个目标时，链接到这个目标的库也会出现在另一个目标的连接线上。这个传递的接口存储在interface_link_libraries的目标属性中，可以通过设置该属性直接重写传递接口。

安装（Install）

  • 详情参考：https://cmake.org/cmake/help/v3.22/command/install.html
  • 作用：用于定义安装规则，安装内容包括可执行文件，静态库，动态库以及文件，目录，脚本等
  • 使用方法：make install
  • 目标安装路径：${CMAKE_INSTALL_PREFIX}指定，默认/usr/local

目标文件安装

目标文件指的是我们通过 add_executable / add_library 得到的二进制文件或者库，只有这些文件才可以通过该命令装载到相应的位置

  • 可执行文件：RUNTIME
  • 动态库：LIBRARY
  • 静态库：ARCHIVE
install(TARGETS targets... [EXPORT <export-name>]
        [RUNTIME_DEPENDENCIES args...|RUNTIME_DEPENDENCY_SET <set-name>]
        [[ARCHIVE|LIBRARY|RUNTIME|OBJECTS|FRAMEWORK|BUNDLE|
          PRIVATE_HEADER|PUBLIC_HEADER|RESOURCE]
         [DESTINATION <dir>]
         [PERMISSIONS permissions...]
         [CONFIGURATIONS [Debug|Release|...]]
         [COMPONENT <component>]
         [NAMELINK_COMPONENT <component>]
         [OPTIONAL] [EXCLUDE_FROM_ALL]
         [NAMELINK_ONLY|NAMELINK_SKIP]
        ] [...]
        [INCLUDES DESTINATION [<dir> ...]]
        )
        
// example:
install(TARGETS mybin mystaiclib mydynamiclib
        RUNTIME DESTINATION bin
        ARCHIVE DESTINATION lib
        LIBRARY DESTINATION lib)

普通文件安装

普通文件即需要导出的头文件、依赖的三方库等等，该命令同时可以指定导出文件的权限（默认644）

install(<FILES|PROGRAMS> files...
        TYPE <type> | DESTINATION <dir>
        [PERMISSIONS permissions...]
        [CONFIGURATIONS [Debug|Release|...]]
        [COMPONENT <component>]
        [RENAME <name>] [OPTIONAL] [EXCLUDE_FROM_ALL])
        
// example
install(FILES mylib.h DESTINATION include)

目录安装

参数介绍：

  • DIRECTORY：后面连接的是所在Source目录的相对路径（结尾是否是"/"对拷贝结果有一定影响）
  • PATTERN：使用正则表达式进行过滤
  • PERMISSIONS：指定PATTERN过滤后的文件权限。
install(DIRECTORY dirs...
        TYPE <type> | DESTINATION <dir>
        [FILE_PERMISSIONS permissions...]
        [DIRECTORY_PERMISSIONS permissions...]
        [USE_SOURCE_PERMISSIONS] [OPTIONAL] [MESSAGE_NEVER]
        [CONFIGURATIONS [Debug|Release|...]]
        [COMPONENT <component>] [EXCLUDE_FROM_ALL]
        [FILES_MATCHING]
        [[PATTERN <pattern> | REGEX <regex>]
         [EXCLUDE] [PERMISSIONS permissions...]] [...])

// example
install(DIRECTORY src/ DESTINATION include/myproj  FILES_MATCHING PATTERN "*.h")

Q&A

  1. Q: 编译参数添加了-lpthread 参数, 但是还是报undefined reference to `pthread_create’

    A : 需要使用target_link_libraries( target thread) 在这里链接thread库

  2. Q: 如果在多级的目录下编译, 始终找不到问题报 undefine的问题 ?

    A : 看一下是不是链接的库或目标文件格式不同, 一个c 一个c++ , 这样就会导致找不到符号错误

  3. Q: undefined reference to `typeinfo for xxxBase_class’ ?

    A: 基类的构造和析构函数需要加{ }; 否则就会报这个问题

Makefile

通配符

通配符使用说明
*匹配0个或者是任意个字符
?匹配任意一个字符
[]我们可以指定匹配的字符放在 “[]” 中
%匹配任意个字符

自动化变量

自动化变量说明
$@表示规则的目标文件名。如果目标是一个文档文件（Linux 中，一般成 .a 文件为文档文件，也成为静态的库文件）， 那么它代表这个文档的文件名。在多目标模式规则中，它代表的是触发规则被执行的文件名。
$%当目标文件是一个静态库文件时，代表静态库的一个成员名。
$<规则的第一个依赖的文件名。如果是一个目标文件使用隐含的规则来重建，则它代表由隐含规则加入的第一个依赖文件。
$?所有比目标文件更新的依赖文件列表，空格分隔。如果目标文件时静态库文件，代表的是库文件（.o 文件）。
$^代表的是所有依赖文件列表，使用空格分隔。如果目标是静态库文件，它所代表的只能是所有的库成员（.o 文件）名。 一个文件可重复的出现在目标的依赖中，变量“ ”只记录它的第一次引用的情况。就是说变量“ ”只记录它的第一次引用的情况。就是说变量“ ”只记录它的第一次引用的情况。就是说变量“”会去掉重复的依赖文件。
$+类似“$^”，但是它保留了依赖文件中重复出现的文件。主要用在程序链接时库的交叉引用场合。
$*在模式规则和静态模式规则中，代表“茎”。“茎”是目标模式中“%”所代表的部分（当文件名中存在目录时， “茎”也包含目录部分）。

特殊函数

添加前缀

  • 函数名：addprefix( )
  • 语法：$(addprefix PREFIX/,${NAME…})
  • 函数功能：为“NAMES…”中的每一个文件名添加前缀“PREFIX”。参数“NAMES…”是空格分割的文件名序列，将“PREFIX”添加到此序列的每一个文件名之前。
  • 返回值：以单空格分割的添加了前缀“PREFIX”的文件名序列。
$(addprefix src/,foo bar)
//返回值为“src/foo src/bar”

过滤器

  • 函数名：filter( )
  • 语法：$(filter SUFFIX…,$(SOURCES))
  • 作用：保留字串 " $(SOURCES)" 中所有符合模式 “ SUFFIX ” 的单词
sources := main.c AT.txt
foo : $(sources)
    cc $(filter %.c,%.s,$(sources)) -o foo

打印

用于Makefile的Debug，打印分为三个等级：info、warning、error

$(info SRC = $(SRC))
$(warning INC = $(INC))
//注意：执行到error会直接stop退出
$(error INC = $(INC))

Linux相关更多内容请关注 yanglieee.com，讲持续发布！

嵌入E栈
关注
专栏目录
cmake最新版本cmake-3.24.0
06-29
CMake是一款跨平台的构建系统，它用于管理软件构建过程，尤其在多语言、多配置的项目中表现出色。CMake并不直接构建软件，而是生成特定构建工具（如Makefile或Visual Studio项目）所需的配置文件，然后用户可以使用...
CMake变量专题：掌握常用变量和环境变量，助你轻松打造无懈可击工程
Lion_Long的博客
02-22 1635
这篇文章将深入探讨CMake中的常用变量和环境变量，以帮助读者掌握这些关键概念，从而提升对CMake项目管理的技能。我们将详细解析常用变量的定义、用法和最佳实践，使读者能够充分利用这些变量来优化项目结构和提高工作效率。同时，我们也将专注于讨论常用环境变量的作用和应用，帮助读者理解如何在CMake中正确配置和管理项目的环境设置。通过本文的阅读，读者将能够轻松理解和应用CMake中的常用变量和环境变量，从而打造更加高效、无懈可击的工程。
CMake默认环境变量及选择编译器和设置编译器选项
热门推荐
yygr的博客
03-04 1万+
但是这个命令是针对所有类型编译器的，也就是说这里添加的选项会在所有的编译器中运用，比如。在实际的项目平台中可能安装有多个版本的编译器，可以通过如下两种方式设置编译器的版本。这个变量只在当前文件有效，如果项目中有多个模块，多个编译文件，那么需在每一个。编译器的选项，对于其他编程语言，只要替换部分就可以，在当前。的内容，但是如果直接修改这个参数值，那么系统会忽略原。综上，对于一些在整个项目中通用的编译选项可以使用。编译器的参数选项，默认保存环境变量。语言编译器选项，对应于环境变量。的编译器参数，也会被运用在。
CMAKE变量与选择详解
clayhell的博客
06-02 1053
在CMake中，可以使用function命令来定义和使用函数。函数可以用于封装一些常见的操作或者流程，以简化CMake脚本的编写和维护。# 定义一个函数# 调用函数在上述示例中，function命令定义了一个名为my_function的函数，该函数有两个参数arg1和arg2。函数体中使用message命令输出了两个参数的值。接着使用my_function命令调用了该函数，并传递了两个参数"Hello"和"World"。除了基本的参数传递，函数还可以返回值。add(3 5)
（七）CMake变量及其设置
Fishfishfishfishcat
11-27 1万+
CMake变量设置方法如下： set(<variable> <value> [[CACHE <type> <docstring> [FORCE]] | PARENT_SCOPE]) 一个简单的例子： set(Books novel1 novel2 novle3) 值得注意的是，Books的值是novel1 novel2 novle3。注意区分 set(Books "novel1 novel2 novle3") 这里的Books的值是"novel1
【cmake】cmake常用内置变量总结
beidou111的博客
11-06 644
cmake 内置变量
cmake安装包
11-28
CMake是一款跨平台的开源构建系统，用于管理软件构建过程。它通过简洁的配置文件（CMakeLists.txt）来描述项目结构和编译步骤，然后生成针对不同编译器和平台的本地构建文件，如Visual Studio解决方案或Unix ...
cmake3.19.1
11-27
CMake是一款跨平台的自动化构建系统，用于管理软件构建过程。它通过提供一套高级的构建脚本语言（CMake Language）来描述项目构建过程，并能够生成各种编译器和构建工具所需的配置文件，如Unix Makefiles、Visual ...
CMake Practice
03-04
CMake是一种跨平台的构建系统，它用于管理软件构建过程，尤其适合多语言、多配置的项目。CMake不直接生成可执行文件或库，而是生成特定构建工具（如Makefile或Visual Studio项目）的配置文件，这些工具再进行实际的...
CMake MFC配置
09-15
**CMake MFC配置** CMake 是一个跨平台的构建系统，它允许开发者编写平台无关的构建脚本，用于管理项目构建过程。MFC（Microsoft Foundation Classes）是微软提供的一个C++类库，用于简化Windows应用程序开发。在...
CMake 设置开关选项
最新发布
Loup&卡普的博客
06-11 1417
有时候为了方便调试，方便条件式的构建工程项目，则可在 文件中添加开开关选项，并将一系列如自定义的宏定义，和构建或者不构建的工程写入其中，这样仅修改 CMakeLists.txt 文件中的开关选项，使用 cmake 构建工程时，则可便捷开关管理一些列的自定义选项。常使用 命令，它的语法如下： option 中的三个参数，示例： 如创建选项 PRINT_INFO，在选项启用时用输出消息并添加预处理定义 PRINT_INFO ，这样在代码中我们就可以通过判断宏定义来开关我们的调试打印。CMakeLists.t
CMake基础:CMake中的常用变量的命令
探索C++编程的奥秘，分享深入的技术见解和实践，旨在激发读者创造力与解决问题的思维。
03-30 442
适用于所有CMake项目的通用变量和语句
一个实战例子讲解make语法及其用法
weixin_44609676的博客
04-24 104
【代码】make/cmake用例子讲解其用法。
查看CMake变量的默认值方法
BlueShaw的专栏
09-15 3408
使用cmake --help-variable <cmake变量名> 可以查看该变量的默认值和使用场景，简单使用就可以不用再去查cmake手册了。 ~$ cmake --help-variable CMAKE_INSTALL_PREFIX CMAKE_INSTALL_PREFIX -------------------- Install directory used by ``install()``. If ``make install`` is invoked or ``INSTALL``
CMake中install的使用
网络资源是无限的
12-04 1万+
CMake中install的使用
cmake学习笔记 三
zhjs_abc的博客
08-11 1432
cmake
CMake教程系列-05-选项及变量
喜欢打篮球的普通人
06-26 1258
此函数向项目添加一个选项，可以包含选项介绍及默认值。 第一个参数为选项名称。需要注意的是，此选项不仅仅可以是boolean，也可以是string或list。 第二个参数为选项介绍，为string。 第三个参数为选项默认值，依据选项类型设置。 2.CMAKE_DEPENDENT_OPTION 进阶的。我们可以根据一些选项而额外设置其他选项值。 eg： 第一个参数为选项名称。第二个参数为选项介绍。第三个参数为默认值。当第四个参数为TRUE时，开启此选项并自动设置第二个参数的值为默认值。否则，将强制
CMAKE默认变量
weixin_37597675的博客
06-24 1308
代表当前编译的文件指定的生成目录 比如： |–a | |----a.c |–out |—a.o 其中out/就是a.c的CMAKE_CURRENT_BINARY_DIR
cmake的基本参数和用法
09-29 5903
1.CMake编译原理 CMake是一种跨平台编译工具，比make更为高级，使用起来要方便得多。CMake主要是编写CMakeLists.txt文件，然后用cmake命令将CMakeLists.txt文件转化为make所需要的makefile文件，最后用make命令编译源码生成可执行程序或共享库（so(shared object)）。因此CMake的编译基本就两个步骤： 1. cmake 2. make cmake 指向CMakeLists.txt所在的目录，例如cmake .. 表示CMakeList.
cmake
05-30
CMake是一个跨平台的开源构建工具，可用于管理C ++和其他编程语言的构建过程。使用CMake，您可以生成支持不同平台和编译器的本地构建系统，而无需更改代码或构建脚本。 以下是使用CMake的基本步骤： 1. 安装CMake 您可以从CMake官方网站下载适用于您的操作系统的最新版本。安装后，您可以在终端中通过运行“cmake -version”命令来验证是否正确安装了CMake。 2. 创建CMakeLists.txt文件 在您的项目根目录中创建一个名为“CMakeLists.txt”的文件。在此文件中，您将定义项目的构建规则，包括源文件，目标文件，编译器选项等。 3. 创建构建目录 在您的项目根目录外创建一个名为“build”的目录，并移动到该目录中。这是您将在其中构建项目的目录。 4. 运行CMake 在终端中，使用以下命令运行CMake： ``` cmake /path/to/source ``` 其中“/path/to/source”是您的项目源代码目录的路径。CMake将读取CMakeLists.txt文件并生成构建系统文件。 5. 构建项目 在终端中，使用以下命令构建您的项目： ``` cmake --build . ``` 这将使用CMake生成的构建系统文件构建您的项目。 这是使用CMake的基本步骤，您可以根据需要进行更改和自定义。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值