cmake是个很方便的构建系统。官方的文档写的很明白，就是有点长。于是，根据自己的使用情况，挑选其中最重要的，简要说明于下：

CMakeLists.txt的编写

CMakeLists.txt的命令不区分大小写。

基本结构

# 最低版本声明，如果本机的cmake版本小于这个，会告警cmake_minimum_required(VERSION 3.10)# set the project nameproject(Tutorial)# add the executableadd_executable(Tutorial tutorial.cxx)# 生成库# add_library( MyMath STATIC mymath.cpp)

注：add_executable和add_library可以源码列表，源码文件可以在后面通过target_sources添加。因为target_xxx_xxx的命令要求target先定义好，所以这一功能挺重要。

子目录

添加子目录前，需要先为子目录编写CMakeLists.txt。

add_subdirectory( MathFunctions )

依赖库

  • 指定路径
link_directories(Tutorial  "${PROJECT_SOURCE_DIR}/lib" )

注：link_directories只对在它后面声明的target有效。

  • 指定库

target_link_libraries支持多种格式，以libopus.a为例

target_link_libraries(Tutorial opus)target_link_libraries(Tutorial -lopus)target_link_libraries(Tutorial libopus.a)# 全路径target_link_libraries(Tutorial ${PROJECT_SOURCE_DIR}/lib/libopus.a)

如果不是全路径模式，需要先指定路径。
注：target_link_libraries加入的顺序非常重要。比如Tutorial依赖libA.a, libA.a依赖libB.a。那么libA.a需要放在libB.a之前，不然会报错，说libB.a的符号找不到。据说是有一个选项，会尽量去掉没使用的符号。如果先写libB.a，则链接libB.a时发现没有人在使用它，就把它去掉了。不过是啥选项没研究，默认行为，还是注意下顺序吧。

宏定义

target_compile_definitions(foo PUBLIC FOO)target_compile_definitions(foo PUBLIC -DFOO)  # -D removedtarget_compile_definitions(foo PUBLIC "" FOO) # "" ignoredtarget_compile_definitions(foo PUBLIC -D FOO) # -D becomes "", then ignored#定义带值的target_compile_definitions( Tutorial PRIVATE "LOG_LEVEL=2" )

编译选项

add_compile_options(-Wall -Wextra -pedantic -Werror)add_compile_options(-std=c++11 -g)

设置变量

set(LIB_SRC src/mymath.cpp src/myadd.cpp ...)

条件生成

if(WIN32)    xxxelseif(ANDROID)    xxxelseif(IOS)    xxxendif

target的生成地址

set(CMAKE_LIBRARY_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR}) set(CMAKE_ARCHIVE_OUTPUT_DIRECTORY ${PROJECT_SOURCE_DIR})

增加install

#安装target(lib/app)install( TARGETS Tutorial DESTINATION bin)#安装头文件install( FILES ${PROJECT_BINARY_DIR}/config.h DESTINATION include )

有了这个以后，就可以用make install安装了

打印信息

写了CMakeLists.txt，却不能正常工作的时候，你一定想打印一些信息，看看到底是哪儿错了。于是message命令就派上了用场：

message("Build lib OK !")message( "use_mymath:${USE_MYMATH}")

CMake命令

默认情况

cmake 源码目录make

传递参数

-D表示设置变量
-U表示取消变量

cmake -DCMAKE_INSTALL_PREFIX=/opt/the/prefix -UMyPackage_DIR

生成Xcode或者VS项目

#xcode项目cmake ./src -GXcode#VS项目cmake ./src -G"Visual Studio 12 2013"