linux_cmake学习指导.pdfVIP

在 linux 下使用 CMake 构建应用程序 级别： 初级 王 程明 (wangchengming.jlu@), 硕士研究生, 吉林大学计算机科学与技术学院 2009 年 2 月 05 日 本文介绍了一个跨平台的自动化构建系统 CMake 在 linux 上的使用方法。 CMake 是一个比 automake 更加容易使用的工具，能够使程序员从复杂的编译连接过程中解脱出来。文中通过一些例子介 绍使用 CMake 处理多源文件目录的方法、查找并使用其他开发包的方法以及生成 debug 版和 release 版程序的方法。 CMake 简介 CMake 是一个跨平台的自动化建构系统,它使用一个名为 CMakeLists.txt 的文件来描述构建过程,可以 产生标准的构建文件,如 Unix 的 Makefile 或Windows Visual C++ 的 projects/workspaces 。文 件 CMakeLists.txt 需要手工编写,也可以通过编写脚本进行半自动的生成。CMake 提供了比 autoconfig 更简洁的语法。在 linux 平台下使用 CMake 生成 Makefile 并编译的流程如下: 1. 编写 CmakeLists.txt。 2. 执行命令 “cmake PATH” 或者 “ccmake PATH” 生成 Makefile ( PATH 是 CMakeLists.txt 所在 的目录 )。 3. 使用 make 命令进行编译。 第一个工程 现假设我们的项目中只有一个源文件 main.cpp 清单 1 源文件 main.cpp 1 #includeiostream 2 3 int main() 4 { 5 std::coutHello word!std::endl; 6 return 0; 7 } 为了构建该项目,我们需要编写文件 CMakeLists.txt 并将其与 main.cpp 放在 同一个目录下: 清单 2 CMakeLists.txt 1 PROJECT(main) 2 CMAKE_MINIMUM_REQUIRED(VERSION 2.6) 3 AUX_SOURCE_DIRECTORY(. DIR_SRCS) 4 ADD_EXECUTABLE(main ${DIR_SRCS}) CMakeLists.txt 的语法比较简单,由命令、注释和空格组成,其中命令是不区分大小写的,符号#后面的 内容被认为是注释。命令由命令名称、小括号和参数组成,参数之间使用空格进行间隔。例如对于清单2 的 CMakeLists.txt 文件:第一行是一条命令,名称是 PROJECT ,参数是 main ,该命令表示项目的名称是 main 。第二行的命令限定了 CMake 的版本。第三行使用命令 AUX_SOURCE_DIRECTORY 将当前 目录中的源文件名称赋值给变量 DIR_SRCS 。 CMake 手册中对命令 AUX_SOURCE_DIRECTORY 的描述如下: aux_source_directory(dir variable) 该命令会把参数 dir 中所有的源文件名称赋值给参数 variable 。 第四行使用命令 ADD_EXECUTABLE 指示变量 DIR_SRCS 中的源文件需要编译 成一个名称为 main 的可执行文件。 完成了文件 CMakeLists.txt 的编写后需要使用 cmake 或 ccmake 命令生成Makefile 。 ccmake 与命令 cmake 的不同之处在于 ccmake 提供了一个图形化的操作界面。cmake 命令的执行方式如下: cmake [options] path-to-source 这里我们进入了 main.cpp 所在的目录后执行 “cmake .” 后就可以得到 Makefile 并使用 make 进 行编译,如下图所示。 图 1. camke 的运行结果 处理多源文件目录的方法 CMake 处理源代码分布在不同目录中的情况也十分简单。现假设我们的源代码分布情况如下: 图 2. 源代码分布情况 其中 src 目录下的文件要编译成一个链接库。 第一步，项目主目录中的 CMakeLists.txt 在目录 step2 中创建文件 CMakeLists.txt 。文件内容如下: 清单 3 目录 step2 中的 CMakeLists.txt 1 PROJECT(