Cmake指令手册

Cmake 是 kitware 公司以及一些开源开发者在开发几个工具套件(VTK)的过程中衍生品,最终形成体系,成为一个独立的开放源代码项目。

本文主要记录书写Cmake的大致流程

常见CMakeLists.txt中指令剖析

注意:Cmake的指令是大小写无关的,参数和变量是大小写相关的。

cmake_minimum_required(VERSION 2.6)命令

规定cmake软件的最低版本。这行命令是可选的,可以不写这句话,但在有些情况下,如果CMakeLists.txt文件中使用了一些高版本cmake特有的一些命令时,就需要加上这一行,提醒用户升级到该版本之后再执行cmake。

project(<projectname>)命令

语法:project(projectname [cxx] [c] [java])
可以指定工程采用的语言,选项分别表示:C++, C, java, 如不指定默认支持所有语言。
指定项目的名称,在生成VS项目下即指明了生成的.sln项目的文件名。项目最终编译生成的可执行文件不一定是这个项目名称,而是由另一条命令(add_executable)指定的。

通过project命令,为整个代码项目定义了一个管理架构,这点可以通过在VS下建立项目的结构层次来帮助理解。VS下所有的项目都是在解决方案(.sln文件)下进行管理的,一个解决方案可以包含多个项目。cmake中project命令正是定义了解决方案的名称,add_executableadd_library命令都会生成一个项目,cmake会自动为每个项目(包括生成可执行文件的项目和生成链接库的项目)创建对应的文件夹,存储编译中间文件。

但是这个项目名称还是很必要的,在cmake中有两个预定义的变量:<projectname>_BINARY_DIR<projectname>_SOURCE_DIR ,即一旦使用了project指明了一个项目名称,则同时隐式定义了这两个预定义的变量。在内部编译情况下,这两个变量的含义相同,而在外部编译下,两者指代的内容会有所不同。要理解这两个变量的含义,我们首先需要了解什么是外部构建(out of source build),下面会介绍什么叫外部构建。

同时cmake还预定义了PROJECT_BINARY_DIRPROJECT_SOURCE_DIR变量,其中PROJECT_BINARY_DIR就等同于<projectname>_BINARY_DIR,PROJECT_SOURCE_DIR等同于<projectname>_SOURCE_DIR。因此在实际应用中,强烈推荐使用PROJECT_BINARY_DIRPROJECT_SOURCE_DIR变量,这样即使项目名称发生变化也不会影响CMakeLists.txt文件。

外部构建的含义:
外部构建和内部构建最大的不同在于执行cmake的工作路径不同,在我们使用cmake构建项目时,首先要求指定“Where is the source code”,然后要求指定“Where to build the binaries”。此时如果这两个路径相同的话,cmake生成的所有中间文件和可执行文件都会存放在项目目录(即所谓的根目录)中;而如果我们在项目目录下先新建一个build文件夹,然后将“Where to build the binaries”指定为该build文件夹的路径,此时中间文件和可执行文件都会存放在build目录下。第二种方法的优点显而易见,它最大限度的保持了代码目录的整洁,同时由于第二种方法的生成、编译和安装时发生在不同于项目目录的其他目录中,所以第二种方法就叫做“外部构建”
回到project命令下的问题,在外部构建的情况下,PROJECT_SOURCE_DIR指向 的目录同内部构建一样,仍然是项目目录,而PROJECT_BINARY_DIR则有所不同,指向的是<项目目录>/build目录。cmake强烈推荐使用外部构建的方法。

ADD_SUBDIRECTORY命令

语法: ADD_SUBDIRECTORY(source_dir [binary_dir] [EXCLUDE_FROM_ALL])
该命令告诉CMake去子目录中查看可用的CMakeLists.txt文件
指令用于向当前工程添加存放源文件的子目录,并可以指定中间二进制和目标二进制存放的位置。 EXCLUDE_FROM_ALL 参数的含义是将这个目录从编译过程中排除。比如,工程的 example,可能就需要工程构建完成后,再进入 example 目录单独进行构建。
在我们的项目中,我们添加了src目录到项目中,而把对应于src目录生成的中间文件和目标文件存放到bin目录下,在上一节举例中“外部构建”的情况下,中间文件和目标文件将存放在build/srcobj目录下

ADD_EXECUTABLE命令

告诉工程生成一个可执行文件。该命令定义了工程最终生成的可执行文件的文件名以及参与编译的头文件和cpp文件。
如果想指定生成的可执行文件的存放路径,可以设置cmake中预定义变量EXECUTABLE_OUTPUT_PATH 的值。例如,将生成的可执行文件放置在cmake编译路径的bin文件夹下可用:SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)

ADD_LIBRARY命令

