CMake教程（常用命令）

已于 2022-08-27 16:35:27 修改
阅读量717 收藏 2
点赞数
分类专栏： CMake笔记 文章标签： linux window
于 2022-08-27 16:29:49 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/fanrongwoaini/article/details/126559489
版权

1. 指定cmake最小版本

cmake_minimum_required(VERSION 3.0)
这行命令是可选的，我们可以不写这句话，但在有些情况下，如果 CMakeLists.txt 文件中使用了一些高版本 cmake 特有的一些命令的时候，就需要加上这样一行，提醒用户升级到该版本之后再执行 cmake。

2. 设置项目名称

project(demo)
这个命令不是强制性的，但最好都加上。
它会引入两个变量 demo_BINARY_DIR 和 demo_SOURCE_DIR
同时，cmake 自动定义了两个等价的变量 PROJECT_BINARY_DIR 和 PROJECT_SOURCE_D

3、编译类型

add_executable(demo demo.cpp) # 生成可执行文件
add_library(common STATIC util.cpp) # 生成静态库
add_library(common SHARED util.cpp) # 生成共享库（动态库）

  • 在 Linux 下是：
    demo
    libcommon.a
    libcommon.so
  • 在 Windows 下是：
    demo.exe
    common.lib
    common.dll

4、指定编译包含的源文件

4.1、搜索

aux_source_directory(. SRC_LIST) # 搜索当前目录下的所有.cpp文件
add_library(demo ${SRC_LIST})
aux_source_directory(dir VAR) 意思是发现一个目录 dir 下所有的源代码文件，并将列表存储在一个变量 VAR 中。

4.2、自定义搜索规则

file(GLOB SRC_LIST “.cpp" "protocol/.cpp”)
add_library(demo ${SRC_LIST})

或者

