CMake入门以及学习笔记

使用cef3替代chromium内核开发产品过程中，第一次接触到系统构建，使用了最常见的CMake。CMake虽然在构建系统中用的比较多，但是使用到的程序员还是很少的。现在在国内能找到的相关资料和博客比较多，本人在学习中也看了很多人的博客，比如 CMake学习（一）  ， CMake语法之流程控制 等。再次感谢这些作者的分享。下边提供一些系统学习的资料。

CMake的官网地址：http://www.cmake.org/

CMake主要的文档《learning_cmake》 《CMake Practice》，这个百度上搜索一下，很容易下载到。

学习CMake之前，借用下 《CMake Practice》中的一段话，如果你的情况符合以下几条就不要浪费时间在CMake上。

1，如果你没有实际的项目需求，那么看到这里就可以停下来了，因为cmake的学习过程就是实践过程，没有实践，读的再多几天后也会忘记。
2，如果你的工程只有几个文件，直接编写Makefile是最好的选择。
3，如果使用的是C/C++/Java之外的语言，请不要使用cmake(至少目前是这样)。
4，如果你使用的语言有非常完备的构建体系，比如java的ant，也不需要学习cmake，虽然有成功的例子，比如QT4.3的csharp绑定qyoto。
5，如果项目已经采用了非常完备的工程管理工具，并且不存在维护问题，没有必要迁移到cmake。
6，如果仅仅使用qt编程，没有必要使用cmake，因为qmake管理Qt工程的专业性和自动化程度比cmake要高很多。

学习CMake之前，最好能找到一个比较简单地例子对照教程看，并且一开始编写一些简单地例子。这样不仅能学得快，也容易建立学习的自信。

下边主要讲三点，也是最常用到的三点。

一、CMake常用命令：

CMakelist中，命令名字是不区分大小写的，而参数和变量是大小写相关的。

CMake中使用"#"表示注释该行代码。

命令：

与其他语言编程语言不同的是，CMake脚本的语法中没有赋值操作，无论是赋值，还是比较、判断操作，都是通过内置命令来完成的，例如"set(),math()等"。所有的内置命令调用形式为：

command(arg1 arg2 arg3 ... argn)

每个参数均以空格，或者分号分割。注：不建议使用分号分割参数.

message()：显示一个消息。如message("Hello world")；

cmake_minimum_required()：需要的最低版本； cmake_minimum_required(version 2.6)

project()：项目的名称 如project（hello）

set()：Cmake中的赋值操作都是通过这个来做的。如 SET(HELLO_SRCS  Hello.c Hello.cpp  world.c   world.cpp)

add_definitions()：设置编译选项；

subdirs：CMake 是以递归的方式工作；处理完当前目录，再去 SUBDIRS 中的目录

add_library ：生成一个链接库；

add_executable：添加生成文件；如:ADD_EXECUTABLE (Hello ${HELLO_SRCS})

add_dependencies：包含一个依赖库文件夹；

add_subdirectory：向当前工程添加存放源文件的子目录；

aux_source_directory ：不在当前目录下的其他地方的源文件；

include_directories:  指明文件所在路径；

set_target_properties:设置文件为另外一个名字。set_target_properties(libhello PROPERTIES OUTPUT_NAME "hello")

source_group：当文件都在同一个路径下面使用

二、CMake变量以及变量的引用

CMake中的变量无需声明，并且没有类型概念，这一点类似于python；变量可以认为都是全局的，哪怕在一个宏中定义的变量，也可以在宏的外面被访问到；所有的变量都是一个列表变量，下文在举例时会详细说明这一点；CMake对于变量是大小写敏感的。

在CMake中，有两种引用方式：对于变量值的引用，和直接引用这个变量本身，使用方式分别是：${varName} 和 varName。

三、CMake的宏与函数

同大多数脚本语言一样，CMake中也有宏和函数的概念，关键字分别为"macro"和"function",具体用法如下：

# 宏

macro( [arg1 [arg2 [arg3 ...]]])

COMMAND1(ARGS ...)

COMMAND2(ARGS ...)

...

endmacro()

# 函数

function( [arg1
[arg2 [arg3 ...]]])

COMMAND1(ARGS ...)

COMMAND2(ARGS ...)

...

endfunction()

以简单的求和函数为例，我们来看宏的一个示例：

macro(sum outvar)

set(_args
${ARGN})

set(result 0)

foreach(_var ${_args})

math(EXPR result "${result}+${_var}")

endforeach()

set(${outvar} ${result})

endmacro()

sum(addResult 1 2 3
4 5)

message("Result
is :${addResult}")

上面是一段求和宏定义，我们来解读一下代码："${ARGN}"是CMake中的一个变量，指代宏中传入的多余参数。因为我们这个宏sum中只定义了一个 参数"outvar"，其余需要求和的数字都是不定形式传入的，所以需要先将多余的参数传入一个单独的变量中。当然，在这个示例中，第一行代码显得多余， 因为似乎没必要将额外参数单独放在一个变量中，但是建议这么做。对上面这个宏再进一步加强：如果我们想限制这个宏中传入的参数数目（尽管在这个宏中实际上 是不必要的），那么可以将宏改写一下：

macro(sum outvar)

set(_args
${ARGN})

list(LENGTH _args argLength)

if(NOT argLength LESS 4)　# 限制不能超过4个数字

message(FATAL_ERROR "to much args!")

endif()

set(result 0)

foreach(_var ${ARGN})

math(EXPR result "${result}+${_var}")

endforeach()

set(${outvar} ${result})

endmacro()

sum(addResult 1 2 3
4 5)

message("Result
is :${addResult}")

而CMake中的函数("function")与宏唯一的区别就在于，函数不能像宏那样将计算结果传出来(也不是完全不能，只是复杂一些)，并且函数中的变量是局部的，而宏中的变量在外面也可以被访问到，请看下例：

macro(macroTest)

set(test1
"aaa")

endmacro()

function(funTest)

set(test2
"bbb")

endfunction()

macroTest()

message("${test1}")

funTest()

message("${test2}")

运行这段代码后，只会打印出一条信息"aaa"，由此可以看到宏与函数的区别