语法:ADD_LIBRARY(libname [SHARED|STATIC]
告诉工程生成一个库文件

FIND_LIBRARY命令

查找库所在目录,语法如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
find_library (
<VAR>
name | NAMES name1 [name2 ...] [NAMES_PER_DIR]
[HINTS path1 [path2 ... ENV var]]
[PATHS path1 [path2 ... ENV var]]
[PATH_SUFFIXES suffix1 [suffix2 ...]]
[DOC "cache documentation string"]
[NO_DEFAULT_PATH]
[NO_CMAKE_ENVIRONMENT_PATH]
[NO_CMAKE_PATH]
[NO_SYSTEM_ENVIRONMENT_PATH]
[NO_CMAKE_SYSTEM_PATH]
[CMAKE_FIND_ROOT_PATH_BOTH |
ONLY_CMAKE_FIND_ROOT_PATH |
NO_CMAKE_FIND_ROOT_PATH]
)
12345678910111213141516

举例:

1
2
FIND_LIBRARY(RUNTIME_LIB rt /usr/lib  /usr/local/lib NO_DEFAULT_PATH)
1

cmake会在目录中查找,如果所有目录中都没有,值RUNTIME_LIB就会被赋为NO_DEFAULT_PATH

SET命令——用于设置变量,相当于为变量取别名

SET(CMAKE_BUILE_TYPE DEBUG) 设置编译类型debug 或者release。 debug 版会生成相关调试信息,可以使用GDB 进行调试;release不会生成调试信息。当无法进行调试时查看此处是否设置为debug.
SET(CMAKE_C_FLAGS_DEBUG “-g -Wall”) 设置编译器的类型
CMAKE_C_FLAGS_DEBUG —- C 编译器
CMAKE_CXX_FLAGS_DEBUG —- C++ 编译器

CMAKE_MODULE_PATH变量——定义cmake模块所在路径

如果你的工程比较复杂,有可能会自己编写一些 cmake 模块(所谓cmake模块指的是在该文件内部定义了一些变量,这些变量指明了一些头文件路径和库文件路径等有用信息)。这些 cmake 模块是随你的工程发布的,为了让 cmake 在处理CMakeLists.txt 时找到这些模块,你需要通过 SET 指令,将自己的 cmake 模块路径设置一下。
比如
SET(CMAKE_MODULE_PATH ${PROJECT_SOURCE_DIR}/cmake)
这时候你就可以通过 INCLUDE 指令来调用自己的模块了

EXECUTABLE_OUTPUT_PATH和LIBRARY_OUTPUT_PATH变量

我们可以通过 SET 指令重新定义 EXECUTABLE_OUTPUT_PATHLIBRARY_OUTPUT_PATH 变量来指定最终的目标二进制的位置(指最终生成的CRNode可执行文件或者最终的共享库,而不包含编译生成的中间文件)。
命令如下:
SET(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin)
SET(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib)
需要注意的是,在哪里 ADD_EXECUTABLEADD_LIBRARY,如果需要改变目标存放路径,就在哪里加入上述的定义。

CMake 基础模板

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
## This is a standard CMakeLists.txt template, including
## how to enable C++11 compiler option and how to set 'Release'
## target compile option

cmake_minimum_required(VERSION 2.8)
project(cmake_template)

############# Use message function to print information ############
message(STATUS "CMake version: ${CMAKE_VERSION}")

############ enable C++11 compiler###############
## Method 1
include(CheckCXXCompilerFlag)
CHECK_CXX_COMPILER_FLAG("-std=c++11" COMPILER_SUPPORTS_CXX11)
CHECK_CXX_COMPILER_FLAG("-std=c++0x" COMPILER_SUPPORTS_CXX0X)
if(COMPILER_SUPPORTS_CXX11)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
elseif(COMPILER_SUPPORTS_CXX0X)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++0x")
else()
message(WARNING "The compiler ${CMAKE_CXX_COMPILER} has no C++11 support.")
message(STATUS "Please use a different C++ compiler.")
endif()
## Method 2
set(CMAKE_CXX_STANDARD 11)


############ #enable warnings##################
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fPIC -Wall")


#############Set cmake compiler options##############
## Method 1
set(CMAKE_BUILD_TYPE "Release")

## Method 2
IF(NOT CMAKE_BUILD_TYPE)
SET(CMAKE_BUILD_TYPE RelWithDebInfo CACHE STRING
"Choose the type of build, options are: None Debug Release RelWithDebInfo MinSizeRel."
FORCE)
ENDIF(NOT CMAKE_BUILD_TYPE)

################## Some useful arguments ##########################
set(CMAKE_INCLUDE_CURRENT_DIR ON)

##########
##Build###
##########
add_library(lib hello.cpp)

add_executable(main main.cpp)
target_link_libraries(main ${LINK_LIBRARIES})

常用变量列表

变量名 含义
PROJECT_NAME project命令中写的项目名
CMAKE_VERSION 当前使用CMake的版本
CMAKE_SOURCE_DIR 工程顶层目录,即入口CMakeLists文件所在路径
PROJECT_SOURCE_DIR CMAKE_SOURCE_DIR
CMAKE_BINARY_DIR 工程编译发生的目录,即执行cmake命令进行项目配置的目录,一般为build
PROJECT_BINARY_DIR CMAKE_BINARY_DIR
CMAKE_CURRENT_SOURCE_DIR 当前处理的CMakeLists.txt所在的路径
CMAKE_CURRRENT_BINARY_DIR 当前处理的CMakeLists.txt中生成目标文件所在编译目录
CMAKE_CURRENT_LIST_FILE 输出调用这个变量的CMakeLists.txt文件的完整路径
CMAKE_CURRENT_LIST_DIR 当前处理的CMakeLists.txt文件所在目录的路径
CMAKE_INSTALL_PREFIX 指定make install命令执行时包安装路径
CMAKE_MODULE_PATH find_package命令搜索包路径之一,默认为空

编译配置相关变量:

变量名 含义
CMAKE_BUILD_TYPE 编译选项,Release或者Debug,如set(CMAKE_BUILD_TYPE "Release")
CMAKE_CXX_FLAGS 编译标志,设置C++11编译,set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11")
CMAKE_CXX_STANDARD 也可以设置C++11编译,set(CMAKE_CXX_STANDARD 11)
打赏
  • 版权声明: 本博客所有文章除特别声明外,均采用 Apache License 2.0 许可协议。转载请注明出处!
  • © 2019-2022 guoben
  • PV: UV:

微信