CMAKE使用手记

1、变量严格区分大小写！
2、CMake 中的变量只有两种类型：字符串，和字符串数组。
3、变量无需声明即可赋值或者使用。未赋值的变量默认为一个空字符串。
4、与其他语言编程语言不同的是，CMake 脚本的语法中没有赋值操作。无论是赋值，还是比较、判断操作，都是通过内置指令来完成的。 
5、变量可以认为都是全局的，哪怕在一个宏中定义的变量，也可以在宏的外面被访问到。

如果字符串中不包含空格，那么可以不加引号，直接使用。

在 CMake 当中我们可以用 set() 指令来设定一个变量的值。提取变量值时通常必须在外面加上 ${} 符号，不过也有少数场合例外。

示例：

set(var hello)
message(${var})

会输出

hello

将字串用空白或分号分隔则表示字串数组。

set(foo this is a list)

将变量 foo 值指定为一个字串数组，内含 this、is、 a、list 四个字串。

如果在命令中，使用包含了字符串数组的变量作为参数会是怎样的情况呢？例如，下面的变量：

set(foo a b c)

将其作为参数传入一个指令：

command(${foo})

这等同于：

command(a b c)

在字符串中展开变量

在字符串中如果用${}将一个变量名包了起来，那么该变量也会被代换。

例如，如果我们执行下面的指令：

set(foo a b c d)
command("${foo}")

则相当于我们执行了 command(“a b c d”)。

不好猜吧，我现在不喜欢多说废话，尽量都是言简意赅。

转义字符串

如欲表示 CMake 当中的特殊字符时也可用 \ 标记。

set(bar "alpha beta gamma")
message("\${bar}: ${bar}")

上面的程式码输出

${bar}: alpha beta gamma

脚本流程控制

虽然我目前还不知道这个有什么用，但是也不敢确定这个哪天就用上了，反正也不难，就记着呗。

条件语句

CMake 的条件语句为 if、elseif、else、endif。

# 当 expr 值为下列其中之一時，执行 command1：
# ON， 1， YES， TRUE， Y
# 当 expr 值为下列其中之一時，执行 command2：
# OFF， 0， NO， FALSE， N， NOTFOUND， *-NOTFOUND， IGNORE 
if(expr)
 command1(arg)
else(expr)
 command2(arg)
endif(expr)

if((expr) AND (expr OR (expr)))

在条件式当中即使不加 ${}，if 也会先尝试解释成变量。

循环语句

CMake 的循环有两种：

foreach ... endforeach
while ... endwhile

set(V alpha beta gamma)
message(${V})
foreach(i ${V})
message(${i})
endforeach()

foreach(loop_var RANGE start stop [step])
endforeach(loop_var)
从 start 开始到 stop 结束，以 step 为步进

常用命令

指定项目的名称

命令语法：project(<projectname> [languageName1 languageName2 ... ] )

使用范例：project(Main)

指定需要的 CMake 的最低版本

命令语法：cmake_minimum_required(VERSION major[.minor[.patch[.tweak]]] [FATAL_ERROR])

使用范例：cmake_minimum_required(VERSION 2.8)

将 dir 目录下的所有源文件的名字保存在变量中

命令语法：aux_source_directory(<dir> <variable>)

使用范例：aux_source_directory(. DIR_SRCS)

指定从一组源文件编译出一个可执行文件且命名

命令语法：add_executable(<name> [WIN32] [MACOSX_BUNDLE] [EXCLUDE_FROM_ALL]

source1 source2 … sourceN)

使用范例：add_executable(Main ${DIR_SRCS})

指定从一组源文件 source1 source2 … sourceN 编译出一个库文件且命名

命令语法：add_library([STATIC | SHARED | MODULE] [EXCLUDE_FROM_ALL] source1 source2 … sourceN)

使用范例：add_library(Lib ${DIR_SRCS})

指定某个目标（可执行文件或者库文件）依赖于其他的目标

命令语法：add_dependencies(target-name depend-target1 depend-target2 …)

