Ubuntu CMake start

参考：http://www.noobyard.com/article/p-dlmfadds-eb.html
初识CMake
CMake是开源、跨平台的构建工具，可经过编写简单的配置文件去生成本地的Makefile，这个配置文件是独立于运行平台和编译器的，这样就不用亲自去编写Makefile了，并且配置文件能够直接拿到其它平台上使用，无需修改，很是方便。

一、安装CMake

ubuntu18.04，安装cmake使用以下命令：

sudo apt install cmake

查看版本：

cmake -version

二、快速开始

在同级目录下准备main.c和CMakeLists.txt两个文件

main.c内容如下：

#include <stdio.h>

int main(void)
{
	printf("Hello World\n");

	return 0;
}

CMakeLists.txt内容如下：

cmake_minimum_required (VERSION 2.8)

project (demo)

add_executable(main main.c)

命令说明：
cmake_minimum_required (VERSION 2.8)：cmake最低版本要求；
project (demo)：工程名设为“demo”，可根据需要取名；
add_executable(main main.c)：生成名为main的ELF (Executable and Linkable Format)文件，使用的源文件是main.c。

构建工程：
在终端下切到main.c所在的目录下，而后输入如下命令运行cmake:

cmake .

再来看看目录下的文件:

能够看到成功生成了Makefile，还有一些cmake运行时自动生成的文件。
编译
而后在终端下输入make并回车，

运行
能够看到elf文件main也成功生成了，而后运行main，

三、一般工程

一般工程通常会把源文件放到src目录下，把头文件放入到include文件下，生成的对象文件放入到build目录下，最终输出的ELF文件会放到bin目录下。工程目录结构如下：

最外层的CMakeLists.txt内容如下：

cmake_minimum_required (VERSION 2.8)

project (demo)

add_subdirectory (src)

命令说明：
add_subdirectory (src)：向当前工程添加存放源文件的子目录

include/testFunc1.h内容：

/* ** testFunc1.h */

#ifndef _TEST_FUNC1_H_
#define _TEST_FUNC1_H_

void func1(int data);

#endif

include/testFunc.h内容：

/* ** testFunc.h */

#ifndef _TEST_FUNC_H_
#define _TEST_FUNC_H_

void func(int data);

#endif

src/CMakeLists.txt内容如下：

aux_source_directory (. SRC_LIST)

include_directories (../include)

add_executable (main ${SRC_LIST})

set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

命令说明：
aux_source_directory (. SRC_LIST)：aux_source_directory把当前目录下的源文件存列表存放到变量SRC_LIST里，而后在add_executable里调用SRC_LIST；
include_directories (…/include)：向工程添加多个指定头文件的搜索路径，路径之间用空格分隔；
set：用于定义变量，EXECUTABLE_OUT_PATH和PROJECT_SOURCE_DIR是CMake自带的预约义变量，其意义以下：
EXECUTABLE_OUTPUT_PATH ：目标二进制可执行文件的存放位置
PROJECT_SOURCE_DIR：工程的根目录
因此，这里set的意思是把存放elf文件的位置设置为工程根目录下的bin目录。

构建工程：
此次先让咱们切到build目录下，而后输入如下命令：

cmake ..

Makefile会在build目录下生成
编译
在build目录下运行make，

到bin目录下，发现main已经生成，

运行
在bin目录下运行main，

说明
cmake运行时生成的附带文件就会跟源码文件混在一块儿，这样会对程序的目录结构形成污染，而在build目录下运行cmake，生成的附带文件就只会待在build目录下，若不想要这些文件了就能够直接清空build目录，很方便。

四、动/静态库编译与连接

建立如下的目录结构，testFunc.c和testFunc.h和上述例子相同，lib中存放生成的动/静态库，lib_testFunc中存放库文件：

最外层的CMakeLists.txt内容如下：

cmake_minimum_required (VERSION 2.8)

project (demo)

add_subdirectory (lib_testFunc)

add_subdirectory (src)

lib_testFunc/CMakeLists.txt内容如下：

aux_source_directory (. SRC_LIST)

add_library (testFunc_shared SHARED ${SRC_LIST})
add_library (testFunc_static STATIC ${SRC_LIST})

set_target_properties (testFunc_shared PROPERTIES OUTPUT_NAME "testFunc")
set_target_properties (testFunc_static PROPERTIES OUTPUT_NAME "testFunc")

set (LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/lib)

命令说明：
add_library: 生成动态库或静态库(第1个参数指定库的名字；第2个参数决定是动态仍是静态，若是没有就默认静态；第3个参数指定生成库的源文件)；
set_target_properties: 设置输出的名称，还有其它功能，如设置库的版本号等等；
LIBRARY_OUTPUT_PATH: 库文件的默认输出路径，这里设置为工程目录下的lib目录；

src/CMakeLists.txt内容如下：

aux_source_directory (. SRC_LIST)

# find testFunc.h
include_directories (../lib_testFunc)

link_directories (${PROJECT_SOURCE_DIR}/lib)

add_executable (main ${SRC_LIST})

target_link_libraries (main testFunc)

set (EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR}/bin)

命令说明：
link_directories: 添加非标准的共享库搜索路径；
target_link_libraries: 把目标文件与库文件进行连接；

cd到build目录下，而后运行cmake …，成功后再运行make，


生成动/静态库

生成名称为main的elf文件

运行

注意：
在lib目录下有testFunc的静态库和动态库，target_link_libraries (main testFunc)默认是使用动态库，若是lib目录下只有静态库，那么这种写法就会去连接静态库。也能够直接指定使用动态库仍是静态库，写法是：target_link_libraries (main libtestFunc.so)或target_link_libraries (main libtestFunc.a)

ps： 查看elf文件使用了哪些库，可使用readelf -d ./xx来查看