Cmake使用语法解析

Cmake工具

cmake 交叉编译系统生成工具
ctest 自动化测试工具
cpack 自动化打包工具可以生成各种格式的安装程序和源码包

Cmake 语法

相比于make的规则，输入文件有指定的命名规则即为Makefile.
Cmake 输入文件是以Cmake语法编写的，以CmakeLists.txt命名或以.cmake扩展名的文件.为了尽可能的跨平台使用的7-bit ASCII 字符编写，使用UTF-8编码。

1. 多级依赖目录树和配置文件配置

使用add_subdirectory()函数，添加同样包含CmakeList.txt,Cmake进行编译时，会在build相应的目录下生成输出文件.
通用资源或配置可以添加<script>.cmake,以模块的形式进行加载，相应的加载函数为include().
单独运行配置文件,使用-P选项如：cmake -P <script>.cmake

2. 命令调用

命令格式

命令调用是方法名加圆括号的形式，括号内的参数以空格或换行符分割开。方法命名不区分大小写。

line_ending  ::=  line_comment? newline
space        ::=  <match '[ \t]+'>
newline      ::=  <match '\n'>
separation   ::=  space | line_ending

三种参数格式支持

命令调用支持三种语法格式，分别是引用格式、未引用格式、lua长括号语法。
未引用格式所有空格、(、)、#、"、\都应该使用转译符\进行注释
实例如下：

#引用语法（quoted argument ）
message(STATUS "config is called syntax 1 ")
#未引用语法（unquoted argument）
message(STATUS config\ is\ called\ syntax\ 2)
#长括号语法（Bracket Argument）
message(STATUS [==[config is called syntax 3]==])

#result
cmake -P ../app/config.cmake
-- config is called syntax 1
-- config is called syntax 2
-- config is called syntax 3

变量引用

引用变量格式为${<variable>}，可以在引用格式或未引用格式中使用。支持变量的嵌套，由内而外的解析${outer_${inner_variable}_variable}。

注释

注释应该以#开头，支持lua长括号语法\

# this is a Comment

#[=[ lua long bracket syntax Comment]=]  #可多行

3. 控制语句

控制语句主要分为以下几类：

条件语句
循环语句
宏、函数定义
变量、环境变量
列表

条件语句

使用if()/elseif()/else()/endif() 命令分割代码块完成条件控制。

if(<condition>)
  <commands>
elseif(<condition>) # optional block, can be repeated
  <commands>
else()              # optional block
  <commands>
endif()

循环语句

使用foreach()/endforeach() / while()/endwhile() 来划分代码块用以在循环中执行。类似于其他语言使用 break()提前结束循环，使用 continue() 函数提前开始下一个迭代过程。

#foreach 遍历循环
foreach(<loop_var> <items>)
  <commands>
endforeach()

#while条件循环
while(<condition>)
  <commands>
endwhile()

宏、函数定义

使用 macro()/endmacro(), and function()/endfunction() 命令定义宏或者函数，在后面作为新的命令调用相应代码块。

变量、环境变量

变量和环境变量类型都是字符串类型，使用set()和unset()命令令进行定义和撤销变量，但是其他命令可以更新变量值。注意，变量名不同于命令是区分大小写的，理论上名命可以是任意字符，但是只推荐使用-和_作为分隔符。
环境变量的区别在于，作用域是当前Cmake进程，设置和引用时要增加ENV标记.

#变量设置
set(<variable> <value>... CACHE <type> <docstring> [FORCE])
#变量引用
${<variable>}

#环境变量设置
set(ENV{<variable>} [<value>])
#环境变量引用
$ENV{<variable>}

列表

列表是以;区分开的字符串，而且大多数的命令并不会自动转译掉;，因此可以扁平化嵌套列表.

set(x a "b;c") # sets "x" to "a;b;c", not "a;b\;c"

最后编辑于：2019.10.24 11:01:23