cmake简介

• cmake诞生主要是为了解决make+Makefile这种方式无法实现跨平台编译的问题，cmake是可以实现跨平台的编译工具。

  在不同平台下，make工具遵循着不同的规范和标准，对应的makefile文件语法、格式也不同。

• cmake工具通过解析CMakeLists.txt，自动生成Makefile。

• cmake官方教程

  文档链接地址：https://cmake.org/documentation/

  培训教程：https://cmake.org/cmake/help/latest/guide/tutorial/index.html

CMakeLists.txt语法

简单语法介绍

• “#”进行单行注释

• command(参数1 参数2 参数3)

  多个参数分隔使用空格

  参数分为必要参数：<参数>，可选参数：[参数]

  命令不区分大小写，例如project和PROJECT等价。建议小写，因为cmake的内置变量名称都是使用大写。

• set(变量 值)

  变量分为cmake内置变量和自定义变量

  变量可以使用set变量设置

  使用${变量}来引用变量

部分常用命令

• 所有命令及介绍链接：https://cmake.org/cmake/help/v3.5/manual/cmake-commands.7.html

• list

• message

  message([\<mode>] "message to display")

  也可以用message打印变量：message(${VAL})

• project

  project(HELLO)

  执行之后会引入两个变量：HELLO_SOURCE_DIR和HELLO_BINARY_DIR，前者指工程源码目录，后者指工程源码的输出文件目录。如果不设置project(HELLO)，这两个变量不存在，Cmake中PROJECT_SOURCE_DIR和PROJECT_BINARY_DIR分别与这两个变量等价。

• set

  set( ... [PARENT_SCOPE])

  用于设置变量的值

  用于实现字符串列表：set(SRC_LIST 1.c 2.c 3.c 4.c 5.c)

• target_include_directories 和 target_link_libraries

  target_include_directories 为指定目标设置头文件搜索路径

  target_include_directories(\<target> [SYSTEM] [BEFORE] \<INTERFACE|PUBLIC|PRIVATE> [items1...] [\<INTERFACE|PUBLIC|PRIVATE> [items2...]...])

  target_link_directories 为指定目标设置链接库文件搜索路径

  target_link_directories(\<target> \<INTERFACE|PUBLIC|PRIVATE> [item...] [\<INTERFACE|PUBLIC|PRIVATE> [item...]...])

  \<target>指的是add_executable、add_library命令所创建的目标。

  • PRIVATE：包含目录列表仅用于当前目标
  • INTERFACE：包含目录列表不用于当前目标，只能用于依赖该目标的其它目标
  • PUBLIC：包含目录列表既用于当前目标、也会传递给当前目标的依赖目标

  尽量使用target_include_directories和target_link_libraries，避免include_directories和link_libraries的向下传递，使得整个工程目标的逻辑保持清晰。

部分常用变量

• 内置变量资料链接：https://cmake.org/cmake/help/v3.5/manual/cmake-variables.7.html

提供信息的变量

改变行为的变量

描述系统的变量

控制编译的变量

双引号

• 命令参数

  例如：project("Hello World")

  cmake会将双引号引起来的内容作为一个整体

• 引用变量

  set(MY_LIST Hello World China)

  message("${MY_LIST}")

  会输出 Hello;World;China

  如果直接message(${MY_LIST})

  会输出 HelloWorldChina

条件判断

• 条件判断形式如下：

  if(expression)

  ​ command1(args ...)

  ​ command2(args ...)

  elseif(expression2)

  ​ command1(args ...)

  ​ command2(args ...)

  else(expression)

  ​ command1(args ...)

  ​ command2(args ...)

  endif(expression)

  else和endif中的expression可写可不写，如果写，需和if中的expression保持一致。

• expression表达式链接：https://cmake.org/cmake/help/v3.5/command/if.html

循环语句

foreach()循环

• 基本用法

  foreach(loop_var arg1 arg2)

  ​ command1(args ...)

  ​ command2(args ...)

  ​ ...

  endforeach(loop_var)

  例如：

  foreach(loop_var A B C D)

  ​ message("${loop_var}")

  endforeach()

  输出为A B C D

  endforeach中的loop_var可写可不写，如果写要与foreach保持一致

• RANGE用法

  foreach(loop_var RANGE stop) 会从0循环到指定的数字stop，闭区间

  foreach(loop_var RANGE start stop [step]) 从start循环到stop，步长为step，默认步长为1，闭区间

• IN用法

  foreach(loop_var IN [LISTS [list1 [...]]] [ITEMS [item1 [...]]]) 循环列表(LISTS)中的每一个元素，或者直接指定循环元素(ITEMS)

while()循环

• while用法

  while(condition)

  ​ command1(args)

  ​ command1(args)

  endwhile(condition)

break & continue

• break用于跳出循环
• continue用于结束本次循环，进行下一次循环

数学运算

• 用法

  math(EXPR \<output variable> \<math expression>)

  例如：

  math(EXPR out_var "1+1")

  message("${out_var}")

练习代码

• gitee代码仓库链接：https://gitee.com/sigmapoet/cmake-exercise

参考文献

• 《正点原子 I.MX6U 嵌入式Linux C应用编程指南》