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",由此可以看到宏与函数的区别

你可能感兴趣的:(学习笔记)