本系列视频，B站首发，up主: xiaobing1016
前言：
CMake是一个跨平台的安装编译工具，可以用简单的语句来描述所有平台的安装(编译过程)。
CMake可以说已经成为大部分C++开源项目标配
Let’s assume you have some cross-platform project with C++ code shared along different platforms/IDEs. Say you use Visual Studio on Windows, Xcode on OSX and Makefile for Linux:
What you will do if you want to add new bar.cpp source file? You have to add it to every tool you use:
To keep the environment consistent you have to do the similar update several times. And the most important thing is that you have to do it manually (arrow marked with a red color on the diagram in this case). Of course such approach is error prone and not flexible.
CMake solve this design flaw by adding extra step to development process. You can describe your project in CMakeLists.txt file and use CMake to generate tools you currently interested in using cross-platform CMake code:
Same action - adding new bar.cpp file, will be done in one step now:
Note that the bottom part of the diagram was not changed. I.e. you still can keep using your favorite tools like Visual Studio/msbuild, Xcode/xcodebuild and Makefile/make!
基本语法格式：指令(参数 1 参数 2…)
参数使用括弧括起
参数之间使用空格或分号分开
指令是大小写无关的，参数和变量是大小写相关的
1set(HELLO hello.cpp)
2add_executable(hello main.cpp hello.cpp)
3ADD_EXECUTABLE(hello main.cpp ${HELLO})
变量使用${}方式取值，但是在 IF 控制语句中是直接使用变量名
cmake_minimum_required - 指定CMake的最小版本要求
1# CMake最小版本要求为2.8.3
2cmake_minimum_required(VERSION 2.8.3)
语法：cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])
project - 定义工程名称，并可指定工程支持的语言
1# 指定工程名为HELLOWORLD
2project(HELLOWORLD)
语法：project(projectname [CXX] [C] [Java])
set - 显式的定义变量
1# 定义SRC变量，其值为main.cpp hello.cpp
2set(SRC sayhello.cpp hello.cpp)
语法：set(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])
include_directories - 向工程添加多个特定的头文件搜索路径 --->相当于指定g++编译器的-I参数
1# 将/usr/include/myincludefolder 和 ./include 添加到头文件搜索路径
2include_directories(/usr/include/myincludefolder ./include)
语法：include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 …)
link_directories - 向工程添加多个特定的库文件搜索路径 --->相当于指定g++编译器的-L参数
1# 将/usr/lib/mylibfolder 和 ./lib 添加到库文件搜索路径
2link_directories(/usr/lib/mylibfolder ./lib)
语法：link_directories(dir1 dir2 …)
add_library - 生成库文件
1# 通过变量 SRC 生成 libhello.so 共享库
2add_library(hello SHARED ${SRC})
语法：add_library(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2 … sourceN)
add_compile_options - 添加编译参数
1# 添加编译参数 -Wall -std=c++11
2add_compile_options(-Wall -std=c++11 -O2)
语法：add_compile_options(
add_executable - 生成可执行文件
1# 编译main.cpp生成可执行文件main
2add_executable(main main.cpp)
语法：add_library(exename source1 source2 … sourceN)
target_link_libraries - 为 target 添加需要链接的共享库 --->相同于指定g++编译器-l参数
1# 将hello动态库文件链接到可执行文件main
2target_link_libraries(main hello)
语法：target_link_libraries(target library1library2…)
add_subdirectory - 向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置
1# 添加src子目录，src中需有一个CMakeLists.txt
2add_subdirectory(src)
语法：add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
aux_source_directory - 发现一个目录下所有的源代码文件并将列表存储在一个变量中，这个指令临时被用来自动构建源文件列表
1# 定义SRC变量，其值为当前目录下所有的源代码文件
2aux_source_directory(. SRC)
3# 编译SRC变量所代表的源代码文件，生成main可执行文件
4add_executable(main ${SRC})
语法：aux_source_directory(dir VARIABLE)
CMAKE_C_FLAGS gcc编译选项
CMAKE_CXX_FLAGS g++编译选项
1# 在CMAKE_CXX_FLAGS编译选项后追加-std=c++11
2set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
CMAKE_BUILD_TYPE 编译类型(Debug, Release)
1# 设定编译类型为debug，调试时需要选择debug
2set(CMAKE_BUILD_TYPE Debug)
3# 设定编译类型为release，发布时需要选择release
4set(CMAKE_BUILD_TYPE Release)
CMAKE_BINARY_DIR
PROJECT_BINARY_DIR
__BINARY_DIR
这三个变量指代的内容是一致的。
如果是 in source build，指的就是工程顶层目录。
如果是 out-of-source 编译,指的是工程编译发生的目录。
PROJECT_BINARY_DIR 跟其他指令稍有区别，不过现在，你可以理解为他们是一致的。
CMAKE_SOURCE_DIR
PROJECT_SOURCE_DIR__SOURCE_DIR
这三个变量指代的内容是一致的,不论采用何种编译方式,都是工程顶层目录。
也就是在 in source build时,他跟 CMAKE_BINARY_DIR 等变量一致。
PROJECT_SOURCE_DIR 跟其他指令稍有区别,现在,你可以理解为他们是一致的。
CMAKE_C_COMPILER：指定C编译器
CMAKE_CXX_COMPILER：指定C++编译器
EXECUTABLE_OUTPUT_PATH：可执行文件输出的存放路径
LIBRARY_OUTPUT_PATH：库文件输出的存放路径
CMake目录结构：项目主目录存在一个CMakeLists.txt文件
两种方式设置编译规则：
包含源文件的子文件夹包含CMakeLists.txt文件，主目录的CMakeLists.txt通过add_subdirectory添加子目录即可；
包含源文件的子文件夹未包含CMakeLists.txt文件，子目录编译规则体现在主目录的CMakeLists.txt中；
在 linux 平台下使用 CMake 构建C/C++工程的流程如下:
手动编写 CmakeLists.txt。
执行命令 cmake PATH生成 Makefile ( PATH 是顶层CMakeLists.txt 所在的目录 )。
执行命令make 进行编译。
1# important tips
2. # 表示当前目录
3./ # 表示当前目录
4
5.. # 表示上级目录
6../ # 表示上级目录
内部构建(in-source build)：不推荐使用
内部构建会在同级目录下产生一大堆中间文件，这些中间文件并不是我们最终所需要的，和工程源文件放在一起会显得杂乱无章。
1## 内部构建
2
3# 在当前目录下，编译本目录的CMakeLists.txt，生成Makefile和其他文件
4cmake .
5# 执行make命令，生成target
6make
外部构建(out-of-source build)：==推荐使用==
将编译输出文件与源文件放到不同目录中
1## 外部构建
2
3# 1. 在当前目录下，创建build文件夹
4mkdir build
5# 2. 进入到build文件夹
6cd build
7# 3. 编译上级目录的CMakeLists.txt，生成Makefile和其他文件
8cmake ..
9# 4. 执行make命令，生成target
10make
针对第五章写的两个小项目来写对应的CMakeLists.txt
1# Set the minimum version of CMake that can be used
2cmake_minimum_required(VERSION 3.0)
3
4# Set the project name
5project (HELLO)
6
7# Add an executable
8add_executable(hello_cmake main.cpp)
1# Set the minimum version of CMake that can be used
2cmake_minimum_required(VERSION 3.0)
3
4#project name
5project(SWAP)
6
7#head file pat
8include_directories( include )
9
10#source directory files to var
11add_subdirectory( src DIR_SRCS )
12
13#add executable file
14add_executable(swap_02 ${TEST_MATH})
15
16#add link library
17target_link_libraries(${FS_BUILD_BINARY_PREFIX}sqrt ${LIBRARIES})
1# Set the minimum version of CMake that can be used
2cmake_minimum_required(VERSION 3.0)
3
4#project name
5project(SWAP_LIBRARY)
6
7#add compile options
8add_compile_options("-Wall -std=c++11")
9
10#set CMAKE_BUILD_TYPE
11set( CMAKE_BUILD_TYPE Debug )
12
13# set output binary path
14set(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
15
16############################################################
17# Create a library
18############################################################
19
20#Generate the static library from the library sources
21add_library( swap_library STATIC src/Swap.cpp )
22
23target_include_directories( swap_lib PUBLIC ${PROJECT_SOURCE_DIR}/include )
24
25############################################################
26# Create an executable
27############################################################
28
29# Add an executable with the above sources
30add_executable( swap_01 main.cpp )
31
32# link the new swap_01 target with the swap_lib target
33target_link_libraries( swap_01 swap_liby )
END
扫码关注公众号
微信号 : iVSCode
bilibili : xiaobing1016