作者丨zhanghm1995@blog
来源丨https://blog.csdn.net/zhanghm1995/article/details/80902807
编辑丨3D视觉工坊
基本语法规则
CMake要求要求工程主目录和所有存放源代码子目录下都要编写CMakeLists.txt文件，注意大小写（CM 大写，Lists中L要大写且不要落下s)。
CMake变量使用${}方式取值,但是在IF控制语句中是直接使用变量名
环境变量使用$ENV{}方式取值,使用SET(ENV{VAR} VALUE)赋值
指令(参数1 参数2…)参数使用括弧括起,参数之间使用空格或分号分开。
以ADD_EXECUTABLE指令为例：
ADD_EXECUTABLE(hello main.c func.c)或者
ADD_EXECUTABLE(hello main.c;func.c)注：指令是大小写无关的,参数和变量是大小写相关的。我一般习惯用小写。
常见CMakeLists.txt中指令剖析
·cmake_minimum_required(VERSION 2.6)命令
规定cmake软件的最低版本。这行命令是可选的，可以不写这句话，但在有些情况下，如果CMakeLists.txt文件中使用了一些高版本cmake特有的一些命令时，就需要加上这一行，提醒用户升级到该版本之后再执行cmake。
·project(<projectname>)命令
语法：project(projectname [cxx] [c] [java])
可以指定工程采用的语言，选项分别表示：C++, C, java， 如不指定默认支持所有语言。
指定项目的名称，在生成VS项目下即指明了生成的.sln项目的文件名。项目最终编译生成的可执行文件不一定是这个项目名称，而是由另一条命令(add_executable)指定的。
通过project命令，为整个代码项目定义了一个管理架构，这点可以通过在VS下建立项目的结构层次来帮助理解。VS下所有的项目都是在解决方案（.sln文件）下进行管理的，一个解决方案可以包含多个项目。cmake中project命令正是定义了解决方案的名称，add_executable和add_library命令都会生成一个项目，cmake会自动为每个项目（包括生成可执行文件的项目和生成链接库的项目）创建对应的文件夹，存储编译中间文件。
但是这个项目名称还是很必要的，在cmake中有两个预定义的变量：<projectname>_BINARY_DIR 和<projectname>_SOURCE_DIR ，即一旦使用了project指明了一个项目名称，则同时隐式定义了这两个预定义的变量。在内部编译情况下，这两个变量的含义相同，而在外部编译下，两者指代的内容会有所不同。要理解这两个变量的含义，我们首先需要了解什么是外部构建（out of source build），下面会介绍什么叫外部构建。
同时cmake还预定义了PROJECT_BINARY_DIR和PROJECT_SOURCE_DIR变量，其中PROJECT_BINARY_DIR就等同于<projectname>_BINARY_DIR,PROJECT_SOURCE_DIR等同于<projectname>_SOURCE_DIR。因此在实际应用中，强烈推荐使用PROJECT_BINARY_DIR和PROJECT_SOURCE_DIR变量，这样即使项目名称发生变化也不会影响CMakeLists.txt文件。
外部构建的含义：
外部构建和内部构建最大的不同在于执行cmake的工作路径不同，在我们使用cmake构建项目时，首先要求指定**“Where is the source code"，然后要求指定"Where to build the binaries"。此时如果这两个路径相同的话，cmake生成的所有中间文件和可执行文件都会存放在项目目录（即所谓的根目录）中；而如果我们在项目目录下先新建一个build文件夹，然后将"Where to build the binaries"指定为该build文件夹的路径，此时中间文件和可执行文件都会存放在build目录下。第二种方法的优点显而易见，它最大限度的保持了代码目录的整洁，同时由于第二种方法的生成、编译和安装时发生在不同于项目目录的其他目录中，所以第二种方法就叫做“外部构建”**。
回到project命令下的问题，在外部构建的情况下，PROJECT_SOURCE_DIR指向 的目录同内部构建一样，仍然是项目目录，而PROJECT_BINARY_DIR则有所不同，指向的是<项目目录>/build目录。cmake强烈推荐使用外部构建的方法。
·ADD_SUBDIRECTORY命令
语法：ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
该命令告诉CMake去子目录中查看可用的CMakeLists.txt文件
指令用于向当前工程添加存放源文件的子目录,并可以指定中间二进制和目标二进制存放的位置。EXCLUDE_FROM_ALL 参数的含义是将这个目录从编译过程中排除。比如,工程的 example,可能就需要工程构建完成后,再进入 example 目录单独进行构建。
在我们的项目中，我们添加了src目录到项目中，而把对应于src目录生成的中间文件和目标文件存放到bin目录下，在上一节举例中“外部构建”的情况下，中间文件和目标文件将存放在build/srcobj目录下
·ADD_EXECUTABLE命令
告诉工程生成一个可执行文件。该命令定义了工程最终生成的可执行文件的文件名以及参与编译的头文件和cpp文件。
如果想指定生成的可执行文件的存放路径，可以设置cmake中预定义变量EXECUTABLE_OUTPUT_PATH 的值。例如，将生成的可执行文件放置在cmake编译路径的bin文件夹下可用：SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
·ADD_LIBRARY命令
语法：ADD_LIBRARY(libname [SHARED|STATIC]
告诉工程生成一个库文件
·FIND_LIBRARY命令
查找库所在目录，语法如下：
find_library (
<VAR>
name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
[HINTS path1 [path2 ... ENV var]]
[PATHS path1 [path2 ... ENV var]]
[PATH_SUFFIXES suffix1 [suffix2 ...]]
[DOC "cache documentation string"]
[NO_DEFAULT_PATH]
[NO_CMAKE_ENVIRONMENT_PATH]
[NO_CMAKE_PATH]
[NO_SYSTEM_ENVIRONMENT_PATH]
[NO_CMAKE_SYSTEM_PATH]
[CMAKE_FIND_ROOT_PATH_BOTH |
ONLY_CMAKE_FIND_ROOT_PATH |
NO_CMAKE_FIND_ROOT_PATH]
)举例：
FIND_LIBRARY(RUNTIME_LIB rt /usr/lib /usr/local/lib NO_DEFAULT_PATH)cmake会在目录中查找，如果所有目录中都没有，值RUNTIME_LIB就会被赋为NO_DEFAULT_PATH
·SET命令——用于设置变量，相当于为变量取别名
SET(CMAKE_BUILE_TYPE DEBUG) 设置编译类型debug 或者release。debug 版会生成相关调试信息，可以使用GDB 进行调试；release不会生成调试信息。当无法进行调试时查看此处是否设置为debug.
SET(CMAKE_C_FLAGS_DEBUG “-g -Wall”) 设置编译器的类型
CMAKE_C_FLAGS_DEBUG ---- C 编译器
CMAKE_CXX_FLAGS_DEBUG ---- C++ 编译器
·CMAKE_MODULE_PATH变量——定义cmake模块所在路径
如果你的工程比较复杂,有可能会自己编写一些 cmake 模块（所谓cmake模块指的是在该文件内部定义了一些变量，这些变量指明了一些头文件路径和库文件路径等有用信息）。这些 cmake 模块是随你的工程发布的,为了让 cmake 在处理CMakeLists.txt 时找到这些模块,你需要通过 SET 指令,将自己的 cmake 模块路径设置一下。
比如
SET(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)
这时候你就可以通过 INCLUDE 指令来调用自己的模块了
·EXECUTABLE_OUTPUT_PATH和LIBRARY_OUTPUT_PATH变量
我们可以通过 SET 指令重新定义 EXECUTABLE_OUTPUT_PATH 和 LIBRARY_OUTPUT_PATH 变量来指定最终的目标二进制的位置(指最终生成的CRNode可执行文件或者最终的共享库，而不包含编译生成的中间文件)。
命令如下：
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)
需要注意的是，在哪里 ADD_EXECUTABLE 或 ADD_LIBRARY,如果需要改变目标存放路径,就在哪里加入上述的定义。
从VS项目配置过程理解CMakeLists内容
由于在之前学习C++编程一直是在VS中进行，当时就涉及到了众多有关头文件、链接库的配置过程，还有很多编译选项的设置，而CMake则相当于用自己的语法规则配置了整个项目，控制编译流程，因此可以从VS的配置过程来对照学习CMake中一些基本语法到底在做什么事。
采用外部构建项目时候编写的CMakeLists.txt：
1、在项目文件夹下新建一个CMakeLists.txt
同时新建一个文件夹build在此文件夹中执行cmake …即可进行项目构建；（前提是项目文件夹下源文件已经准备好）
set(TARGET_NAME rimeserver)；设置项目的变量名字；
PROJECT(${TARGET_NAME})；
cmake_minimum_required(VERSION 2.8.12)
2、CMakeLists.txt文件中依赖库及文件的设置
1）include_directories(${CMAKE_CURRENT_SOURCE_DIR}/include)
包含CMakeLists.txt文件同级目录的include文件夹，相当于在VS中设置包含文件；
2）add_executable(${TARGET_NAME} ${SOURCES})
${TARGET_NAME}代表你设置的项目名称变量；
${SOURCES}代表你的源文件变量；
add_executable代表项目生成一个可执行文件；
相当于在VS中新建一个项目时一步步填写的项目名称等。
3）add_dependencies(${TARGET_NAME} deploy)
deploy代表你项目依赖的项目，保证deploy目标在其他的目标之前被构建；
4）target_link_libraries(${TARGET_NAME}
指定项目依赖的lib文件，相当于在VS中设置链接器下面的链接库；
5）set_target_properties(${TARGET_NAME} PROPERTIES LINK_FLAGS "/SUBSYSTEM:WINDOWS")
设置项目属性，相当于VS中项目属性设置页中的各种条目。
CMake变量查询网站：https://gitlab.kitware.com/cmake/community/wikis/doc/cmake/Useful-Variables
备注：感谢微信公众号「3D视觉工坊」整理。
说明：
引用变量内容需要用${变量名}格式
可以使用message命令查看变量具体内容
message(STATUS "The CMAKE_VERSION is ${CMAKE_VERSION}")
message(STATUS "The CMAKE_SOURCE_DIR is ${CMAKE_SOURCE_DIR}")可以在CMakeLists.txt文件中使用set命令设置某些变量值
如set(CMAKE_BUILD_TYPE "Release")
可以通过cmake命令行参数设置变量值
如cmake -DCMAKE_BUILD_TYPE=Release，这种方式会被CMakeLists.txt中set命令设置的变量值覆盖
常用变量：
编译配置相关变量：
常用CMakeLists文件模板
基础模板
## This is a standard CMakeLists.txt template, including
## how to enable C++11 compiler option and how to set 'Release'
## target compile option
cmake_minimum_required(VERSION 2.8)
project(cmake_template)
############# Use message function to print information ############
message(STATUS "CMake version: ${CMAKE_VERSION}")
############ enable C++11 compiler###############
## Method 1
include(CheckCXXCompilerFlag)
CHECK_CXX_COMPILER_FLAG("-std=c++11" COMPILER_SUPPORTS_CXX11)
CHECK_CXX_COMPILER_FLAG("-std=c++0x" COMPILER_SUPPORTS_CXX0X)
if(COMPILER_SUPPORTS_CXX11)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
elseif(COMPILER_SUPPORTS_CXX0X)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++0x")
else()
message(WARNING "The compiler ${CMAKE_CXX_COMPILER} has no C++11 support.")
message(STATUS "Please use a different C++ compiler.")
endif()
## Method 2
set(CMAKE_CXX_STANDARD 11)
############ #enable warnings##################
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fPIC -Wall")
#############Set cmake compiler options##############
## Method 1
set(CMAKE_BUILD_TYPE "Release")
## Method 2
IF(NOT CMAKE_BUILD_TYPE)
SET(CMAKE_BUILD_TYPE RelWithDebInfo CACHE STRING
"Choose the type of build, options are: None Debug Release RelWithDebInfo MinSizeRel."
FORCE)
ENDIF(NOT CMAKE_BUILD_TYPE)
################## Some useful arguments ##########################
set(CMAKE_INCLUDE_CURRENT_DIR ON)
##########
##Build###
##########
add_library(lib hello.cpp)
add_executable(main main.cpp)
target_link_libraries(main ${LINK_LIBRARIES})使用OpenCV库CMakeLists文件模板
cmake_minimum_required(VERSION 2.8.12)
project(OpenCV_test)
#find packages
find_package(OpenCV REQUIRED)
#include headers
include_directories(${OpenCV_INCLUDE_DIRS})
#target generation
add_executable(OpenCV_test main.cpp)
#link libraries
target_link_libraries(OpenCV_test ${OpenCV_LIBS})使用PCL库CMakeLists文件模板
cmake_minimum_required(VERSION 2.8.12)
project(PCL_test)
#find packages
find_package(PCL 1.7 REQUIRED)
add_definitions(${PCL_DEFINITIONS})
#include headers
include_directories(${PCL_INCLUDE_DIRS})
#target generation
add_executable(PCL_test main.cpp)
#link libraries
target_link_libraries(PCL_test ${PCL_LIBRARIES})使用Eigen库CMakeLists文件模板
cmake_minimum_required(VERSION 2.8.12)
project(Eigen_test)
#find packages
find_package(Eigen3 REQUIRED)
#include headers
include_directories(${EIGEN3_INCLUDE_DIR})
#target generation
add_executable(Eigen_test main.cpp)文章知识点与官方知识档案匹配，可进一步学习相关知识
版权声明：本文为CSDN博主「zhanghm1995」的原创文章，遵循CC 4.0 BY-SA版权协议，转载请附上原文出处链接及本声明。
原文链接：https://blog.csdn.net/zhanghm1995/article/details/80902807
本文仅做学术分享，如有侵权，请联系删文。
3D视觉精品课程推荐：
2.面向自动驾驶领域的3D点云目标检测全栈学习路线！(单模态+多模态/数据+代码)
3.彻底搞透视觉三维重建：原理剖析、代码讲解、及优化改进
4.国内首个面向工业级实战的点云处理课程
5.激光-视觉-IMU-GPS融合SLAM算法梳理和代码讲解
6.彻底搞懂视觉-惯性SLAM：基于VINS-Fusion正式开课啦
7.彻底搞懂基于LOAM框架的3D激光SLAM: 源码剖析到算法优化
8.彻底剖析室内、室外激光SLAM关键算法原理、代码和实战(cartographer+LOAM +LIO-SAM)
重磅！3DCVer-学术论文写作投稿 交流群已成立
扫码添加小助手微信，可申请加入3D视觉工坊-学术论文写作与投稿 微信交流群，旨在交流顶会、顶刊、SCI、EI等写作与投稿事宜。
同时也可申请加入我们的细分方向交流群，目前主要有3D视觉、CV&深度学习、SLAM、三维重建、点云后处理、自动驾驶、多传感器融合、CV入门、三维测量、VR/AR、3D人脸识别、医疗影像、缺陷检测、行人重识别、目标跟踪、视觉产品落地、视觉竞赛、车牌识别、硬件选型、学术交流、求职交流、ORB-SLAM系列源码交流、深度估计等微信群。
一定要备注：研究方向+学校/公司+昵称，例如：”3D视觉 + 上海交大 + 静静“。请按照格式备注，可快速被通过且邀请进群。原创投稿也请联系。
▲长按加微信群或投稿
▲长按关注公众号
3D视觉从入门到精通知识星球：针对3D视觉领域的视频课程（三维重建系列、三维点云系列、结构光系列、手眼标定、相机标定、激光/视觉SLAM、自动驾驶等）、知识点汇总、入门进阶学习路线、最新paper分享、疑问解答五个方面进行深耕，更有各类大厂的算法工程人员进行技术指导。与此同时，星球将联合知名企业发布3D视觉相关算法开发岗位以及项目对接信息，打造成集技术与就业为一体的铁杆粉丝聚集区，近4000星球成员为创造更好的AI世界共同进步，知识星球入口：
学习3D视觉核心技术，扫描查看介绍，3天内无条件退款
圈里有高质量教程资料、答疑解惑、助你高效解决问题
觉得有用，麻烦给个赞和在看~
2万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
