CMake编译学习笔记

于 2023-03-10 15:33:42 发布
阅读量942 收藏 2
点赞数
分类专栏： C++\CMake 文章标签： c++
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/weixin_45929038/article/details/129425465
版权

CMake学习笔记

CMake编译概述

CMake学习资源

对于CMake推荐在项目使用中学习，通过查阅文档和实际测试每个指令的用处能有效的掌握CMake。

CMake编译

项目架构

CMake是一种常用的C++项目编译工具，通常一个完备的CMake项目包括了如下几部分：

  • src：源代码文件夹
  • include：头文件文件夹
  • doc：项目文档文件夹
  • build：编译文件夹
  • devel：ROS1用于保存编译后程序的文件夹
  • run.sh：项目启动脚本（ROS中无）
  • CMakeList.txt：CMake文件，应在项目根目录和各级子文件夹内存在（例如ROS内就是在工作空间根目录和各个功能包根目录下存在）

对于一个C++项目，在编译完成后还可能需要使用make install将其安装至指定位置。

cmake指令

对于一个项目会构建一个build文件夹用于存放编译生成的中间文件，从而避免污染工作空间：

mkdir build & cd build			# 新建build目录并进入
cmake ..						# 构建MakeFile（build父目录）
make -j5						# 编译

cmake ..表示使用cmake构建当前文件夹build的父文件夹（项目根目录）。上述指令还可简化为使用参数--build：

mkdir build & cd build			# 新建build目录并进入
cmake --build ..				# 构建并编译（build父目录）

cmake指令的更多参数和使用可参考官方手册：cmake

CMakeList基础准则

CMakeList文件的编写主要遵从如下几条原则：

  • ${变量名}被用于引用CMake变量，使用IF控制语句除外
  • 指令参数被括弧括起，用空格分开：project(projectname [cxx])
  • 指令是大小写无关的（官方推荐小写），参数、变量是大小写相关的
  • 参数中包括空格，则应用双引号括起："fn nc.c"
  • 使用#注释

CMakeList编写

项目构建

cmake_minimum_required() 和 project()

cmake_minimum_required用于指定所使用CMake的最低版本号，置于CMakeList.txt的开头；project指令则用于指定项目的名称，指令的用法如下：

cmake_minimum_required(VERSION <min>[...<policy_max>] [FATAL_ERROR])
project(<PROJECT-NAME> [<language-name>...])
  • VERSION：关键字，表明后续添加为版本号
    -min： 设置所使用CMake的最低版本号，格式为major.minor[.patch[.tweak]]
    • policy_max：设置所使用的CMake的最高版本号，应高于min
  • <PROJECT-NAME>：设置项目名称
  • <language-name>：设置项目支持的语言，不加表示默认所有编程语言

使用示例如下所示：

cmake_minimum_required(VERSION 3.2.4)
project(Demo)

project指令同时隐式的定义了几个变量：

  • <projectname>_BINARY_DIR：项目编译目录的绝对路径
  • <projectname>_SOURCE_DIR：项目源目录的绝对路径
  • PROJECT_BINARY_DIR：自动绑定<projectname>_BINARY_DIR的内容
  • PROJECT_SOURCE_DIR：自动绑定<projectname>_SOURCE_DIR的内容

通常在调用上述CMake变量时，使用PROJECT_BINARY_DIR和PROJECT_SOURCE_DIR进行，从而避免CMake项目名称修改后需要额外修改其余内容。

更多内容可参考官方指导手册：cmake_minimum_required、project
以及博文Cmake命令之cmake_minimum_required介绍和Cmake命令之project介绍

set()

用于设置variable的值为 value，指令用法如下：

set(<variable> <value>... [PARENT_SCOPE])
  • variable：被设置的参数
  • value：设置的值

例如在CMake中指定使用的C++标准为C++ 14，则可定义变量${CMAKE_CXX_STANDARD}的值为14：

set(CMAKE_CXX_STANDARD 14)
set(CMAKE_CXX_STANDARD_REQUIRED True)

更多用法（环境变量、缓存变量、定义域等）可查看官方手册：set，以及博文Cmake命令之set介绍

find_package()

用于查找包（通常由项目外部的第三方库提供），并加载其包特定的详细信息。指令使用方式如下：

