cmake学习笔记

CMake是干嘛的，我不详说。我只知道，我写一个程序要将多个文件组织起来并编译。从头写一个MakeFile太麻烦。CMake配置文件比MakeFile要简单很多。
从原理上讲，CMake只是在帮助我们自动生成MakeFile而己。我们编译程序还是要make一下的。

我写了一个简单的示例，内容我们不需要关心，只关心其文件结构就行了。如下：
.
|-- CMakeLists.txt
|-- main.cpp
`-- person
    |-- CMakeLists.txt
    |-- person.cpp
    `-- person.h

在./目录与 person/都添加了一个CMakeLists.txt文件。

如下./CMakeLists.txt文件：

cmake_minimum_required(VERSION 3.0)
 
project(StudyCmake CXX)
message(STATUS "project source: " ${PROJECT_SOURCE_DIR})
message(STATUS "project binary: " ${PROJECT_BINARY_DIR})
 
add_subdirectory(person)
include_directories(person)
 
#set (main_src main.cpp)
aux_source_directory(. main_src)
message(STATUS "Source files : " ${main_src})
 
add_executable(StudyCmake ${main_src})
target_link_libraries(StudyCmake person)
 
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
message(STATUS "executable output path: " ${EXECUTABLE_OUTPUT_PATH})

第1行：cmake_minimum_required(VERSION 3.0)，这个最好有，表示版本信息。

第2行：project(StudyCmake CXX)，注明工程名称与编译的语言。CXX表示C++，C表示C。还有别的语言可选。这行语句的执行，会生成两个变量：
    > PROJECT_SOURCE_DIR    工程源码路径
    > PROJECT_BINARY_DIR    生成的可执行文件路径

第3-4行：message(STATUS "project source" ${PROJECT_SOURCE_DIR}，这是一条信息打印语句。当cmake执行到这一句，会向终端输出相应的信息。这种信息分几种，这里是STATUS表示是状态信息，除了这个还有：
    > SEND_ERROR    产生错误，生成过程被跳过
    > FATAL_ERROR    立即终止cmake

取变量的值是${变量名}，如：${PROJECT_SOURCE_DIR}。
在CMakeLists.txt里，变量名是区分大小写的，但命令不分大小写。如message与MESSAGE是等价的。但STATUS不等价于status。

第5行：add_subdirectory(person)，cmake执行到这句时，就会跳入./person目录，读取person目录下的CMakeLists.txt文件。./person/CMakeLists.txt文件稍候再讲解。

这里，跟随cmake的执行过程，打开./person/CMakeLists.txt：

aux_source_directory(. person_src)
message(STATUS "Print files : " ${person_src})
add_library(person ${person_src})

这个文件里的出现一个新的命令：add_library(person ${person_src})，添加了一静态库person，由${person_src}生成。而person_src变量就是./person/目录下所有的源文件。

好回到主目标下的CMakeLists.txt文件：

第6行：include_directories(person)，将./person加入头文件搜索路径。这样以来，在main.cpp文件里include "person.h"就不需要写成#include "person/person.h"了。

第7行：set(main_src main.cpp)，将main_src变量设置为"main.cpp"。上面这条命令前加了#，表示注释了。CMakeLists.txt里的注释与Shell里的注释类似。

第8行：aux_source_directory(. main_src)，将.目录下所有的源文件名称赋给main_src。这句命令与set(main_src main.cpp)是等价了。只不过aux_source_directory命令是通过去查目录所得，而set得写明。

第10行：add_executable(StudyCmake ${main_src})，添加一个可执行文件输出。由${make_src}生成StudyCmake可执行程序。这语话并不是以cmake执行的时候就完成可执行文件的生成，而是说我们要生成这么一个可执行文件。

第11行：target_link_libraries(StudyCmake person)，设置链接，将person与StudyCmake目标一起链接。person是静态库目标。

好！关于CMakeLists.txt的内容就讲完了。下面我们在cmake一下。
通常，我们不会在源码目录下直接执行cmake，而是在源码目录下建一个build目录。然后进入这个目录，再执行cmake ..

$ mkdir build
$ cd build/
$ cmake ..
-- The CXX compiler identification is GNU 4.4.7
-- Check for working CXX compiler: /usr/bin/c++
-- Check for working CXX compiler: /usr/bin/c++ -- works
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- project source: /home/hevake_lcj/Workspace/C++/StudyCMake
-- project binary: /home/hevake_lcj/Workspace/C++/StudyCMake/build
-- Print files : ./person.cpp
-- Source files : ./main.cpp
-- executable output path: /home/hevake_lcj/Workspace/C++/StudyCMake/build/bin
-- Configuring done
-- Generating done
-- Build files have been written to: /home/hevake_lcj/Workspace/C++/StudyCMake/build

cmake在执行过程中，不是立限就生成什么文件，而是通过解释上面的CMakeLists.txt文件里的命令来读取我们的意图。解释完之后，cmake才真正知道我们想到它做什么。最后才根据我们的意图生成对应的MakeFile与相关的目录层次。

cmake执行完之后，在build目录下就会生成很多文件，其中最主要的是生成了MakeFile。

前面我也说了cmake只不过是帮助我们生成MakeFile而己，真正的编译还得make一下才行。那就make一下好了。

$ make
Scanning dependencies of target person
[ 50%] Building CXX object person/CMakeFiles/person.dir/person.cpp.o
Linking CXX static library libperson.a
[ 50%] Built target person
Scanning dependencies of target StudyCmake
[100%] Building CXX object CMakeFiles/StudyCmake.dir/main.cpp.o
Linking CXX executable bin/StudyCmake
[100%] Built target StudyCmake

好了，我就先学到这里，相信日常的实用还是够用了。不够用的时候再学。

更多技能请参考：http://my.oschina.net/chen0dgax/blog/151894