cmake的使用

cmake

cmake使用场景

cmake是一款开源的、跨平台的、集构建、测试、打包于一体的系列工具，在不同的平台（如windows、linux）和编译环境下（如gcc、msc）的Makefile文件是不同的，而cmake可以使用简单的配置文件来生成相应的Makefile文件。

 cmake常用选项

• 指定cmake最小版本

cmake_minimum_required(VERSION 3.4.1)

• 设置项目名称

project(demo)

• 在构建中添加子目录

add_subdirectory(source_dir binary_dir) #source_dir指定源CMakeLists.txt和代码文件所在的目录,binary_dir指定放置输出文件的目录

• 设置编译类型

add_executable(demo demo.c) #生成可执行文件
add_library(common STATIC common.c) #生成静态库
add_library(common SHARED common.c) #生成动态库

add_library 默认生成是静态库，通过以上命令生成文件名字，
　　在 Linux 下是：
　　　　demo
　　　　libcommon.a
　　　　libcommon.so
　　在 Windows 下是：
　　　　demo.exe
　　　　common.lib
　　　　common.dll

• 指定编译包含的源文件

add_library(demo demo.c common.c)
aux_source_directory(dir VAR) #发现一个目录下所有的源代码文件并将列表存储在一个变量中
add_library(demo ${SRC_LIST})
　　#以下两种写法等价：
　　　　file(GLOB SRC_LIST "*.c")
　　　　add_library(demo ${SRC_LIST} ${SRC_COMMON_LIST})
　　　　add_library(demo ${SRC_LIST} ${SRC_COMMON_LIST})

　　　　aux_source_directory(. SRC_LIST)
　　　　aux_source_directory(common SRC_COMMON_LIST)
　　　　add_library(demo ${SRC_LIST} ${SRC_COMMON_LIST})

• 查找指定的库文件

find_library(VAR name path)#查找到指定的预编译库，并将它的路径存储在变量中
#类似的命令还有 find_file()、find_path()、find_program()、find_package()

• 设置包含的目录

include_directories(
${CMAKE_CURRENT_SOURCE_DIR}
${CMAKE_CURRENT_BINARY_DIR}
${CMAKE_CURRENT_SOURCE_DIR}/include

• 设置链接库搜索目录

link_directories(
${CMAKE_CURRENT_SOURCE_DIR}/libs

• 设置 target需要链接的库

target_link_libraries( demo #目标库
${common-lib} #目标库需要链接的库)

• 指定链接动态库或静态库

target_link_libraries(demo libface.a) # 链接libface.a
target_link_libraries(demo libface.so) # 链接libface.so

• 指定全路径

target_link_libraries(demo ${CMAKE_CURRENT_SOURCE_DIR}/lib/libface.a)
target_link_libraries(demo ${CMAKE_CURRENT_SOURCE_DIR}/lib/libface.so)

• 指定链接多个库

target_link_libraries(demo
　　　　　　　　　　　　　${CMAKE_CURRENT_SOURCE_DIR}/libs/libface.a
　　　　　　　　　　　　　boost_system.a
　　　　　　　　　　　　　boost_thread
　　　　　　　　　　　　　pthread)

• set 直接设置变量的值

set(SRC_LIST main.cpp test.cpp)
add_executable(demo ${SRC_LIST})

• set 追加设置变量的值

set(SRC_LIST main.cpp)
set(SRC_LIST ${SRC_LIST} test.cpp)
add_executable(demo ${SRC_LIST})

• list 追加或者删除变量的值

set(SRC_LIST main.cpp)
list(APPEND SRC_LIST test.cpp)
list(REMOVE_ITEM SRC_LIST main.cpp)
add_executable(demo ${SRC_LIST})

• 包含其他cmake文件

include(./common.cmake) # 指定包含文件的全路径
include(def) # 在搜索路径中搜索def.cmake文件
set(CMAKE_MODULE_PATH ${CMAKE_CURRENT_SOURCE_DIR}/cmake) # 设置include的搜索路径

• 预定义变量

• 使用环境变量

$ENV{name}

• 设置环境变量

set(ENV{name} value)

• 系统信息

 

• 主要开关选项