find_package(<PackageName> [version] [EXACT] [QUIET] [MODULE]
             [REQUIRED] [[COMPONENTS] [components...]]
             [OPTIONAL_COMPONENTS components...]
             [REGISTRY_VIEW  (64|32|64_32|32_64|HOST|TARGET|BOTH)]
             [GLOBAL]
             [NO_POLICY_SCOPE]
             [BYPASS_PROVIDER])
  • PackageName：需要查找的包名
  • version：可指定查找包的版本要求
    • versionMin...versionMax：如1.1.1.1…1.2.2.1（包括1.2.2.1）
    • versionMin...[<]versionMax：如1.1.1.1…<1.2.2.1（不包括1.2.2.1）
  • QUIET：禁止输出查找日志信息
  • REQUIRED：当未找到满足条件的包时停止构建
  • COMPONENTS：指定要查找的组件

例如如下即为常见的ROS查找catkin包相关组件：

find_package(catkin REQUIRED COMPONENTS
  geometry_msgs
  message_generation
  nav_msgs
  roscpp
  rospy
  std_msgs
  tf
  visualization_msgs
)

更多使用方法可以参考博文Cmake命令之find_package介绍
以及官方手册：find_package

add_executable()

用于从源码文件编译得到一个可执行文件，指令用法如下：

add_executable(<name> [WIN32] [MACOSX_BUNDLE]
               [EXCLUDE_FROM_ALL]
               [source1] [source2 ...])
  • name：编译所得的可执行文件命名
  • source：用于编译的源文件
  • [EXCLUDE_FROM_ALL]：设置后，表明该可执行文件将被排除在all外，需要手动确定才能执行生成

通常仅指定构建的可执行文件名和使用的源码，如：

add_executable(Demo main.c)

更多用法参考博文Cmake命令之add_executable介绍
以及官方手册：add_executable

aux_source_directory()

当一个文件夹内存在多个源代码时，可使用该指令将其定义为一个变量，从而方便调用：

aux_source_directory(<dir> <variable>)
  • dir：源代码路径
  • variable：变量名

例如，下列示例将当前目录下所有源代码加入至DIR_SRCS，并用其编译生成可执行文件Demo

cmake_minimum_required (VERSION 2.8)
project (Demo2)

aux_source_directory(. DIR_SRCS)
add_executable(Demo ${DIR_SRCS})

更多用法可参考官方手册：aux_source_directory

连接库文件

include_directories()和target_include_directories()

两者都用于将给定目录添加到编译器用于搜索包含文件的目录中，不同之处在于include_directories将对整个CMakeList内每个目标添加搜索路径，而target_include_directories则仅针对指定目标添加搜索路径，两者用法如下：

include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])

target_include_directories(<target> [SYSTEM] [AFTER|BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])
  • <target>：target_include_directories中的指定目标
  • [AFTER|BEFORE]：可显式指定添加头文件搜索路径的位置
    • 在原有搜索路径的最后（AFTER）
    • 在原有搜索路径的最前（BEFORE）
  • dir：include_directories中添加的搜索路径，相对路径将被解释为基于当前源目录开始
  • <INTERFACE|PUBLIC|PRIVATE>
    • INTERFACE ：仅target的头文件可使用该路径
    • PUBLIC：target的头文件和源文件均可以使用
    • PRIVATE：target对应的源文件可以使用
  • items：target_include_directories中添加的搜索路径，相对路径将被解释为基于当前源目录开始

此处可参考博文CMake 添加头文件搜索路径 include_directories, target_include_directories
以及官方手册：include_directories、target_include_directories

add_library()

用于从源码文件编译得到一个库文件，指令用法如下：

add_library(<name> [STATIC | SHARED | MODULE]
            [EXCLUDE_FROM_ALL]
            [<source>...])
  • <name>：构建的库文件的名称，最终生成的库文件名字将根据本机惯例进行产生，如：lib<name>.lib或<name>.a
  • [STATIC | SHARED | MODULE]：构建库文件的类型
    • STATIC：静态库文件
    • SHARED：动态库文件
    • MODULE：模块库文件
  • source：用于编译的源文件
  • [EXCLUDE_FROM_ALL]：设置后，表明该库将被排除在all外，需要手动确定才能执行生成
  • 生成的库文件相关CMake参数以INTERFACE_开头