这里的目标必须是 add_executable、add_library、add_custom_target 命令创建的目标

添加一个需要进行构建的子目录

命令语法：add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])

使用范例：add_subdirectory(Lib)

指定 target 需要链接

命令语法：target_link_libraries(<target> [item1 [item2 [...]]] [[debug|optimized|general] ] …)

这里 target 必须已经被创建，链接的item 可以是已经存在的 target（依赖关系会自动添加）

使用范例：target_link_libraries(Main Lib)

设定变量的值为

命令语法：set(<variable> <value> [[CACHE <type> <docstring> [FORCE]] | PARENT_SCOPE])

如果指定了 CACHE 变量将被放入 Cache（缓存）中。

使用范例：set(ProjectName Main)

移除变量

命令语法：unset(<variable> [CACHE])

命令简述：用于 variable。如果指定了 CACHE 变量将被从 Cache 中移除。

使用范例：unset(VAR CACHE)

输出信息

命令语法：message([STATUS|WARNING|AUTHOR_WARNING|FATAL_ERROR|SEND_ERROR] “message to display” …)

该输出的编译信息它自己会默认输出的。

使用范例：message(“Hello World”)

设定目录

命令语法：include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 …)

这些设定的目录将被编译器用来查找 include 文件

使用范例：include_directories(${PROJECT_SOURCE_DIR}/lib)

CMakeLists.txt 示例

cmake_minimum_required(VERSION 3.0) # 最低版本
project(main)   # 给这个工程一个名字，这不是可执行文件的名字，是工程的名字

# 设置编译选项，不知道最后能不能过
set(CMAKE_CXX_FLAGS ${CMAKE_CXX_FLAGS} -g)

# 设置可执行文件最后的输出目录
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

# 配置头文件的搜索路径
include_directories(${PROJECT_SOURCE_DIR}/include)
include_directories(${PROJECT_SOURCE_DIR}/include/server)
include_directories(${PROJECT_SOURCE_DIR}/include/server/model)
include_directories(${PROJECT_SOURCE_DIR}/include/server/db)
include_directories(${PROJECT_SOURCE_DIR}/thirdparty)

# 加载子目录
add_subdirectory(src)

# 定义一个SRC_LIST变量，存放该目录下所有的源文件
aux_source_directory(. SRC_LIST)
aux_source_directory(./db SRC_LIST)
aux_source_directory(./model SRC_LIST)

# 指定生成可执行文件
add_executable(ChatServer ${SRC_LIST})

# 指定可执行文件生成时需要链接的外部库
target_link_libraries(ChatServer muduo_net muduo_base pthread mysqlclient hiredis)

# 指定可执行文件存放位置
#set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}../bin)

CMake 常用变量

CMAKE_SOURCE_DIR
内容为 source tree 根目录的完整路径，也就是 CMake 开始建置过程的进入点。

CMAKE_BINARY_DIR
内容为 binary tree 根目录的完整路径，在 in-source build 的时候值与 CMAKE_SOURCE_DIR 相同。

PROJECT_SOURCE_DIR
目前正在处理中的专案最上层目录，即内含 project() 指令的 CMakeLists 所在资料夹。

PROJECT_BINARY_DIR
目前所属专案的建置根目录。在 in-source build 时和 PROJECT_SOURCE_DIR 相同。

CMAKE_CURRENT_SOURCE_DIR
目前正在处理的 CMakeLists.txt 所在位置。

CMAKE_CURRENT_BINARY_DIR
目前正在处理的 CMakeLists.txt 对应的建置资料夹位置。在 in-source build 时和 CMAKE_CURRENT_SOURCE_DIR 相同。

CMAKE_CURRENT_LIST_DIR
表示正在处理的 CMakeLists.txt 文件的所在的目录的绝对路径（2.8.3 以及以后版本才支持）

CMAKE_LIBRARY_OUTPUT_DIRECTORY
用于设置 LIBRARY 目标的输出路径