美文网首页
Cmake使用语法解析

Cmake使用语法解析

作者: 知止乎尔 | 来源:发表于2019-09-25 19:41 被阅读0次

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"

相关文章

网友评论

      本文标题:Cmake使用语法解析

      本文链接:https://www.haomeiwen.com/subject/hpywuctx.html