CMAKE使用手册黄丽卿2010.03.30简单例子：MAIN.C我们以一个简单例子开始，逐步解析cmake的完整构建过程创建t1目录，在此目录下建立main.cmain.c文件内容：//main.c#includeintmain(){printf(“HelloWorldfromt1Main!\n”);return0;}简单例子：CMAKELISTS.TXTCMakeLists.txt，这个文件是cmake的构建定义文件，文件名是大小写相关的，如果工程存在多个目录，需要确保每个要管理的目录都存在一个CMakeLists.txt在t1目录建立CMakeLists.txt(注意文件名大小写)CmakeLists.txt文件内容：PROJECT(HELLO)SET(SRC_LISTmain.c)ADD_EXECUTABLE(helloSRC_LIST)简单例子：语法规则简单的解释构建文件CMakeLists.txt：PROJECT指令的语法是：PROJECT(projectname[CXX][C][Java])你可以用这个指令定义工程名称，并可指定工程支持的语言，支持的语言列表是可以忽略的，默认情况表示支持所有语言。SET指令的语法是：SET(VAR[VALUE][CACHETYPEDOCSTRING[FORCE]])只需要了解SET指令可以用来显式的定义变量即可。比如我们用到的是SET(SRC_LISTmain.c)，如果有多个源文件，也可以定义成：SET(SRC_LISTmain.ct1.ct2.c)。简单例子：语法规则ADD_EXECUTABLE(hello${SRC_LIST})定义了这个工程会生成一个文件名为hello的可执行文件，相关的源文件是SRC_LIST中定义的源文件列表，本例中你也可以直接写成ADD_EXECUTABLE(hellomain.c)。另外，变量使用${}方式取值，但是在IF控制语句中是直接使用变量名简单例子：开始构建在CMakeLists.txt所在目录下运行cmake.(注意命令后面的点号，代表本目录)。系统自动生成了CMakeFiles,CMakeCache.txt,cmake_install.cmake等文件，并且生成了Makefile.在这个目录输入make命令.这时候，我们需要的目标文件hello已经构建完成，位于当前目录运行一下：./hello得到输出：HelloWorldfromMain构建多目录工程创建目录tmp，在此目录下分别创建目录include、source目录及main.c文件。在source目录下创建目录a，在a目录下创建文件afile.c:内容如下#include"../../include/tmp.h"#includevoidfunc_a(){printf("thisisfunc_a\n");}构建多目录工程在source目录下创建目录b，在b目录下创建文件bfile.c:内容如下#include"../../include/tmp.h"#includevoidfunc_b(){printf("thisisfunc_b\n");}构建多目录工程在include目录下创建文件tmp.h:内容如下voidfunc_a();voidfunc_b();在tmp目录下创建文件main.c:内容如下#include"include/tmp.h"intmain(){func_a();func_b();return0;}构建多目录工程在tmp目录下创建文件CMakeLists.txt，内容如下：PROJECT(TMP)ADD_DEFINITIONS(-DPOSIX)AUX_SOURCE_DIRECTORY(source/aDIR_SRC_A)AUX_SOURCE_DIRECTORY(source/bDIR_SRC_B)SET(TMP_SRCSmain.c${DIR_SRC_A}${DIR_SRC_B})ADD_EXECUTABLE(main${TMP_SRCS})语法规则ADD_DEFINITIONS向C/C++编译器添加-D定义，比如:ADD_DEFINITIONS(-DENABLE_DEBUG)，参数之间用空格分割。也可设置编译器参数，例如ADD_DEFINITIONS(-g)AUX_SOURCE_DIRECTORY基本语法是：AUX_SOURCE_DIRECTORY(dirVARIABLE)作用是发现一个目录下所有的源代码文件并将列表存储在一个变量中，这个指令临时被用来自动构建源文件列表动态库构建以前面多目录工程tmp为例，只要将CMakeLists.txt改为如下即可：PROJECT(TMP)ADD_DEFINITIONS(-DPOSIX)ADD_DEFINITIONS(-DDEBUG)AUX_SOURCE_DIRECTORY(source/aDIR_SRC_A)AUX_SOURCE_DIRECTORY(source/bDIR_SRC_B)SET(TMP_SRCS${DIR_SRC_A}${DIR_SRC_B})ADD_LIBRARY(tmpSHARED${TMP_SRCS})静态库以前面多目录工程tmp为例，只要将CMakeLists.txt改为如下即可：PROJECT(TMP)ADD_DEFINITIONS(-DPOSIX)ADD_DEFINITIONS(-DDEBUG)AUX_SOURCE_DIRECTORY(source/aDIR_SRC_A)AUX_SOURCE_DIRECTORY(source/bDIR_SRC_B)SET(TMP_SRCS${DIR_SRC_A}${DIR_SRC_B})ADD_LIBRARY(tmpSTATIC${TMP_SRCS})安装共享库和头文件以安装动态共享库为例，只需在CMakeLists.txt添加：INSTALL(TARGETSmainLIBRARYDESTINATIONlib)通过:静态库则添加INSTALL(TARGETSmainARCHIVEDESTINATIONlib)头文件安装命令：INSTALL(FILESinclude/tmp.hDESTINATIONinclude/lib)通过:cmake-DCMAKE_INSTALL_PREFIX=/usr.makemakeinstall我们就可以将头文件和共享库安装到系统目录/usr/lib和/usr/include/hello中了
