CMake 使用方法 & CMakeList.txt

CMake 简介

CMake是一个跨平台的安装(编译)工具,可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件,能测试编译器所支持的C++特性,类似UNIX下的automake。

CMake使用方法

CMake的所有的语句都写在一个叫:CMakeLists.txt的文件中。当CMakeLists.txt文件确定后,可以用ccmake命令对相关 的变量值进行配置。这个命令必须指向CMakeLists.txt所在的目录。配置完成之后,应用cmake命令生成相应的makefile（在Unix like系统下）或者 project文件（指定用window下的相应编程工具编译时）。

其基本操作流程为：

ccmake directory
cmake directory
make

其中directory为CMakeList.txt所在目录；
第一条语句用于配置编译选项，如VTK_DIR目录 ，一般这一步不需要配置，直接执行第二条语句即可，但当出现错误时，这里就需要认为配置了，这一步才真正派上用场；
第二条命令用于根据CMakeLists.txt生成Makefile文件；
第三条命令用于执行Makefile文件，编译程序，生成可执行文件；
CMake的执行就是这么简单，其难点在于如何编写CMakeLists.txt文件，下面结合例子简单介绍CMakeLists.txt的编写，看下面这个CMakeLists.txt

PROJECT(test_math)  
#head file path  
INCLUDE_DIRECTORIES(  
include  
)  
#source directory  
AUX_SOURCE_DIRECTORY(src DIR_SRCS)  
#set environment variable  
SET(TEST_MATH  
${DIR_SRCS}  
)  
#set extern libraries  
SET(LIBRARIES  
libm.so  
)  
#add executable file  
ADD_EXECUTABLE(../bin/bin ${TEST_MATH})  
#add link library  
TARGET_LINK_LIBRARIES(../bin/bin ${LIBRARIES}) 

或者用下面这个CMakeLists.txt

#project name  
PROJECT(test_math)  
#head file path  
INCLUDE_DIRECTORIES(  
include  
)  
#source directory  
AUX_SOURCE_DIRECTORY(src DIR_SRCS)  
#set environment variable  
SET(TEST_MATH  
${DIR_SRCS}  
)  
#add executable file  
ADD_EXECUTABLE(../bin/bin ${TEST_MATH})  
#add link library  
TARGET_LINK_LIBRARIES(../bin/bin m) 

这是一个测试数学函数的程序的CMakeLists.txt，”#”后面为注释的内容，CMake的命令全部为大写
第2行指定生成的工程名为test_math

第4行指定头文件目录为include

第8行指定源文件目录为src，并将其赋值给环境变量DIR_SRCS

第10行设定环境变量TEST_MATH的值为环境变量DIR_SRCS的值，此处用于显示如何用环境变量对环境变量进行赋值

第14行将数学函数库赋值给环境变量LIBRARIES，当然，可以不用这个环境变量，而在后面直接使用该库名

第18行用于指定生成文件，将环境变量TEST_MATH目录下的所有文件编译生成../bin目录下的可执行文件bin

第20行指定../bin/bin执行时的链接库为环境变量LIBRARIES的值－libm.so

下面给出源文件
/src/main.c:

#include<stdio.h>  
#include"../include/a.h"  
int main()  
{  
    double b=25.0;  
    double a=0.0;  
    a=get_sqrt(b);  

    printf("a is %lf, b is %lf\n",a,b);  
    return 0;  
}

src/a.c

#include"../include/a.h"  
double get_sqrt(double var1)  
{  
    return sqrt(var1);  
} 

/include/a.h

#ifndef  A_FILE_HEADER_INC
#define  A_FILE_HEADER_INC  
#include<math.h>  

double get_sqrt(double var1);  

#endif

将CMakeLists.txt放在当前目录下，执行命令

cmake . (.代表当前目录，..代表上一级目录)
make

即可生成我们需要的可执行文件~

当然我们也可用cmake生成静态库，动态库，使用cmake跨平台编译。
比如用C++所写的代码，我们可以使用cmake结合xcode在MacOS平台生成IOS 64位Archive目标,即static静态库：
命令示例：

cmake -DCMAKE_TOOLCHAIN_FILE=/Users/macos/Desktop/ios-cmake-master/ios.toolchain.cmake -DIOS_PLATFORM=OS -DLibDebug_x64=1 -GXcode ../
cmake –build .

cmake_toolchain_file –> ios.toolchain.cmake文件非常重要，指示构建版本以及目标库的一些特性

目前在用cmake构建iOSClient的Xcode工程，对CMakeLists有更加深入的一些了解，可使用cmake的指令动态构建Debug版本以及Release版本的Xcode工程，从而减轻手动配置工程的麻烦…

cmake -DCMAKE_BUILD_TYPE=Debug -GXcode ..
cmake –build .

cmake在项目迁移，跨平台编译方面很强大，作为一个工具，要多使用，才能慢慢明白其强大功能~