使用cmake构建工程

之前在linux下做项目的时候，都要自己手动的写Makefile来编译项目。后来，做Android jni开发后，发现Android studio默认的c/c++编译的工具是cmake,一开始对语法丝毫不动，查了一下资料后慢慢有了一些认识，这才发现cmake确实比写Makefile要方便多了。cmake需要较少的信息，就能为项目生成非常完成的Makefile系统，省去了大量需要手工编写脚本的工作。

最简单的CMakeLists.txt

假设工程只有一个文件：main.cpp,内容如下：

#include<iostream>

using namespace std;
int main()
{
    cout<<"hello world"<<endl;
    return 0;
}

那么我们可以写一个简单的CMakeLists.txt来构建工程

# Sets the minimum version  
cmake_minimum_required(VERSION 2.8.1)
project (HELLO)
#build a variable to save the filename that need build 
set(SRC_LIST main.cpp )
add_executable (hello_bin ${SRC_LIST})

cmake_minimum_required
声明cmake支持的最小版本
project
声明工程的名字
set
set用来声明一个变量。SRC_LIST就是要声明的变量的名称，后面是这个变量的值，值可以有很多个，用空白符分开。
add_executable
告诉cmake，我需要编译生成一个可执行文件，这个可执行文件的名字叫hello_bin,编译这个可执行文件需要的源文件为SRC_LIST所指定的源文件列表，这里只有一个文件。
这样，我们就可以用cmake来构建工程了，执行cmake ./，成功后执行make即可生成hello_bin可执行文件。
结果如下：

如果要编译为静态库，只需把CMakeLists.txt中的add_executable 改为add_library即可。
如下：

add_library (hello ${SRC_LIST})

这样会生成libhello.a的静态库。
如果要编译为静态库，则需要添加SHARED字段，如下：

add_library (hello SHARED ${SRC_LIST})

这样会生成libhello.so的动态库。

多目录、多文件的CMakeLists.txt系统

我们的工程一般不可能只有一个文件。那么如果有多个文件，多个目录该怎么办呢？
假设有这样的工程目录：

可以看到：顶层有main.cpp和CMakeLists.txt两个文件，同时又三个目录，其中，include是头文件的目录。
几个文件的内容如下：
main.cpp:

#include "module1.hpp"
#include "module2.hpp"

using namespace std;
int main()
{
    module1();
    module2();
    return 0;
}

module1.cpp:

#include<iostream>
using namespace std;
void module1()
{
    cout<<"module1"<<endl;
}

module2.cpp:

#include<iostream>
using namespace std;
void module2()
{
    cout<<"module2"<<endl;
}

module1.hpp

#ifndef MODULE1_H
#define MODULE1_H

extern void module1(); 

#endif

module2.hpp

#ifndef MODULE1_H
#define MODULE1_H

extern void module2(); 

#endif

对于这样的项目，顶层的CMakeLists.txt可以这么写：

# Sets the minimum version
cmake_minimum_required(VERSION 2.8.1)
project(HELLO)
include_directories(include)
add_subdirectory(module1) 
add_subdirectory(module2)
#build a variable to save the filename that need build set(SRC_LIST main.cpp )
add_executable (hello_bin ${SRC_LIST})
target_link_libraries(hello_bin module1 module2)

include_directories用来指明头文件所在的目录。
add_subdirectory用来添加工程的子目录。一次只能添加一个。
我们的思路是，每一个子目录下的所有文件共同编译为一个静态库，最后一起连接称为一个可执行文件。因此，target_link_libraries 的意图就是把所有的子目录下生成的静态库和其他库一起，连接生成一个可执行文件。
由于每个子目录下的文件都会生成对应的静态库，因此，子目录下的CMakeLists.txt可以简单的这么写：

#build a variable to save the filename that need build 
set(SRC_LIST_MODULE1 module1.cpp)
add_library  (module1 ${SRC_LIST_MODULE1})

这里就没有任何新的东西了，就是把module1.cpp编译为libmodule1.a这个静态库了。
最后执行cmake ./ 然后执行make,结果如下

如果，某一个目录下有很多个文件，那我们还需要一个一个的输入并赋值给一个变量吗？不需要了，有一个很好的函数：aux_source_directory
用法如下：

aux_source_directory(. SRC_LIST)

aux_source_directory的第一个参数指定要扫描的目录，第二参数是一个变量，将扫描的结果存储到这个变量中。
修改后的顶层的CMakeLists.txt如下：

# Sets the minimum version
cmake_minimum_required(VERSION 2.8.1)
project(HELLO)
include_directories(include)
add_subdirectory(module1) 
add_subdirectory(module2)
#build a variable to save the filename that need build 
aux_source_directory(. SRC_LIST)
add_executable (hello_bin ${SRC_LIST})
target_link_libraries(hello_bin module1 module2)

字幕侠的CMakeLists.txt也可以做类似修改。

其他重要的函数

1. 添加需要链接的库文件目录LINK_DIRECTORIES

语法：
link_directories(directory1 directory2 …)
它相当于g++命令的-L选项的作用，也相当于环境变量中增加LD_LIBRARY_PATH的路径的作用。
例如：
link_directories(“/user/lib”)

1. 查找库所在目录FIND_LIBRARY

语法：

find_library (<VAR> name1 [path1 path2 ...])
The general signature is:

find_library (
          <VAR>
          name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
          [HINTS path1 [path2 ... ENV var]]
          [PATHS path1 [path2 ... ENV var]]
          [PATH_SUFFIXES suffix1 [suffix2 ...]]
          [DOC "cache documentation string"]
          [NO_DEFAULT_PATH]
          [NO_CMAKE_ENVIRONMENT_PATH]
          [NO_CMAKE_PATH]
          [NO_SYSTEM_ENVIRONMENT_PATH]
          [NO_CMAKE_SYSTEM_PATH]
          [CMAKE_FIND_ROOT_PATH_BOTH |
           ONLY_CMAKE_FIND_ROOT_PATH |
           NO_CMAKE_FIND_ROOT_PATH]
         )

复制代码
例子如下：

find_library( # Sets the name of the path variable. 
              log-lib
              # Specifies the name of the NDK library that
              # you want CMake to locate.
              log )

会从已指定的库目录中查找log这个库，并将结果保存在log-lib变量中。
3.add_definitions：添加编译参数
比如add_definitions(-DDEBUG)将在gcc命令行添加DEBUG宏定义
4.add_compile_options ：添加的编译选项
比如使用add_compile_options添加-std=C++11选项，是想在编译c++代码时加上c++11支持选项。
，设置编译选项可以通过add_compile_options命令，也可以通过set命令修改CMAKE_CXX_FLAGS或CMAKE_C_FLAGS。
使用这两种方式在有的情况下效果是一样的，但请注意它们还是有区别的：
add_compile_options命令添加的编译选项是针对所有编译器的(包括c和c++编译器)，而set命令设置CMAKE_C_FLAGS或CMAKE_CXX_FLAGS变量则是分别只针对c和c++编译器的。