cmake和CMakeLists.txt的学习

CMake是一个跨平台的安装（编译）工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件，能测试编译器所支持的C++特性,类似UNIX下的automake。只是 CMake 的组态档取名为 CMakeLists.txt。Cmake 并不直接建构出最终的软件，而是产生标准的建构档（如 Unix 的 Makefile 或 Windows Visual C++ 的 projects/workspaces），然后再依一般的建构方式使用。这使得熟悉某个集成开发环境（IDE）的开发者可以用标准的方式建构他的软件，这种可以使用各平台的原生建构系统的能力是 CMake 和 SCons 等其他类似系统的区别之处。

cmake的使用
cmake的所有语句都写在一个CMakeLists.txt的文件中，CMakeLists.txt文件确定后，直接使用cmake命令进行运行，但是这个命令要指向CMakeLists.txt所在的目录，cmake之后就会产生我们想要的makefile文件。
引用cmake的使用方法这篇文章http://www.cnblogs.com/lyq105/archive/2010/12/03/1895067.html，

cmake执行的流程:

$> ccmake directory
$> cmake directory
$> make
其中directory为CMakeList.txt所在目录；

第一条语句用于配置编译选项，如VTK_DIR目录 ，一般这一步不需要配置，直接执行第二条语句即可，但当出现错误时，这里就需要认为配置了，这一步才真正派上用场；
第二条命令用于根据CMakeLists.txt生成Makefile文件；
第三条命令用于执行Makefile文件，编译程序，生成可执行文件；
cmake的执行流程很简单，我们的重点是如何编写CMakeLists.txt文件呢，我们通过例子来学习cmake的语法。

例子从这篇文章中学习https://www.jianshu.com/p/f3da16a89f39，大致如下：

1、一个最简单的例子：
输出hello world

// main.c
#include <stdio.h>
int main()
{
printf(“hello world”);
return 0;
}
CMakeLists.txt文件：

project(HELLO)
set(SRC_LIST main.c)
add_executable(hello ${SRC_LIST}))
就这几句，是不是很简单，由于执行cmake的时候会产生很多中间文件，我们采用out of source（外部编译）方式进行构建，我们建立一个build目录储存中间执行过程。

例子目录下的文件，进入build目录，执行cmake …，cmake执行指向上一个目录，也就是存储CMakeLists.txt的目录，完成后就会看到makefile文件，make过后就会看到执行文件。
第一个行project不是强制性的，最好加上，这会引入两个变量：
HELLO_BINARY_DIR, HELLO_SOURCE_DIR
同时也会定义两个等价的变量：

PROJECT_BINARY_DIR, PROJECT_SOURCE_DIR
外部编译要时刻区分这两个变量对应的目录:
可以通过message进行输出

message(${PROJECT_SOURCE_DIR})
set 命令用来设置变量:

add_exectuable 告诉工程生成一个可执行文件。
add_library 则告诉生成一个库文件。
注意：CMakeList.txt 文件中，命令名字是不区分大小写的，而参数和变量是大小写相关的。

2、一个源文件的例子一似乎没什么意思，拆成3个文件再试试看：
hello.h 头文件

#ifndef DBZHANG_HELLO_
#define DBZHANG_HELLO_

void hello(const char* name);

#endif //DBZHANG_HELLO_
hello.c

#include <stdio.h>
#include “hello.h”
void hello(const char * name)
{
printf (“Hello %s!/n”, name);
}
main.c

#include “hello.h”
int main()
{
hello(“World”);
return 0;
}
然后准备好CMakeList.txt 文件

project(HELLO)
set(SRC_LIST main.c hello.c)
add_executable(hello ${SRC_LIST})
执行cmake的过程同上

3、接前面的例子，我们将 hello.c 生成一个库，然后再使用会怎么样？
改写一下前面的CMakeList.txt文件试试：

project(HELLO)
set(LIB_SRC hello.c)
set(APP_SRC main.c)
add_library(libhello ${LIB_SRC})
add_executable(hello ${APP_SRC})
target_link_libraries(hello libhello)
和前面相比，我们添加了一个新的目标 libhello，并将其链接进hello程序

