@lniwn 2017-11-22T03:36:34.000000Z 字数 2269 阅读 1652

CMake学习笔记

C++ CMake

基本文件结构

编写CMakeLists.txt

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息
project (Demo1)
# 指定生成目标
add_executable(Demo main.cc)

常用命令

项目类型命令

add_executable可执行文件
add_library 静态库

文件依赖命令

aux_source_directory(<dir> <variable>)
查找指定目录下的所有源文件，然后将结果保存进指定的变量名。

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息
project (Demo2)
# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_SRCS 变量
aux_source_directory(. DIR_SRCS)
# 指定生成目标
add_executable(Demo ${DIR_SRCS})

这样，CMake 会将当前目录所有源文件的文件名赋值给变量DIR_SRCS，再指示变量DIR_SRCS 中的源文件需要编译成一个名称为 Demo 的可执行文件。

add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
添加子文件夹到构建系统中。
source_dir子文件夹路径
binary_dir 输出路径
EXCLUDE_FROM_ALL 从Build All项目中排除

编译选项命令

Visual Studio to CMake Mapping

ZERO_CHECK will rerun cmake. You can/should execute this after changing something on your CMake files.
ALL_BUILD is simply a target which builds all and everything project in the active solution, I guess one can compare it to "make all".
可以通过set(CMAKE_SUPPRESS_REGENERATION true)不生成ZERO_CHECK工程。

链接命令

target_link_libraries指明链接库
target_link_libraries(<target> [lib1 [lib2 [...]]] [[debug|optimized|general] <lib>] ...)
general可选字段，表示所有模式都链接的库
debug表示debug模式才链接的库
optimized表示非debug模式才链接的库

target_link_libraries(${PROJECT_NAME} 
    delayimp.lib libcef.lib 
    debug cef_module_d.lib 
    debug libcef_dll_wrapper_d.lib 
    optimized cef_module.lib 
    optimized libcef_dll_wrapper.lib)

项目实例

自定义编译选项
顶层CMakeLists.txt文件

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)
# 项目信息
project (Demo4)
# 加入一个配置头文件，用于处理 CMake 对源码的设置
configure_file (
  "${PROJECT_SOURCE_DIR}/config.h.in"
  "${PROJECT_BINARY_DIR}/config.h"
  )
# 是否使用自己的 MathFunctions 库
option (USE_MYMATH
       "Use provided math implementation" ON)
# 是否加入 MathFunctions 库
if (USE_MYMATH)
  include_directories ("${PROJECT_SOURCE_DIR}/math")
  add_subdirectory (math)  
  set (EXTRA_LIBS ${EXTRA_LIBS} MathFunctions)
endif (USE_MYMATH)
# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_SRCS 变量
aux_source_directory(. DIR_SRCS)
# 指定生成目标
add_executable(Demo ${DIR_SRCS})
target_link_libraries (Demo  ${EXTRA_LIBS})

编写config.h.in文件
#cmakedefine USE_MYMATH

设置编译模式

set(CMAKE_BUILD_TYPE "Debug")
set(CMAKE_CXX_FLAGS_DEBUG "$ENV{CXXFLAGS} -O0 -Wall -g -ggdb")
set(CMAKE_CXX_FLAGS_RELEASE "$ENV{CXXFLAGS} -O3 -Wall")

环境检查
首先在顶层 CMakeLists 文件中添加 CheckFunctionExists.cmake 宏，并调用 check_function_exists 命令测试链接器是否能够在链接阶段找到 pow 函数。

# 检查系统是否支持 pow 函数
include (${CMAKE_ROOT}/Modules/CheckFunctionExists.cmake)
check_function_exists (pow HAVE_POW)