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)
- 系统信息
- 主要开关选项