CMake基本常识

不清楚，为什么很多越来越多的软件都用CMake去编译。CMake就是一个大奇葩，这么难用的东西，居然越来越火了!!真心感觉Makefile比CMake容易看懂的多。

下面是对CMake一些总结，后续在一点点补充。我们可以通过命令 cmake --help-command XXX 查看离线帮助文档。

一、内置变量

CMake比较难学主要原因之一是有很多内置变量，在阅读CMakeLists.txt时遇到：这个变量在哪里定义的？傻傻分不清楚，这里把一些常用内置变量罗列出来：

变量	含义
CMAKE_INSTALL_PREFIX	指定安装目录。一般作为cmake命令行参数
CMAKE_SOURCE_DIR	CMakeLists.txt所在目录
CMAKE_CURRENT_SOURCE_DIR	当前正在处理CMakeLists.txt所在目录
PROJECT_SOURCE_DIR	代码根目录
PROJECT_BINARY_DIR	执行cmake命令所在目录。一般是创建build目录并且进入该目录，执行cmake命令
CMAKE_INCLUDE_PATH	头文件所在目录
CMAKE_LIBRARY_PATH	lib库所在目录
CMAKE_BUIlD_TYPE	编译类型，例如Debug、Release。例如-DCMAKE_BUIlD_TYPE=Debug
CMAKE_C_FLAGS / CMAKE_CXX_FLAGS	针对C/C++编译参数，例如：-g -O3
CMAKE_CXX_FLAGS_RELEASE	令人发指的默认参数。参数默认值为-O3 -NDEBUG，有些时候我不需要优化，因此需要关闭。  cmake -DCMAKE_CXX_FLAGS_RELEASE= -DXXX
CMAKE_C_COMPILER / CMAKE_CXX_COMPILER	指定c/c++编译器路径，例如： set(CMAKE_C_COMPILER "/usr/local/gcc") 或 -DCMAKE_C_COMPILER=/usr/local/gcc
CMAKE_VERBOSE_MAKEFILE	set(CMAKE_VERBOSE_MAKEFILE ON)  开启详细打印

二、内置函数

CMake提供了很多内置函数，因此增加了我们学习成本。同样将常用的内置函数以及用法在这里进行罗列

2.1 set函数

set用于声明变量，然后对于CMake来说有三种变量：Normal变量，Cache变量以及环境变量。

类型	格式	举例说明
Normal	set(<variable> <value>... [PARENT_SCOPE])	set(CMAKE_CXX_FLAGS "-Wall std=c++11") set(SOURCE_FILES main.cpp test.cpp) value可以有多个 PARENT_SCOPE：该参数表示影响的变量为父级中变量，本级不影响 这种场景使用最多
Cache	set(<variable> <value>... CACHE <type> <docstring> [FORCE])	创建缓存变量，不常用
Environment	set(ENV{<variable>} [<value>])	修改环境变量的值，注意不影响系统环境环境变量。后续使用，$ENV{<variable>}

如果set只有变量名，没有value表示取消变量定义，类似unset操作。

2.2 add_definitions函数

add_definitions用于添加编译参数

	举例说明
add_definitions(<value>...)	add_definitions(-DDEBUG -g -O3) add_definitions( “-Wall -ansi –pedantic –g”)

但是该函数已经被替换为：

This command has been superseded by alternatives:
* Use ``add_compile_definitions()`` to add preprocessor definitions.
* Use ``include_directories()`` to add include directories.
* Use ``add_compile_options()`` to add other options.

2.3 include_directories / link_directories函数

用于指定头文件和库文件搜索目录，默认添加方式为追加

	举例说明
include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])	link_directories (/home/include /home/cpp/include)   相当于gcc -I AFTER|BERORE 表增加路径放在原有路径列表什么位置，默认以追加方式放在后面 SYSTEM 表示系统目录
link_directories(directory1 directory2 ...)	link_directories (/home/libs /home/cpp/libs)   相当于gcc -L

2.4 add_library函数

用于创建一个库文件

add_library(<name> [STATIC | SHARED | MODULE]              [EXCLUDE_FROM_ALL]              [source1] [source2 ...])	add_library(hello STATIC src/hello.c) 表示创建一个libhello.a静态库 STATIC -- 静态库   SHARED -- 动态库 MODULE -- 很少用到  EXCLUDE_FROM_ALL -- 很少用到 source1 源文件，可以包含多个

add_library还有其他的形式，可执行cmake --help-command add_library命令进行查看

三、动态库

LD_LIBRARY_PATH

LD_PRELOAD

LD_DEBUG

动态库查找路径：LD_LIBRARY_PATH，/etc/ld.so.cache，/usr/lib，/lib

可以通过设置LD_LIBRARY_PATH，运行某个可执行文件，例如：

$ LD_LIBRARY_PATH=/home/user /bin/ls

四、其他

可以在执行configure命令前面增加环境变量

CFLAGS="$CFLAGS -g -O0" ./configure --sysconfdir=/etc --localstatedir=/var         --enable-opaque-hierarchy="name=systemd"