CMake常用操作

指令

• cmake_minimum_required - 指定CMake的最小版本要求。

# 语法：cmake_minimum_required(VERSION versionNumber [FATAL_ERROR])
cmake_minimum_required(VERSION 2.8.3)  #CMake最小版本要求为2.8.3

• project - 定义工程名称，并可指定工程支持的语言

#语法：project(projectname [CXX] [C] [Java])
project(HELLOWORLD） #指定工程名为HELLOWORLD

• set - 显式的定义变量

#语法：set(VAR [VALUE] [CACHE TYPE DOCSTRING [FORCE]])
set(SRC sayhello.cpp hello.cpp) #定义SRC变量，其值为sayhello.cpp hello.cpp

• include_dircetories - 向工程添加多个特定的头文件搜索路径

#语法：include_directories([AFTER|BEFORE] [SYSTEM] dir1 dir2 ...)
#将/usr/include/myincludefolder 和 ./include 添加到头文件搜索路径
include_directories(/usr/include/myincludefolder  ./include)

• link_directories -向工程添加多个特定的库文件搜索路径

#语法：link_directories(dir1 dir2 ...)
#将/usr/lib/mylibfolder 和 ./lib 添加到库文件搜索路径
link_directories(/usr/lib/mylibfolder  ./lib)

• add_library - 生成库文件

#语法：add_library(libname [SHARED|STATIC|MODULE] [EXCLUDE_FROM_ALL] source1 source2...)
#通过变量SRC生成libhello.so共享库
add_library(hello SHARED ${SRC})

• add_compile_options - 添加编译参数

#语法：add_compile_options(<option> ...)
# 添加编译参数 -Wall  -std=c++11
add_compile_options(-Wall -std=c++11 -o2)

• add_executable - 生成可执行文件

#语法：add_executable(exename source1 source2 ...)
#编译main.cpp生成可执行文件main
add_executable(main main.cpp)

• target_link_libraries - 为target添加需要链接的共享库

#语法：target_link_libraries(target library1<debug | optimized> library2...)
#将hello动态库文件链接到可执行文件main
target_link_libraries(main hello)

• add_subdirectory - 向当前工程添加存放源文件的子目录，并可以指定中间二进制和目标二进制存放的位置

语法：add_subdirectory(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
#添加src子目录，src中需要有一个CMakeLists.txt
add_subdirectory(src)

• aux_source_directory - 发现一个目录下所有的源代码文件并将列表存储再 一个变量中，这个指令临时被用来自动构建源文件列表。

#语法：aux_source_directory(dir VARIABLE)
#定义SRC变量，其值为当前目录下所有的源文件代码
aux_source_directory(. SRC)
#编译SRC变量所代表的源代码文件，生成main可执行文件
add_executable(main ${SRC})

变量

• CMAKE_C_FLAGS : gcc编译选项
• CMAKE_CXX_FLAGS ：g++编译选项

# 在CMAKE_CXX_FLAGS编译选项后追加-std=c++11
set( CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS}  -std=c++11")

• CMAKE_BUILD_TYPE ：编译类型(Debug, Release)

#设定编译类型为debug,调试时需要选择debug
set(CMAKE_BUILD_TYPE Debug)
#设定编译类型为release,发布时需要选择release
set(CMAKE_BUILD_TYPE Release)

• CMAKE_C_COMPILER : 指定C编译器
• CMAKE_CXX_COMPILER ：指定C++编译器
• EXECUTABLE_OUTPUT_PATH ：可执行文件输出的存放路径
• LIBRARY_OUTPUT_PATH ：库文件输出的存放路径