因为我的可执行程序(add_executable)占据了 hello 这个名字，所以 add_library 就不能使用这个名字了
然后，我们去了个libhello 的名字，这将导致生成的库为 libhello.lib(或 liblibhello.a)，很不爽
想生成 hello.lib(或libhello.a) 怎么办?

添加一行

set_target_properties(libhello PROPERTIES OUTPUT_NAME “hello”)
就可以了

4、在前面，我们成功地使用了库，可是源代码放在同一个路径下，还是不太正规，怎么办呢？
分开放呗，现在需要3个CMakeList.txt 文件了，每个源文件目录都需要一个，还好，每一个都不是太复杂

顶层的CMakeList.txt 文件

project(HELLO)
add_subdirectory(src)
add_subdirectory(libhello)
src 中的 CMakeList.txt 文件

include_directories(${PROJECT_SOURCE_DIR}/libhello)
set(APP_SRC main.c)
add_executable(hello ${APP_SRC})
target_link_libraries(hello libhello)
libhello 中的 CMakeList.txt 文件

set(LIB_SRC hello.c)
add_library(libhello ${LIB_SRC})
set_target_properties(libhello PROPERTIES OUTPUT_NAME “hello”)
恩，和前面一样，建立一个build目录，在其内运行cmake，然后可以得到
build/src/hello.exe
build/libhello/hello.lib
回头看看，这次多了点什么，顶层的 CMakeList.txt 文件中使用 add_subdirectory 告诉cmake去子目录寻找新的CMakeList.txt 子文件
在 src 的 CMakeList.txt 文件中，新增加了include_directories，用来指明头文件所在的路径。

5、前面还是有一点不爽：如果想让可执行文件在 bin 目录，库文件在 lib 目录怎么办？
一种办法：修改顶级的 CMakeList.txt 文件

project(HELLO)
add_subdirectory(src bin)
add_subdirectory(libhello lib)
不是build中的目录默认和源代码中结构一样么，我们可以指定其对应的目录在build中的名字。
这样一来：build/src 就成了 build/bin 了，可是除了 hello.exe，中间产物也进来了。还不是我们最想要的。

另一种方法：不修改顶级的文件，修改其他两个文件

src/CMakeList.txt 文件
include_directories(KaTeX parse error: Expected 'EOF', got '#' at position 32: …DIR}/libhello) #̲link_directorie…{PROJECT_BINARY_DIR}/lib)
set(APP_SRC main.c)
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
add_executable(hello ${APP_SRC})target_link_libraries(hello libhello)
libhello/CMakeList.txt 文件
set(LIB_SRC hello.c)
add_library(libhello ${LIB_SRC})
set(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)
set_target_properties(libhello PROPERTIES OUTPUT_NAME “hello”)
6、在例子三至五中，我们始终用的静态库，那么用动态库应该更酷一点吧。 试着写一下
如果不考虑windows下，这个例子应该是很简单的，只需要在上个例子的 libhello/CMakeList.txt 文件中的
add_library命令中加入一个SHARED参数：

add_library(libhello SHARED ${LIB_SRC})

每次都会提示cmake_minimum_required,版本要求，建议后面还是把它填上。
在顶层CMakeLists.txt中加入
cmake_minimum_required(VERSION 3.5)

多平台兼容
在你想要做成库的.h文件中添加如下的代码：
#ifndef DBZHANG_HELLO_
#define DBZHANG_HELLO_
#if defined _WIN32
#if LIBHELLO_BUILD
#define LIBHELLO_API __declspec(dllexport)
#else
#define LIBHELLO_API _declspec(dllimport)
#endif
#else
#define LIBHELLO_API
#endif
LIBHELLO_API void hello(const char* name);
#endif //DBZHANG_HELLO

并且在.cpp文件的同级cmakelists.txt中
进行如下设置：
set(LIB_SRC hello.c)
add_definitions("-DLIBHELLO_BUILD")
add_library(libhello SHARED ${LIB_SRC})
set(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)
set_target_properties(libhello PROPERTIES OUTPUT_NAME “hello”)