【cmake系列使用教程】
cmake使用教程（一）-起步
cmake使用教程（二）-添加库
cmake使用教程（三）-安装、测试、系统自检
cmake使用教程（四）-文件生成器
cmake使用教程（五）-cpack生成安装包
cmake使用教程（六）-蛋疼的语法
cmake使用教程（七）-流程和循环
cmake使用教程（八）-macro和function
这个系列的文章翻译自官方cmake教程：cmake tutorial。
示例程序地址：github.com/rangaofei/t…
不会仅仅停留在官方教程。本人作为一个安卓开发者，实在是没有linux c程序开发经验，望大佬们海涵。教程是在macos下完成，大部分linux我也测试过，有特殊说明的我会标注出来。本教程基于cmake-3.10.2，同时认为你已经安装好cmake。
“蛋疼的不止语法，还有文档”
本节讲的命令格式遵循如下语法：
cmake能识别CMakeLists.txt和*.cmake格式的文件。cmake能够以三种方式 来组织文件：
本系列主要以CMakeLists.txt的语法为主要讲解内容，至于编写这蛋疼的脚本和模块假如我还写的下去的话我就写。
当CMake处理一个项目时，入口点是一个名为的源文件，这个一定是根目录下的CMakeLists.txt。这个文件包含整个工程的构建规范，当我们有多个子文件夹需要编译时，使用命令来为构建添加子目录。添加的每个子目录也必须包含一个文件作为该子目录的入口点。每个子目录的CMakeLists.txt文件被处理时，CMake在构建树中生成相应的目录作为默认的工作和输出目录。记住这一点非常关键，这样我们就可以使用外部构建了，而不必每次都使用蛋疼的内部构建，然后删除一堆文件才能从新构建。
一个单独的源文件可以使用cmake命令行工具选项来执行脚本。脚本模式只是在给定的文件中运行命令，并且不生成构建系统。它不允许CMake命令定义或执行构建目标。
在Directory或Script中，CMake代码可以使用include()命令来加载.cmake。cmake内置了许多模块用来帮助我们构建工程，前边文章中提到的。也可以提供自己的模块，并在变量中指定它们的位置。
先看一下定义的方式
文档看起来很蛋疼，我直接写一个最简单的
也等于
就是这么easy。注意参数这一块，可以用引号包裹起来，这代表一个参数，假如一行不能写完，则用符号来表示连接成一行,也可以不用引号，但是假如参数带有分隔符，则会被认为是多个参数。
定义变量常用的函数是，取消定义变量是。 它们的值始终是string类型的，有些命令可能将字符串解释为其他类型的值。变量名是区分大小写的，可能包含任何文本，但是我们建议只使用字母数字字符加上_和-这样的名称。
变量的作用域和java基本一致，不多做讲解。
变量引用的形式为，并在引用的参数或未引用的参数中进行判断。变量引用被变量的值替换，或者如果变量没有设置，则由空字符串替换。变量引用可以嵌套，并从内部进行替换，例如。 环境变量引用的形式为$ENV{VAR}，并在相同的上下文中作为正常变量引用。
这算是进入正文了。扯淡的介绍就不多讲了，直接干货。
可执行文件和库是使用add_executable()和add_library()命令定义的。生成的二进制文件有合适的前缀、后缀和针对平台的扩展。二进制目标之间的依赖关系使用target_link_libraries()命令表示。
在构建c程序的时候，因为要生成可执行文件，是必须的；构建安卓动态库的时候，是必须的，因为jni需要调用动态库。
前边提到过cmake的构建命令,也就是在当前目录构建工程，这样会生成一系列的缓存文件在当前目录，假如我们需要重新构建需要删除这些文件，其中CMakeCache.txt是必须删除的，否则不会构建最新的程序。 看一下我们在工程根目录下执行后是什么情况：
生成的文件与源文件交叉在一起，相当混乱。我们可以采用外部构建来分隔源文件与生成的文件，当我们需要清空缓存重新构建项目时，就可以删除这个文件夹下的所有内容，重新运行构建命令，保持源文件的整洁，从而更容易管理项目。
首先新建一个文件夹。这个文件夹就是我们用来存放生成的文件的目录，然后进入该目录，执行构建命令。
此时可以看到生成的文件全部在build文件夹下了，构建完全没问题。
以后的项目讲解中将全部使用外部构建。
下面是我专门为讲解一些基本指令编写的代码
- 首先看message用法 message类似于一个向控制台输出日志的工具，但是功能又稍微强大一些，在一些模式下能够终止程序构建。
mode有以下几个模式
STATUS我们经常用到。
- 来看第一行：
为一个项目设置cmake的最低要求版本，并更新策略设置以匹配给定的版本(策略设置我永远也不会讲了)。无论是构建项目还是构建库，都需要这个命令。 它的语法是这样的
版本号必须指定主次代号，后边的可选，请忽略可选项，完全没用。
假如你指定的版本号大于你安装的cmake版本，将会停止构建并抛出一个错误:
必须在项目根目录下的最开始调用，也就是之前。在function()中调用该指令也可以，作用域将局限在函数内，但是必须以不影响全局使用为前提
- 来看第二行
指定项目的名称为，构建项目必须使用这个命令，构建库可以不指定。文档如下：
设置项目名称并将该名称存储在变量中。同时也指定了四个变量：
但是我们一般只使用前一个，这样更容易更改。在上边的代码中我们用message输出了这些变量的信息，执行构建命令后日志输出：
可以看到这几个变量确实输出了正确的值。
我们也可以在指定项目名称时直接指定版本号，假如没有指定，则版本号为空。 版本号存储在下边几个变量中:
通常我们推荐使用前一个。现在测试一下，在CMakeLists.txt文件中修改代码：
输出日志如下：
在这设置版本号和用set设置版本号效果一样，取最后一次设置的值。由于我们没有指定tweak版本，所以为空，同时看到description被存储到这个变量中了。
可以通过设置来指定编程语言是C、CXX(即c++)或者Fortran等，如果没有设置此项，默认启用C和CXX。设置为NONE，或者只写关键字而不写具体源语言，可以跳过启用任何语言。一般都是用cmake来编译c或者c++程序，所以用默认的就可以了。
- 来看重要的一行
该命令的作用是复制文件到另一个地方并修改文件内容。语法如下：
将文件复制到文件中，并在输入文件内容中替换或的变量值。每个变量引用将被替换为变量的当前值，如果变量的值未被定义，则为空字符串。（VAR必须与cmakelist.txt中的变量保持一直，否则会生成注释）
input文件的定义形式为:
经过configure后生成的文件内容被替换为：
生成的文件将会保留在'#'与'cmakedefine'之间的空格和制表符。
此处有一点需说明，现在clion默认使用cmake来构建程序，但是在clion中不支持关键字，所以可以直接使在input文件中填写来编写宏定义，生成的结果与上边完全一样。clion有一个问题，就是直接用定义宏的时候假如#与cmakedefine之间有空格则不会替换为，后边的变量会替换，但是不能编译成功，所以假如在clion中使用，要注意这几点，直接使用或者，尽量不要加空格。
介绍其中的选项: input和output假如不指定绝对路径，则会被默认设置为和，也就是项目根目录和构建的目录；
则只是复制文件，不替换任何东西，不能和一起使用。
禁止为转义。这个很蛋疼，不加这个命令的话假如变量中有，则在生成的文件中会直接使用转义后的字符，加上指令后则按原来的文字显示；
只允许替换包裹的变量则不会被替换；
设置换行符格式
现在举个例子： foo.h.in文件如下
CMakeLists.txt中添加代码来设置一个开关，下边会执行if中的语句：
生成的文件foo.h
假如设置为off，,则不会执行if中的语句，生成的文件如下：
- 这一行
这句话的意思将当前的二进制目录添加到编译器搜索include目录中，这样就可以直接使用上一步生成的头文件了。
将给定的目录添加到编译器用来搜索包含文件的目录。相对路径为相对于当前根目录。
括号中的目录被添加到当前CMakeLists文件的目录属性中。它们也被添加到当前CMakeLists文件中的每个目标的INCLUDE_DIRECTORIES目标属性中。。
默认情况下，指定的目录被追加到当前的include目录列表中。通过将设置为ON，可以更改此默认行为。通过明确使用AFTER或BEFORE，您可以选择添加和预先设置。
如果给出SYSTEM选项，那么编译器会被告知这些目录在某些平台上是指系统包含的目录。
这翻译的真是教我头大。
到此这篇cmake视频教程（cmake tutorial）的文章就介绍到这了,更多相关内容请继续浏览下面的相关推荐文章，希望大家都能在编程的领域有一番成就！版权声明：
本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如若内容造成侵权、违法违规、事实不符，请将相关资料发送至xkadmin@xkablog.com进行投诉反馈，一经查实，立即处理！
转载请注明出处，原文链接：https://www.xkablog.com/rfx/19206.html