前言:

CMake是一个跨平台的安装编译工具,可以用简单的语句来描述所有平台的安装(编译过程)。
CMake可以说已经成为大部分C++开源项目标配。

假设你有一些跨平台项目,C++代码在不同的平台/IDE上共享。假设您在Windows上使用Visual Studio,在OSX上使用Xcode,在Linux上使用Makefile:

CMake介绍与用法_c++


如果你想添加新的类,你会怎么做。xx.cpp源文件?您必须将其添加到您使用的每个工具中:

CMake介绍与用法_CMake_02


为了保持环境的一致性,您必须多次执行类似的更新。最重要的是,您必须手动执行(在本例中,图表上用红色标记的箭头)。当然,这种方法容易出错,而且不灵活。

CMake通过在开发过程中添加额外步骤来解决此设计缺陷。您可以在CMakeLists.TXT中描述您的项目。文件并使用CMake生成您当前对使用跨平台CMake代码.

CMake介绍与用法_c++_03


同样的操作-添加新的[xx.cpp]文件,现在将一步完成:

CMake介绍与用法_c++_04


请注意,图的底部没有更改。也就是说,您仍然可以继续使用您喜爱的工具,如Visual Studio/msbuild、Xcode/xcodebuild和Makefile/make!

CMake 语法特性介绍

- 基本语法格式:指令(参数 1 参数 2…)

  • 参数使用括弧括起
  • 参数之间使用空格或分号分开。
  • 指令是大小写无关的,参数和变量是大小写相关的
set(HELLO hello.cpp)
add_executable(hello main.cpp hello.cpp)
ADD_EXECUTABLE(hello main.cpp ${HELLO})

变量使用${}方式取值,但是在 IF 控制语句中是直接使用变量名

重要指令和CMake常用变量

cmake_minimum_required - 指定CMake的最小版本要求

# CMake最小版本要求为2.8.3
cmake_minimum_required(VERSION 2.8.3)

语法:cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])

project - 定义工程名称,并可指定工程支持的语言

# 指定工程名为HELLOWORLD
project(HELLOWORLD)

语法:project(projectname [CXX] [C] [Java])

set - 显式的定义变量

# 定义SRC变量,其值为main.cpp hello.cpp
set(SRC sayhello.cpp hello.cpp)

语法:set(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])

include_directories - 向工程添加多个特定的头文件搜索路径 —>相当于指定g++编译器的-I参数

# 将/usr/include/myincludefolder 和 ./include 添加到头文件搜索路径
include_directories(/usr/include/myincludefolder ./include)

语法:include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 …)

link_directories - 向工程添加多个特定的库文件搜索路径 —>相当于指定g++编译器的-L参数

# 将/usr/lib/mylibfolder 和 ./lib 添加到库文件搜索路径
link_directories(/usr/lib/mylibfolder ./lib)

语法:link_directories(dir1 dir2 …)

add_library - 生成库文件

# 通过变量 SRC 生成 libhello.so 共享库
add_library(hello SHARED ${SRC})

语法:add_library(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2 … sourceN)

add_compile_options - 添加编译参数

# 添加编译参数 -Wall -std=c++11
add_compile_options(-Wall -std=c++11 -O2)

语法:add_compile_options()

add_executable - 生成可执行文件

# 编译main.cpp生成可执行文件main
add_executable(main main.cpp)

语法:add_library(exename source1 source2 … sourceN)

target_link_libraries - 为 target 添加需要链接的共享库 —>相同于指定g++编译器-l参数

# 将hello动态库文件链接到可执行文件main
target_link_libraries(main hello)

语法:target_link_libraries(target library1library2…)

add_subdirectory - 向当前工程添加存放源文件的子目录,并可以指定中间二进制和目标二进制存放的位置

# 添加src子目录,src中需有一个CMakeLists.txt
add_subdirectory(src)

语法:add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])

aux_source_directory - 发现一个目录下所有的源代码文件并将列表存储在一个变量中,这个指令临时被用来自动构建源文件列表

# 定义SRC变量,其值为当前目录下所有的源代码文件
aux_source_directory(. SRC)
# 编译SRC变量所代表的源代码文件,生成main可执行文件
add_executable(main ${SRC})

语法:aux_source_directory(dir VARIABLE)

CMake常用变量

CMAKE_C_FLAGS gcc编译选项
CMAKE_CXX_FLAGS g++编译选项

# 在CMAKE_CXX_FLAGS编译选项后追加-std=c++11
set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")

CMAKE_BUILD_TYPE 编译类型(Debug, Release)

# 设定编译类型为debug,调试时需要选择debug
set(CMAKE_BUILD_TYPE Debug)
# 设定编译类型为release,发布时需要选择release
set(CMAKE_BUILD_TYPE Release)

在 linux 平台下使用 CMake 构建C/C++工程的流程如下

  1. 手动编写 CmakeLists.txt。
  2. 执行命令 cmake PATH生成 Makefile ( PATH 是顶层CMakeLists.txt 所在的目录 )。
  3. 执行命令make 进行编译。

CMake 的两种构建方式:

内部构建(in-source build):不推荐使用

内部构建会在同级目录下产生一大堆中间文件,这些中间文件并不是我们最终所需要的,和工程源文件放在一起会显得杂乱无章。

## 内部构建
# 在当前目录下,编译本目录的CMakeLists.txt,生成Makefile和其他文件
cmake .
# 执行make命令,生成target
make

外部构建(out-of-source build):推荐使用

将编译输出文件与源文件放到不同目录中

## 外部构建
在当前目录下,创建build文件夹
mkdir build
# 2. 进入到build文件夹
cd build
# 3. 编译上级目录的CMakeLists.txt,生成Makefile和其他文件
cmake ..
# 4. 执行make命令,生成target
make

CMake代码实践–实例

实例一

# Set the minimum version of CMake that can be used
cmake_minimum_required(VERSION 3.0)

# Set the project name
project (HELLO)

# Add an executable
add_executable(hello_cmake main.cpp)

实例二

# Set the minimum version of CMake that can be used
cmake_minimum_required(VERSION 3.0)

#project name
project(SWAP)

#head file pat
include_directories( include )

#source directory files to var
add_subdirectory( src DIR_SRCS )

#add executable file
add_executable(swap_02 ${TEST_MATH})

#add link library
target_link_libraries(${FS_BUILD_BINARY_PREFIX}sqrt ${LIBRARIES})

实例三

# Set the minimum version of CMake that can be used
cmake_minimum_required(VERSION 3.0)

#project name
project(SWAP_LIBRARY)

#add compile options
8add_compile_options("-Wall -std=c++11")

#set CMAKE_BUILD_TYPE
set( CMAKE_BUILD_TYPE Debug )

# set output binary path
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)

############################################################
# Create a library
############################################################

#Generate the static library from the library sources
add_library( swap_library STATIC src/Swap.cpp )

target_include_directories( swap_lib PUBLIC ${PROJECT_SOURCE_DIR}/include )

############################################################
# Create an executable
############################################################

# Add an executable with the above sources
add_executable( swap_01 main.cpp )

# link the new swap_01 target with the swap_lib target
target_link_libraries( swap_01 swap_liby )