Cmake使用心得
Welcome to my personal blog: www.freehacker.cn
CMake是一个跨平台的安装(编译)工具，可以用简单的语句来描述所有平台的安装(编译过程)。他能够输出各种各样的makefile或者project文件,能测试编译器所支持的C++特性，类似UNIX下的automake。
CMake 使用方法
CMake的所有的语句都写在一个叫:CMakeLists.txt 的文件中。当CMakeLists.txt文件确定后，可以用ccmake命令对相关 的变量值进行配置。这个命令必须指向CMakeLists.txt所在的目录。配置完成之后，应用cmake命令生成相应的makefile（在Unix like系统下）或者 project文件（指定用window下的相应编程工具编译时）。需要为任何子目录建立一个CMakeLists.txt。
其基本操作流程为：
ccmake directory
cmake directory
cmake -DCMAKE_BUILD_TYPE=Debug/Release directory
make其中，directory为CMakeLists.txt所在目录，Makefile等文件的生成目录为cmake执行目录：
- 第一条语句用于配置编译选项，如VTK_DIR目录，一般这一步不需要配置，直接执行第二条语句即可，但当出现错误时，这里就需要认为配置了，这一步才真正派上用场；
- 第二条命令用于根据CMakeLists.txt生成Makefile文件；
- 三条命令用于执行Makefile文件，编译程序，生成可执行文件。
注：为了方便描述，下面的文件目录按照以下规则：
工程顶层目录：/cmake
in source编译下：工程编译发生目录为/cmake
out of source编译下：工程编译目录为/cmake/build
源文件所在目录为：/cmake/src
二进制文件目录：/cmake/build/binCmake目录规则
|----build/builds
| |----cmake
| |----mingw32
| |----msvc
| |----redhat
| |----valgrind
| |----zos
|----common
|----config
|----debug
|----doc
|----include
|----release
|----src
|----tests
|----tools
|----utils
|--- AUTHORS
|--- autogen.bat/sh
|--- CMakeLists.txt
|--- COPYING
|--- INSTALL
|--- MAINTAINERS
|--- NEWS
|--- README.mdCMake常用变量和环境变量
工程顶层目录/cmake
CMAKE_SOURCE_DIR
PROJECT_SOURCE_DIR
_SOURCE_DIR
// 以下环境变量在in source编译情况下为工程顶层目录
CMAKE_BINARY_DIR
PROJECT_BINARY_DIR
_BINARY_DIR 工程构建目录/cmake/build
//out of source编译情况下
CMAKE_BINARY_DIR
PROJECT_BINARY_DIR
_BINARY_DIR 与当前Cmake或二进制相关
CMAKE_CURRENT_SOURCE_DIR //当前处理的 CMakeLists.txt 所在的路径。例如源文件所在目录/cmake/src
//如果是in source编译，就是工程顶层目录/cmake
//如果是out of source编译，就是target编译目录（/cmake/build/bin），可以使用ADD_SUBDIRECTORY(src bin)来更改这个值。
CMAKE_CURRRENT_BINARY_DIR输出相关
EXECUTABLE_OUTPUT_PATH
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
LIBRARY_OUTPUT_PATH
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)- EXECUTABLE_OUTPUT_PATH表示最终的目标二进制的位置；
- LIBRARY_OUTPUT_PATH表示最终的共享库。
- 在哪里ADD_EXECUTABLE或ADD_LIBRARY，如果需要改变目标存放路径，就在哪里加入上述的定义。
PROJECT_BINARY_DIR和PROJECT_SOURCE_DIR
PROJECT_SOURCE_DIR为工程所在目录；PROJECT_BINARY_DIR为编译发生的当前目录，也就是make的执行目录。
CMake指令
CMAKE_MINIMUM_REQUIRED
CMAKE_MINIMUM_REQUIRED(VERSION 2.8)option指令
PROJECT指令
PROJECT(projectname [CXX] [C] [Java])
示例：PROJECT (HELLO CXX)用来定义工程名称，并可指定工程支持的语言，支持的语言列表是可以忽略的，默认情况表示支持所有语言。
这个指令隐式的定义了两个cmake变量：
SET指令
SET(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])
示例：SET(SRC_LIST main.cpp t1.cpp t2.cpp)MESSAGE指令
MESSAGE([SEND_ERROR | STATUS | FATAL_ERROR] "message to display"...)
示例：MESSAGE(STATUS "This is BINARY dir " ${HELLO_BINARY_DIR})用于向终端输出用户定义的信息，包含三种类型：
- SEND_ERROR，产生错误，生成过程被跳过。
- SATUS，输出前缀为—的信息。
- FATAL_ERROR，立即终止所有 cmake 过程.。
ADD_EXECUTABLE指令
ADD_EXECUTABLE(demo ${SRC_LIST})
ADD_EXECUTABLE(demo main.cpp t1.cpp t2.cpp)定义了这个工程会生成一个名为demo的可执行文件，相关的源文件是SRC_LIST中定义的源文件列表。
ADD_LIBRARY指令
ADD_LIBRARY(libname [SHARED|STATIC|MODULE][EXCLUDE_FROM_ALL] source1 source2 ... sourceN)- SHARED：动态库
- STATIC：静态库
- MODULE：在使用dyld的系统有效，如果不支持dyld，则被当做SHARED对待
- EXCLUDE_FROM_ALL 参数的意思是这个库不会被默认构建，除非有其他的组件依赖或者手工构建。
SET_TARGET_PROPERTIES指令
SET_TARGET_PROPERTIES(target1 target2 ...PROPERTIES prop1 value1prop2 value2 ...)用来设置输出的名称，对于动态库，还可以用来指定动态库版本和 API 版本。
INSTALL指令
INSTALL(TARGETS myrun mylib mystaticlib
RUNTIME DESTINATION bin
LIBRARY DESTINATION lib
ARCHIVE DESTINATION libstatic
)- 可执行二进制myrun安装到${CMAKE_INSTALL_PREFIX}/bin目录
- 动态库libmylib安装到${CMAKE_INSTALL_PREFIX}/lib目录
- 静态库libmystaticlib安装到${CMAKE_INSTALL_PREFIX}/libstatic目录
CMake使用
自定义Makefile目标
运行下面的代码，会先创建一个./debug目录，然后拷贝file.dll到./debug目录。
add_custom_command(
OUTPUT ./debug/file.dll
COMMAND mkdir -p ./debug
cp ./file.dll ./debug
DEPENDS ./file.dll
)
add_custom_target(dlltest DEPENDS ./debug/file.dll)
add_executable(demo ${SRC_LIST})
add_dependencies(demo dlltest )