生成的库文件将被输出至${ARCHIVE_OUTPUT_DIRECTORY}、${LIBRARY_OUTPUT_DIRECTORY}和${RUNTIME_OUTPUT_DIRECTORY}中：

  • ARCHIVE_OUTPUT_DIRECTORY：静态库文件存储位置
  • LIBRARY_OUTPUT_DIRECTORY：Lib文件存储位置
  • RUNTIME_OUTPUT_DIRECTORY：动态库文件存储位置

若需要导入一个已经生成的库文件还可以使用如下方式：

add_library(<name> [STATIC | SHARED | MODULE] 
			IMPORTED [GLOBAL])
  • IMPORTED关键字用于说明该库文件已生成无需编译
  • GLOBAL：设置后表明该库文件全局可见
  • 使用此方法生成的库文件相关CMake参数以IMPORTED_开头

更多用法可以参考博文：cmake : add_library详解或者官方手册：add_library

add_subdirectory()

用于添加需要被构建的子目录，指令用法如下：

add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL] [SYSTEM])
  • source_dir：指定子目录，其内应包含CMakeList.txt文件、源码文件
  • binary_dir：指定输出可执行文件位置

例如项目内包含子文件夹src，其内包括CMakeList.txt和相关源码。则在项目根目录CMakeList.txt中添加如下指令使其被构建：

add_subdirectory(src)

更多用法可以参考博文Cmake命令之add_subdirectory介绍以及官方手册：add_subdirectory

target_link_libraries()

用于连接可执行文件和对应的库文件：

target_link_libraries(<target> ... <item>... ...)
  • target：被连接的可执行文件
  • item：库文件名称、路径等

例如，可执行文件main连接生成的库文件B：

add_executable(main main.c)
add_library(B SHARED b.c)
target_link_libraries(main B)

更多使用方式可参考官方手册：target_link_libraries

target_link_directories()

用于连接可执行文件和用于查找依赖库文件的路径，指令用法如下：

target_link_directories(<target> [BEFORE]
  <INTERFACE|PUBLIC|PRIVATE> [items1...]
  [<INTERFACE|PUBLIC|PRIVATE> [items2...] ...])

更多使用方式可参考官方手册：target_link_directories

安装与日志

在CMake中安装使用install指令实现，针对不同的文件类型，该指令具备不同的使用方式，可参考官方手册查看详细内容：install

install target

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|FILE_SET <set-name>|CXX_MODULES_BMI]
         [DESTINATION <dir>]
         [PERMISSIONS permissions...]
         [CONFIGURATIONS [Debug|Release|...]]
         [COMPONENT <component>]
         [NAMELINK_COMPONENT <component>]
         [OPTIONAL] [EXCLUDE_FROM_ALL]
         [NAMELINK_ONLY|NAMELINK_SKIP]
        ] [...]
        [INCLUDES DESTINATION [<dir> ...]]
        )
  • TARGETS：关键字，表明安装的对象为Target
  • targets：指定目标文件名
  • [ARCHIVE|LIBRARY|RUNTIME……]：指定文件类型
    • ARCHIVE：静态库
    • LIBRARY：动态库
    • RUNTIME：可执行目标二进制文件
  • [DESTINATION <dir>]：指定安装路径
    • 若路径<dir>为绝对路径，以"/"开头
    • 若路径<dir>为相对路径，则实际安装路径为：${CMAKE_INSTALL_PREFIX}<dir>
  • [PERMISSIONS permissions...] ：用户权限，最高777（参考liunx权限）
    • OWNER_WRITE ：拥有者写入权限
    • OWNER_READ ：拥有者读取权限
    • OWNER_EXECUTE ：组成员执行权限
    • GROUP_WRITE ：组成员写入权限
    • GROUP_READ ：组成员读取权限
    • GROUP_EXECUTE ：组成员执行权限
    • WORLD_WRITE ：其他人写入权限
    • WORLD_READ ：其他人读取权限
    • WORLD_EXECUTE ：其他人执行权限

例如，如下使用方式：

install(TARGETS myExe mySharedLib myStaticLib
        RUNTIME DESTINATION bin
        LIBRARY DESTINATION lib
        ARCHIVE DESTINATION lib/static)
install(TARGETS mySharedLib DESTINATION /some/full/path)

上述例子实现如下目标：

  • 二进制文件（RUNTIME）myExe安装至${CMAKE_INSTALL_PREFIX}/bin 下
  • 动态库文件（LIBRARY）mySharedLib安装至${CMAKE_INSTALL_PREFIX}/lib和/some/full/path下
  • 静态库文件（ARCHIVE）myStaticLib安装至${CMAKE_INSTALL_PREFIX}/lib/static下