file(GLOB SRC_LIST “.cpp")
file(GLOB SRC_PROTOCOL_LIST "protocol/.cpp”)
add_library(demo ${SRC_LIST} ${SRC_PROTOCOL_LIST})

或者

aux_source_directory(. SRC_LIST)
aux_source_directory(protocol SRC_PROTOCOL_LIST)
add_library(demo ${SRC_LIST} ${SRC_PROTOCOL_LIST})
对于收集文件的指令
file(GLOB files LIST_DIRECTORIES false *)
其中，GLOB命令将所有匹配（可选,假如不写，毛都匹配不到）的文件挑选出来，默认以字典顺序排序。

5、查找指定的库文件

默认的搜索路径为 cmake 包含的系统库，因此如果是 NDK 的公共库只需要指定库的 name 即可。
find_library( log-lib log )
类似的命令还有 find_file() 、 find_path() 、 find_program() 、 find_package()。

6、设置包含的目录

include_directories(
${CMAKE_CURRENT_SOURCE_DIR}
${CMAKE_CURRENT_BINARY_DIR}
${CMAKE_CURRENT_SOURCE_DIR}/include
)

Linux 下还可以通过如下方式设置包含的目录

set(CMAKE_CXX_FLAGS “ C M A K E C X X F L A G S − I {CMAKE_CXX_FLAGS} -I CMAKEC​XXF​LAGS−I{CMAKE_CURRENT_SOURCE_DIR}”)

7、设置链接库搜索目录

link_directories(${CMAKE_CURRENT_SOURCE_DIR}/libs)

Linux 下还可以通过如下方式设置包含的目录

set(CMAKE_CXX_FLAGS “ C M A K E C X X F L A G S − L {CMAKE_CXX_FLAGS} -L CMAKEC​XXF​LAGS−L{CMAKE_CURRENT_SOURCE_DIR}/libs”)

8. 设置需要链接的库

在cmake语法中，link_libraries和target_link_libraries是很重要的两个链接库的方式，虽然写法上很相似，但是功能上有很大区别：
link_libraries用在add_executable之前，target_link_libraries用在add_executable之后。
link_libraries用来链接静态库，target_link_libraries用来链接导入库，即按照header file + .lib + .dll方式隐式调用动态库的.lib库。
link_libraries(${log-lib})

${log-lib}无需含有文件后缀，下同

target_link_libraries(demo ${log-lib} )

目标库

目标库需要链接的库

log-lib 是上面 find_library 指定的变量名

在 Windows 下，系统会根据链接库目录，搜索 xxx.lib 文件，Linux 下会搜索 xxx.so 或者 xxx.a 文件，如果都存在会优先链接动态库（so 后缀）

8.1 指定链接动态库或静态库

target_link_libraries(demo libface.a) # 链接libface.a
target_link_libraries(demo libface.so) # 链接libface.so

8.1 指定全路径

target_link_libraries(demo ${CMAKE_CURRENT_SOURCE_DIR}/libs/libface.a)
target_link_libraries(demo ${CMAKE_CURRENT_SOURCE_DIR}/libs/libface.so)

8.3 指定链接多个库

target_link_libraries(demo
${CMAKE_CURRENT_SOURCE_DIR}/libs/libface.a
boost_system.a
boost_thread
pthread)

9. 设置变量

9.1 set 直接设置变量的值

set(SRC_LIST main.cpp test_fun.cpp)
add_executable(demo ${SRC_LIST})

9.2 set 追加设置变量的值

set(SRC_LIST main.cpp)
set(SRC_LIST ${SRC_LIST} test.cpp)
add_executable(demo ${SRC_LIST})

9.3 list 追加或者删除变量的值

set(SRC_LIST main.cpp)

SRC_LIST中追加 test_fun.cpp

list(APPEND SRC_LIST test_fun.cpp)

SRC_LIST中删除 main.cpp

list(REMOVE_ITEM SRC_LIST main.cpp)
add_executable(demo ${SRC_LIST})

10. 条件控制

10.1 if…elseif…else…endif

逻辑判断和比较：

if (expression)：expression 不为空（0,N,NO,OFF,FALSE,NOTFOUND）时为真
if (not exp)：与上面相反
if (var1 AND var2)
if (var1 OR var2)
if (COMMAND cmd)：如果 cmd 确实是命令并可调用为真
if (EXISTS dir) if (EXISTS file)：如果目录或文件存在为真
if (file1 IS_NEWER_THAN file2)：当 file1 比 file2 新，或 file1/file2 中有一个不存在时为真，文件名需使用全路径
if (IS_DIRECTORY dir)：当 dir 是目录时为真
if (DEFINED var)：如果变量被定义为真
if (var MATCHES regex)：给定的变量或者字符串能够匹配正则表达式 regex 时为真，此处 var 可以用 var 名，也可以用 ${var}
if (string MATCHES regex)

数字比较：

if (variable LESS number)：LESS 小于
if (string LESS number)
if (variable GREATER number)：GREATER 大于
if (string GREATER number)
if (variable EQUAL number)：EQUAL 等于
if (string EQUAL number)

字母表顺序比较：

if (variable STRLESS string)
if (string STRLESS string)
if (variable STRGREATER string)
if (string STRGREATER string)
if (variable STREQUAL string)
if (string STREQUAL string)

示例：

if(MSVC)
set(LINK_LIBS common)
else()
set(boost_thread boost_log.a boost_system.a)
endif()
target_link_libraries(demo ${LINK_LIBS})

# 或者

if(UNIX)
set(CMAKE_CXX_FLAGS “${CMAKE_CXX_FLAGS} -std=c++11 -fpermissive -g”)
else()
add_definitions(-D_SCL_SECURE_NO_WARNINGS
D_CRT_SECURE_NO_WARNINGS
-D_WIN32_WINNT=0x601
-D_WINSOCK_DEPRECATED_NO_WARNINGS)
endif()

# 或者

if(${CMAKE_BUILD_TYPE} MATCHES “debug”)
…
else()
…
endif()

10.2 while…endwhile

while(condition)
…
endwhile()

10.3 foreach…endforeach

#start 表示起始数，stop 表示终止数，step 表示步长
foreach(loop_var RANGE start stop [step])
…
endforeach(loop_var)

示例：

foreach(i RANGE 1 9 2)
message(${i})
endforeach(i)

输出：13579

11. 打印信息

message(${PROJECT_SOURCE_DIR})
message(“build with debug mode”)
message(WARNING “this is warnning message”)
message(FATAL_ERROR “this build has many error”) # FATAL_ERROR 会导致编译失败

12. 包含其它 cmake 文件

include(./common.cmake) # 指定包含文件的全路径
include(def) # 在搜索路径中搜索def.cmake文件
set(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake) # 设置include的搜索路径

开始沸腾了
关注
专栏目录
CMake基础教程（30）在cmake里执行命令execute_process
二进制君
03-27 3484
子进程的标准输出是由COMMAND参数指定的命令在执行过程中生成的任何文本输出。如果您需要在构建时执行自定义命令，可以使用add_custom_target()和add_custom_command()命令来创建自定义命令，这些命令会在构建时运行。如果需要按顺序执行多个命令，则可以使用多个execute_process调用，每个调用只包含一个COMMAND参数，以实现顺序执行的效果。如果同时为这两个选项指定了相同的变量名，则子进程的标准输出和标准错误输出将被合并，并按照它们产生的顺序放入变量中。
CMake基础教程（20）认识cmake命令
二进制君
03-14 4524
可以使用的命令有：chdir, copy, copy_if_different copy_directory, compare_files, echo, echo_append, environment, make_directory, md5sum, remove_directory, remove, tar, time, touch, touch_nocreate, write_regv, delete_regv, comspec, create_symlink。在cmake运行时，打印额外的信息；
cmake-3.0.1 linux/unix
09-05
cmake最新版Unix/Linux Source code
CMakeLists.txt语法简介(验证通过)
孤狼北望
10-10 694
文章目录一、Cmake 简介二、常用命令1. 指定 cmake 的最小版本2.设置项目名称3.设置编译类型4. 指定编译包含的源文件5.查找指定的库文件6.设置包含的目录7.设置链接库搜索目录8. 设置 target 需要链接的库9. 设置变量10.条件控制三、常用变量四、cv项目cmakelists五、参考 一、Cmake 简介 cmake 是一个跨平台、开源的构建系统。它是一个集软件构建、测试、打包于一身的软件。它使用与平台和编译器独立的配置文件来对软件编译过程进行控制。 二、常用命令 1. 指定 cm
【Linux】Linux工具——CMake入门
最新发布
2301_80224556的博客
09-26 1383
Makefile想必大家都不陌生吧，它能够解决我们的自动化编译问题，大多是IDE软件都集成了make，譬如 Visual C++的 nmake、linux 下的 GNU make、Qt 的 qmake 等等。不同的IDE所集成的make工具所遵循的规范和标准都不同，也就导致其语法、格式不同，也就不能很好的跨平台编译，会再次使得工作繁琐起来那么cmake为了解决这个问题而诞生了，其允许开发者指定整个工程的编译流程，在根据编译平台，生成本地化的Makefile和工程文件，最后用户只需make编译即可。
cmake常用命令学习
QingTC
08-04 781
才是cmake的正统文件，而.cmake文件是一个模块文件，可以被include到中。include指令一般用于语句的复用，也就是说，如果有一些语句需要在很多CMakeLists.txt文件中使用，为避免重复编写，可以将其写在.cmake文件中，然后在需要的CMakeLists.txt文件中进行include操作就行了。
CMake 默认编译、链接选项
热门推荐
icbm的专栏
08-27 1万+
CMakeLists.txt 文件内容：cmake_minimum_required(VERSION 3.4)message(STATUS "CMAKE_C_FLAGS = " ${CMAKE_C_FLAGS}) message(STATUS "CMAKE_C_FLAGS_DEBUG = " ${CMAKE_C_FLAGS_DEBUG}) message(STATUS "CMAKE_C_FLAGS_
Linux下CMake简明教程
blog
08-17 868
C程序组成：1.可执行文件；2.包含文件（include）；3.依赖的库文件（.so / .a） 操作系统功能：1.命令解释；2.进程管理；3.内存管理；4.输入/输出和外围设备管理；5.文件管理 关机重启指令：shutdown -h now 关机；shutdown -r now 重启。 Linux系统结构：硬件->内核->shell->外层应用程序 ...
Cmake 教程
06-03
CMake 是一个跨平台的构建系统，用于...通过阅读提供的 "cmake教程.pdf" 和 "CMake Practice.pdf"，你可以深入了解这些概念，并通过实践进一步巩固你的 CMake 技能。学习 CMake 能让你的跨平台开发变得更加高效和简单。
CMake基础教程（9）安装规则install命令
二进制君
04-05 7093
文章目录1、install命令2、安装二进制文件2、安装文件3、安装目录 1、install命令 在CMake中，安装是指将二进制文件、库文件和头文件等安装到指定目录中。该命令比较复杂，我们学习几个常用的场景即可。 语法： install(TARGETS <target>... [...]) install(IMPORTED_RUNTIME_ARTIFACTS <target>... [...]) install({FILES | PROGRAMS} <file>...
CMake教程：C++ CMake自定义find_package并在其它项目使用
琅嬛福地
07-22 416
find_package 是 CMake 中一个非常重要的命令，用于在系统中找到外部库或包，并将其包含到项目中。: 要查找的包的名称。[version]: 可选的版本号。如果指定了版本号，CMake 会尝试找到该版本或更高版本的包。[REQUIRED]: 如果指定了这个关键字，找不到包时会产生一个错误并终止配置过程。: 指定要查找的包的组件。: 指定可选的组件，即使找不到这些组件，配置过程也会继续。: 指定查找包的模式，CONFIG表示查找配置文件，MODULE表示查找模块文件。
Linux CMake详解和使用范例一
weixin_41252852的博客
08-09 605
CMake是一个跨平台的编译自动配置工具，它使用一个名为CMakeLists.txt的文件来描述构建过程，可以产生标准的构建文件。它可以用简单的语句来描述所有平台的安装(编译过程)。它能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性，类似UNIX下的automake。CMake并不直接建构出最终的软件，而是产生标准的建构档(如Unix的Makefile或Windows Visual C++的projects/workspaces)，然后再依一般的建构方...
Linux 与 Cmake （一）——了解CMake
Alkaid2000的博客
03-14 3243
我使用的是Ubuntu20.04.1进行学习。 一、那就先使用Linux编写一个C开始吧：Hello World！ （1）在Terminal中编写C语言程序，进行编译调试。首先先熟悉一下Linux的基本操作命令吧： Linux命令的名称 作用 mkdir 新建文件夹 cd 更改当前的工作目录 ls 列出文件夹下包含的文件信息 pwd 查看当前工作目录 cp 拷贝文件 rm 删除文件或文件夹 mv 移动文件 cat 查
CmakeList.txt语法笔记
weixin_37997371的博客
09-26 204
1.可执行文件的安装路径设置方法 SET(CMAKE_INSTALL_PREFIX /usr/local)，默认/usr/local，外部构建情况下执行make install命令时，make会将生成的可执行文件拷贝到/usr/local/bin目录下。 2.INCLUDE_DIRECTORIES(/usr/include/thrift) 添加额外的头文件路径 把/usr/include/thri...
[unix]用cmake写hello world
HeapStackk的博客
10-23 1563
cmake 基础的cmake用法以及语法 Hello World cmake 01版 Hello World cmake 02版 Hello World cmake 03版 cmake语法 project 流控制 if foreach while function macro 正则表达式 检查cmake的版本 模块Module的使用 Find Modules System Introspection
CMakeLists.txt语法规则：条件判断说明一
wojiaxiaohuang2014的博客
05-05 609
CMakeLists.txt 语法规则：条件判断
cmake(二十八)Cmake工具链
wzj_110的博客
05-04 4327
一 toolchain.cmake 5 SET(CMAKE_CXX_FLAGS_DEBUG "$ENV{CXXFLAGS} -O0 -Wall -g -ggdb") 6 SET(CMAKE_CXX_FLAGS_RELEASE "$ENV{CXXFLAGS} -O3 -Wall") 第 5 和 6 行设置了两个变量 CMAKE_CXX_FLAGS_DEBUG 和 CMAKE_CXX_FLAGS_RELEASE, 这两个变量是分别用于 debug 和 release 的'编译选项' 1...
CMakeLists.txt语法规则：条件判断中表达式说明二
wojiaxiaohuang2014的博客
05-06 564
CMakeLists.txt语法规则：条件判断中的表达式
使用Cmake编译项目从入门到精通
cnzzs的博客
08-28 775
cmake 的特点主要有： 1，开放源代码，使⽤类BSD 许可发布。http://cmake.org/HTML/Copyright.html 2，跨平台，并可⽣成native 编译配置⽂件，在Linux/Unix 平台，⽣成 makefile，在苹果平台，可以⽣ 成xcode，在 Windows 平台，可以⽣成 MSVC ...
CMake教程：常用指令与库管理
"这篇文档介绍了CMake的基本知识和常用指令，包括如何添加编译选项、依赖库以及创建链接库。CMake是一个跨平台的构建工具，简化了项目的编译和安装过程，支持多种操作系统和IDE。" 正文: 一、CMake基本知识 1. **...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值