cmake 学习笔记

时间:2022-05-30 07:26:30

最近接触到一些工程上的代码,都是用cmake来编译的,每次看着CMakeLists.txt 就各种懵逼,决定从0 开始学习

1 set

?
1
2
set(var hello)
message(${var})

输出

hello

其实并不是单单输出hello,还有很多其他信息,会生成很多文件

files

2 CMAKE_C(XX)_FLAGS

变量 CMAKE_C_FLAGS 存放的内容会被传给 C 编译器,作用在所有的编译组态上。如果希望只针对特定一种组态有效,可以设定 CMAKE_C_FLAGS_<编译组态>,例如 CMAKE_C_FLAGS_RELEASE、CMAKE_C_FLAGS_DEBUG。
set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS}     -Wall -O3 -march=native -Wno-reorder")
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -Wall -O3 -march=native -Wno-reorder")

编译选项为-Wall O3的优化

其他内部变量:

•CMAKE_C_COMPILER:指定C编译器
•CMAKE_CXX_COMPILER:
•CMAKE_C_FLAGS:编译C文件时的选项,如-g;也可以通过add_definitions添加编译选项
•EXECUTABLE_OUTPUT_PATH:可执行文件的存放路径
•LIBRARY_OUTPUT_PATH:库文件路径
•CMAKE_BUILD_TYPE::build 类型(Debug, Release, ...),
•CMAKE_BUILD_TYPE=Debug
•BUILD_SHARED_LIBS:Switch between shared and static libraries

内置变量的使用:

•在CMakeLists.txt中指定,使用set
•cmake命令中使用,如cmake -DBUILD_SHARED_LIBS=OFF

3 CHECK_CXX_COMPILER_FLAG

检查CXX编译器是否支持给定的flag
必须先include(CheckCXXCompilerFlag)
include(CheckCXXCompilerFlag)
CHECK_CXX_COMPILER_FLAG(<flag> <var>)
e.g.

?
1
2
3
4
5
6
7
8
9
10
11
12
13
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")
  add_definitions(-DCOMPILEDWITHC11)
  message(STATUS "Using flag -std=c++11.")
elseif(COMPILER_SUPPORTS_CXX0X)
  set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++0x")
  add_definitions(-DCOMPILEDWITHC0X)
  message(STATUS "Using flag -std=c++0x.")
else()
  message(FATAL_ERROR "The compiler ${CMAKE_CXX_COMPILER} has no C++11 support. Please use a different C++ compiler.")
endif()

上面的代码很直接
就是在检查当前编译器是否支持c++11
CHECK_CXX_COMPILER_FLAG 赋值给的var是个bool型

4 add_definitions

添加编译参数
add_definitions(-DDEBUG)

将在gcc命令行添加DEBUG 宏定义 ,那么你就可以在你的源文件里面对DEBUG宏来操作

5 ENV

语法:
  $ENV(VAR)# 读取环境变量 VAR,也可用set对其赋值
eg:
IF(DEFINED ENV{ARM_ARCHITECTURE})#如果是arm的机器

6 list

List 操作

?
1
2
3
4
5
6
7
8
9
10
11
list(LENGTH <list> <output variable>)
list(GET <list> <element index> [<element index> ...]
   <output variable>)
list(APPEND <list> [<element> ...])
list(FIND <list> <value> <output variable>)
list(INSERT <list> <element_index> <element> [<element> ...])
list(REMOVE_ITEM <list> <value> [<value> ...])
list(REMOVE_AT <list> <index> [<index> ...])
list(REMOVE_DUPLICATES <list>)
list(REVERSE <list>)
list(SORT <list>)

APPEND 追加元素,懂了吧,这些都是list的操作

7 CMAKE_MODULE_PATH

cmake 进行搜索的modules的list, 它是一个list

8 find_package

这个有点复杂,还是直接看官方文档
还有这个

9 include_directories

增加头文件的搜索路径,相当于指定gcc的-I参数
include_directories([AFTER|BEFORE] [SYSTEM] dir1 [dir2 ...])

10 add_library

add_library(<name> [STATIC | SHARED | MODULE]
            [EXCLUDE_FROM_ALL]
            source1 [source2 ...])

增加库的目录

11 target_link_libraries

target_link_libraries(<target> [item1 [item2 [...]]]
                      [[debug|optimized|general] <item>] ...)

指令 target_link_libraries()用于指定 target 所需要链接的库,还可以有不同的选项。
e.g.

?
1
2
3
4
target_link_libraries(myapp
  debug -labc
  optimized -lxyz
  )

myapp 在 debug build 时会链接 libabc.a,在 release build 时会链接 libxyz.a,他们的目录被add_library命令添加进去了

12 add_executable

增加可执行文件(从源文件)
add_executable(<name> [WIN32] [MACOSX_BUNDLE]
               [EXCLUDE_FROM_ALL]
               source1 [source2 ...])

e.g.

?
1
2
add_executable(stereo_euroc Examples/Stereo/stereo_euroc.cc)
target_link_libraries(stereo_euroc ${PROJECT_NAME})

stereo_euroc 是要生成的可执行文件,源码是后面的.cc文件,链接后面的库

原文链接:http://www.jianshu.com/p/e9b1e9e833b2