美文网首页
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