install Files和install programs

install(<FILES|PROGRAMS> files...
        TYPE <type> | DESTINATION <dir>
        [PERMISSIONS permissions...]
        [CONFIGURATIONS [Debug|Release|...]]
        [COMPONENT <component>]
        [RENAME <name>] [OPTIONAL] [EXCLUDE_FROM_ALL])
  • <FILES|PROGRAMS>：关键字，表明安装的对象类型为FILES或PROGRAMS，应选择其一填写
    • FILES：权限为拥有者读写、组成员读、其余人读（644）
    • PROGRAMS：权限为拥有者读写执行、组成员读执行、其余人读执行（755）
  • files…：指定文件名称
  • TYPE：关键字，表明文件的类型
  • [DESTINATION <dir>]：指定安装路径

文件类型可选如下所示：
在这里插入图片描述

install Directories

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...]] [...])
  • [FILE_PERMISSIONS permissions...]：目录内文件权限
  • [DIRECTORY_PERMISSIONS permissions...]：目录本身权限
  • [USE_SOURCE_PERMISSIONS]：若未指定FILE_PERMISSIONS permissions...，则根据源文件权限赋予
  • [PATTERN <pattern>：采用模式匹配进行筛选内容 <pattern>
  • REGEX <regex>：采用正则匹配进行筛选内容<regex>
  • [EXCLUDE]：安装时，排除筛选得到的文件
  • [PERMISSIONS permissions...]：指定筛选得到的文件的权限

例如使用该命令执行如下：

INSTALL(DIRECTORY icons scripts/ 
		DESTINATION share/myproj
		PATTERN "CVS" EXCLUDE
		PATTERN "scripts/*" PERMISSIONS 
		OWNER_EXECUTE OWNER_WRITE OWNER_READ 
		GROUP_EXECUTE GROUP_READ WORLD_EXECUTE
	   )

上述指令执行如下操作：

  • 将目录icons安装至${CMAKE_INSTALL_PREFIX}/share/myproj
  • 将目录scripts/ 中的内容安装${CMAKE_INSTALL_PREFIX}/share/myproj
  • 在进行安装时，排除名字包含CVS 的文件
  • 在进行安装时，将scripts/* 文件的权限指定为731

message()

用于向终端中输出用户定义的编译日志信息，指令用法如下：

message([<mode>] "message text" ...)
  • mode：日志类型
    • FATAL_ERROR：红色CMake Error，将终止CMake编译
    • SEND_ERROR：CMake Error，将跳过生成但不影响编译
    • WARNING：黄色CMake Warning，不影响CMake编译
    • AUTHOR_WARNING：CMake Warning (dev)，不影响CMake编译
    • STATUS：输出一些编译过程中的简明信息
    • VERBOSE：输出一些编译过程中的详细信息
  • message text：输出的日志内容

更多使用方式可参考官方手册：message

Jason.Li_0012
关注
  • 0
    点赞
  • 踩
  • 2
    收藏
    觉得还不错? 一键收藏
  • 1
    评论
专栏目录
C++ 之CMake代码编译
cangqiongxiaoye的博客
05-01 461
C++ 之CMake代码编写
CMake 编译
fignting_formyself的博客
05-03 2962
cmake编译的步骤：1.创建两个文件夹，都放在xxx源文件夹下 xxx_temp_file   用于存放cmake产生的ITK项目文件 xxx   用于保存编译成功后的bin, include, lib等文件2.CMake编译（1）where is the source code 选择  编译的源文件所在的文件夹位置        where to build the binaries 选择 x...
[2] CMake On Linux - 编译静态库和动态库
WhateverYoung的专栏
01-31 5856
本帖子适用于初学者，StepByStep的入门CMake，CMake也是一门编程语言，只不过是针对编译和链接这种程序构建的过程的语言，学习基本语法就可以初步入门，后面需要什么复杂的功能，进阶掌握需要自己去查找官方文档，后续会给出查阅的一些方式软件平台 Win 7 VMware Workstation 12 Pro Ubuntu 15.10 CMake 3.2.2 case 4目录结构+ | +-
Cmake编译
pf_1308108803的博客
09-16 242
在linux中cd mkdir cmake cd cmake mkdir build include src include下新建add.h头文件里面就一句话 int add(int a,int b); src下创建两个文件 首先是add.cadd.c里面写 #include "../include/add.h"int add(int a,int b){ return a + b; }
cmake编译
热门推荐
weixin_44359953的博客
08-15 1万+
CMake编译原理 CMake是一种跨平台编译工具，比make更为高级，使用起来要方便得多。CMake主要是编写CMakeLists.txt文件，然后用cmake命令将CMakeLists.txt文件转化为make所需要的makefile文件，最后用make命令编译源码生成可执行程序或共享库（so(shared object)）。因此CMake的编译基本就两个步骤： cmake make CMake说明 一般把CMakeLists.txt文件放在工程目录下，使用时，先创建一个叫build的文件夹（这个并
cmake 学习笔记
01-20
CMake 是一个跨平台的构建系统，用于管理项目的构建过程，尤其适合多语言和多配置的项目。在本文中，我们将深入探讨...学习 CMake 不仅能够提高项目构建的效率，还能使开发者更好地控制编译选项，适应不同的开发需求。
学习笔记之cmake
01-09
文件多层次 text.file main.cpp CMakeLists.txt head.file main.h function.cpp CMakeLists.txt 最内层的CMakeList.txt // head.file内的CMakeList.txt #查找当前目录下的所有源文件 ...// text.file内的CMakeList.txt
个人cmake学习笔记
08-24
cmake学习笔记 CMake 是一个跨平台的构建工具，用于管理软件的编译和安装过程。下面是 cmake 的一些基本知识点和使用技巧。 1. 生成器错误解决方案 在使用 cmake 时，可能会遇到生成器错误的问题。解决方案是使用...
cMake 学习笔记，快速入门
06-11
**cMake 学习笔记，快速入门** cMake 是一种跨平台的构建系统，用于管理软件项目的构建过程。它能够生成各种编译器所需的构建文件，如Visual Studio的解决方案文件或Unix Makefiles，使得开发者无需关心底层构建...
Ubuntu下最简单的Cmake编译多个C和C++工程的例子
10-08
Ubuntu下用cmake编译多个C和C++工程的例子，自动生成makefile，执行make命令直接生成运行程序
cmake编译静态库/动态库/可执行文件demo
01-24
最近用到OpenCV，发现OpenCV里到处都在用cmake，特写了cmake编译规则的demo，生成静态库/动态库/可执行文件及测试demo，欢迎下载!
cmake方式编译
manonggou的博客
05-11 1万+
【1】CMake基础 CMake是一种跨平台编译工具 CMake主要是编写CMakeLists.txt文件 通过cmake命令将CMakeLists.txt文件转化为make所需的Makefile文件 再用make命令编译源代码生成可执行程序或库文件 示例流程图如下： 【2】示例工程 （1）项目结构 build 目录 用来构建项目（编译构建中间文件等） include目录 放置头文件 lib 目录是编译生成的库保存路径 src 目录放置源代码实现文件 （2）CMake方式编译
CMake-tutorial(原文)
liufengl138的专栏
04-02 884
CMake-tutorial(原文) 这份渐进式的教程涵盖了 CMake 帮助处理的一些常见的构建问题。许多议题已经在《Mastering CMake》中作为独立的话题介绍过，但是了解它们是如何在示例项目中结合在一起的将非常有帮助。你可以在 CMake 源码中的Tests/Tutorial文件夹找到这份教程，每一步的内容都放置在各自的子文件夹中。 https://github.com/Ca...
编译工具之cmake
双林子木
02-27 4218
简介这儿我们援引自cmake官网(https://cmake.org/overview/)来初步认识cmake是什么东西。 CMake是一个操作系统平台无关和编译器无关的用于管理编译（构建）过程的一个可扩展、开源系统。不像大多数跨平台系统，CMake可以与本地构建环境协同作业。将简单的配置文件放置在源码路径（CMakeLists.txt）用来生成标准的编译文件（Unix系统中生成makefile,
使用cmake编译项目
jiang_T的博客
11-01 752
Cmake 参考文档
linux cmake编译指令
最新发布
08-25
- *2* [Linux学习笔记：使用Cmake编译](https://blog.csdn.net/dingxiaoxv/article/details/126921859)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_...

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

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

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

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

抵扣说明：

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

余额充值