0. 写在最前面
本文将总结自己日常用到的CMake命令以及功能。如有错误，欢迎在评论中指正。
如果觉得写得还不错，就请收藏一下啦～～～也可以找一下我写的其他文章来看一下。关注一下我的专栏什么的。
你的Star是作者坚持下去的最大动力哦～～～
在这里可以查到关于命令的官方文档
使用宏定义：macro
macro(add_example name)
add_executable(${name} ${name}.cpp)
target_link_libraries(${name} dlib::dlib )
endmacro()
add_example(dnn_metric_learning_ex)
添加外部的CMake：add_subdirectory
有时候自己的CMakeLists需要依赖其他的包，需要先编译这个包；或者一个工程分成几个部分，然后在最外面用一个CMakeLists来统一编译，那就需要包含其他的CMakeLists文件来实现。
使用到：add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
- source_dir：首先需要指出另外这个CMakeLists的目录，可以使用相对路径（相对当前路径）和绝对路径。
- binary_dir：接着指明编译生成二进制的目录，可以使用相对路径（相对当前路径）和绝对路径。目标目录是可选项，如不指定，目标文件会被放到
source_dir - EXCLUDE_FROM_ALL：
source_dir生成的目标会被排除在原目录的ALL target之外，也会排除在其IDE工程文件之外。比如source_dir是一些examples，原目录其实是不需要它们的，只是希望他们能编译，就可以添加这个命令。
这个命令的位置需要注意，不能太后面，编译dlib时放在比较后面出现了问题。
例子：
add_subdirectory(../dlib dlib_build)
注意：当运行到该命令时，会立即跳到source_dir执行CMake，等到该CMakeLists执行完毕再跳回原来的CMakeLists执行add_subdirectory后面的命令。
输出消息：message
message("No GUI support, so we won't build the ${name} example.")
#name是一个变量
if判断
if (DLIB_NO_GUI_SUPPORT)
message("No GUI support, so we won't build the ${name} example.")
else()
add_example(${name})
endif()
设置变量：set
- 设置一般变量
set(CPACK_PACKAGE_NAME "dlib")
set(CPACK_PACKAGE_VERSION_MAJOR "19")
set(CPACK_PACKAGE_VERSION_MINOR "16")
set(CPACK_PACKAGE_VERSION_PATCH "0")
set(VERSION ${CPACK_PACKAGE_VERSION_MAJOR}.${CPACK_PACKAGE_VERSION_MINOR}.${CPACK_PACKAGE_VERSION_PATCH})
- 设置内部变量
CMAKE_C_COMPILER：指定C编译器
CMAKE_CXX_COMPILER：
CMAKE_C_FLAGS：编译C文件时的选项，如-g；也可以通过add_definitions添加编译选项
EXECUTABLE_OUTPUT_PATH：可执行文件的存放路径
LIBRARY_OUTPUT_PATH：库文件路径
CMAKE_BUILD_TYPE：build 类型(Debug, Release, …)，CMAKE_BUILD_TYPE=Debug
BUILD_SHARED_LIBS：Switch between shared and static libraries
设置内部变量有两种方式，一种是直接在cmake命令后面加-D+命令+=+值，如cmake .. -DBUILD_SHARED_LIBS=OFF。第二种是在CMakeLists文件中使用set命令，如set(BUILD_SHARED_LIBS OFF)
添加include目录：include_directories
include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])
添加include目录到当前CMakeLists（包括build和target）。默认是目录的递归，相对目录是相对当前路径的。
查找包：find_package
find_package(
查找并加载外部工程，这个命令后，一个QUIET选项忽视找不到的消息；REQUIRED选项表明该外部包是必须的，找不到会立刻停止；
例子（这里的判断是没必要的，只是为了说明，因为找不到就会退出）：
find_package(OpenCV REQUIRED)
if (OpenCV_FOUND)
include_directories(${OpenCV_INCLUDE_DIRS})
else()
message("OpenCV not found, so we won't build the project.")
endif()
链接库目录:link_directories
https://haoqchen.site/2018/04/26/CMakeLists-setting-relative-path/
生成自己的静态、动态链接库
add_library(
增加一个叫name的链接库，可以选择是STATIC、SHARED或者是MODULE类型的。
STATIC：静态链接库，当生成可执行程序时进行链接。在Linux下为.a文件SHARED：动态链接库，可执行程序运行时动态加载并链接。在Linux下为.so文件MODULE：模块，可执行程序运行时动态加载，但不链接到可执行程序中。BUILD_SHARED_LIBS变量决定了默认值，如果为on则为动态的，否则为静态的
可以通过设置CMAKE_LIBRARY_OUTPUT_DIRECTORY变量指定输出的路径
例子：
SET(LIBHELLO_SRC hello.c)
ADD_LIBRARY(hello SHARED ${LIBHELLO_SRC}) #添加动态库
#ADD_LIBRARY(hello STATIC ${LIBHELLO_SRC}) #添加静态库
#ADD_LIBRARY(hello_static STATIC ${LIBHELLO_SRC})
需要注意的是源文件前没有逗号。
C++11
如果用到了C++11特性，需要让CMake支持该特性add_definitions(-std=c++11)
移动资源文件、配置文件
有些资源文件或者配置文件需要从源文件目录移动到生成文件目录，这个时候可以使用file命令，file命令可以进行文件写入、读取、生成、下载、上传、重命名等操作，这里先说一下文件复制的：
file(
COPY一个DESTINATION USE_SOURCE_PERMISSIONS选项，即保留源文件权限，包括可执行性等，可以通过显式声明NO_SOURCE_PERMISSIONS来去除。
实例：
file(COPY ./dlib/data/ DESTINATION ./dlib_models)
这样子就可以将源文件目录下的一些模型（data文件夹内所有）复制到生成二进制文件的dlib_models目录了。
常用宏变量
PROJECT_BINARY_DIR：由project命令生成，指向build目录的绝对路径PROJECT_SOURCE_DIR：由project命令生成，指向CMakeLists目录绝对路径。
这两个配合file命令可以设置链接库相对路径。
例子：
file(COPY ./voice/libs/X64/ DESTINATION ./)
target_link_libraries(awaken_asr ${PROJECT_BINARY_DIR}/libmsc.so libasound.so)
参考
https://www.cnblogs.com/narjaja/p/9533169.html
喜欢我的文章的话Star一下呗Star
版权声明：本文为白夜行的狼原创文章，未经允许不得以任何形式转载