CMake的基本概念及其常用指令（Linux/c/c++）

CMake简介：

CMake是一个跨平台的安装（编译）工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。只是 CMake 的组态档取名为 CMakeLists.txt。Cmake 并不直接建构出最终的软件，而是产生标准的建构档（如 Unix 的 Makefile 或 Windows Visual C++ 的 projects/workspaces），然后再依一般的建构方式使用。这使得熟悉某个集成开发环境（IDE）的开发者可以用标准的方式建构他的软件，这种可以使用各平台的原生建构系统的能力是 CMake 和 SCons 等其他类似系统的区别之处。 -- 内容来自百度百科

CMake与makefile的关系：

(前提申明：在学习CMake之前，你应该对makefile有一定的了解)

makefile相当于是一种集成gcc/g++指令的脚本，通过它自己特定的相关指令，把g++格式化，统一化，简单化。(如果这里不太理解的，你需要了解gcc/g++编译c/c++代码的大致流程和语句)

原来我们写好一个c/c++项目，可能需要要通过一条一条的gcc/g++的语句一步一步编译，最后生成我们想要的目标文件，但是通过makefile，我们只需要写好一个makefile文档。make一下就能得到我们想要的目标文件。

但是makefile还是有一定局限性，当我们的工程文件庞大，有很多的头文件，项目文件夹的时候，使用makefile还是有一定的麻烦。于是CMake就将makefile再次格式化，统一化，简单化，我们只需要写一个CMakeLists.txt文件，在文件里写好相关makefile配置指令，只需要cmake一下，再make，就可以容易的得到我们的目标文件。

CMake可以说已经成为大部分C++开源项目标配

CMake的优点：

我们刚刚提到，CMake的跨平台性质，我们看几张图片来体现，首先看一下没有CMake不同系统下编译c/c++项目的过程：

 可见，在Windows平台下，我们使用vs之类的IDE工具去帮我们完成这些编译工作，在Linux下我们用makefile的方式完成编译等操作生产最终的二进制文件。

那么如果项目中需要修改，添加功能函数等，就如下所示：

又要在不同的平台下进行修改再，编译。

那么用CMake后呢，如下所示：

 

 

很显然，极大地简化了我们修改文档的流程且跨平台。

 CMake的语法特性介绍：

• 基本语法格式: 指令(参数1 参数2 .….)
  • 参数使用括弧括起
  • 参数之间使用空格或分号分开
• 指令是大小写无关的，参数和变量是大小写相关的

set(HELLO hello.cpp)
add_executable(hello main.cpp he11o.cpp）
ADD_EXECUTABLE(hello main.cpp ${HELLO})

**add_executable和set指令可以大写也可以小写，但是括号里面的参数和变量是区分大小写的)**

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

if（HELLO）   -- 正确
if（${HELLO}）  -- 错误

重要指令和CMake常用变量

重要指令:

• cmake_minimum_required -指定CMake的最小版本要求
  • 语法: cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])

#CMake最小版本要求为2.8.3
cmake_minimum_required(VERSION2.8.3)

• project -定义工程名称，并可指定工程支持的语言
  • 语法: project(projectname [CXX][C] [Java]) //中括号内容代表可选项

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

• set -显式的定义变量
  • 语法: set(VAR [VALUE][CACHE TYPE DOCSTRING[FORCE]])

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

• include_directories-向工程添加多个特定的头文件搜索路径--->相当于指定g++编译器的-l参数
  • 语法: include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 ..)

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

• link_directories-向工程添加多个特定的库文件搜索路径--->相当于指定g++编译器的-L参数
  • 语法: link_directories(dir1 dir2 ...)

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

• add_library -生成库文件
  • 语法: add_library(libname [SHARED|STATIC|MODULE] [EXCLUDE FROM_ALL] source1 source2 ... sourceN)

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

• add_compile_options -添加编译参数
  • 语法: add_compile_options(...)

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

• add_executable-生成可执行文件  //非常重要
  • 语法: add_library(exename source1 source2 ... sourceN)

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

• target_link_libraries-为 target添加需要链接的共享库--->相同于指定g++编译器-l参数
  • 语法: target_link_libraries(target library1 library2..)

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

• add_subdirectory-向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置
  • 语法: add_subdirectory(source_dir [binary_dir][EXCLUDE_FROM_ALL])

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

• aux_source_directory-发现一个目录下所有的源代码文件并将列表存储在一个变量中，这个指令临时被用来自动构建源文件列表
  • 语法: aux_source_directory(dir VARIABLE)

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

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)

• CMAKE_C_COMPILER:指定C编译器
• CMAKE_CXx_COMPILER:指定C++编译器
• EXECUTABLE_OUTPUT_PATH:可执行文件输出的存放路径
• LIBRARY_OUTPUT_PATH:库文件输出的存放路径

上述是CKmake比较常用和重要指令和CMake常用变量，还有很多其他的，这里就不再一一列举，感兴趣的伙伴可以前往CMake的官网查看。

---

以上我简单的介绍了CMake大概是个什么东西以及它的优点和常用的指令，后续我将跟新博客演示如何使用CMake。

喜欢的话点个关注持续关注我的更新内容！