一:CMakeLists.txt文件是cmake用来生成Makefile文件需要的一个描述编译链接的规则文件
学习cmake需要提前了解gcc等编译命令,先来解释一条最简单的命令
gcc ./source/*.c -o ./bin/test -I ./include -L ./lib/ -l动态库名
上述命令的解释为:用gcc工具编译当前目录下source文件夹中的所有的.c文件 生成目标为test的可执行文件且将其放在当前目录下的bin文件夹中,其所用到的头文件所在路径为当前目录下的include文件夹,动态库文件路径为当前目录下的lib文件夹,编译时需要用到的动态库为库名所对应的.so动态库
二:CMakeList.txt规则文件常用变量
(1)常用变量
PROJECT_NAME:用函数project(demo)指定的项目名称,这里变量的值为demo
PROJECT_SOURCE_DIR:工程的根目录
PROJECT_BINARY_DIR:执行cmake命令的目录,如果mkdir build ,cd build, cmake ../,的话,该变量的值为build目录
CMAKE_CURRENT_SOURCE_DIR:当前处理的CMakeLists.txt文件所在目录
CMAKE_CURRENT_BINARY_DIR:cmake当前正在处理的二进制目录
CMAKE_CURRENT_LIST_DIR:CMakeLists.txt的完整路径
CMAKE_CURRENT_LIST_LINE:当前所在行
CMAKE_C_FLAGS:设置C编译选项
CMAKE_CXX_FLAGS:设置C++编译选项
CMAKE_INSTALL_PREFIX:指定install指令安装文件的根目录
EXECUTABLE_OUTPUT_PATH:生成目标可执行文件的输出位置
LIBRARY_OUTPUT_PATH:库文件输出位置
三:指令详解
需要注意的是CMakeLists.txt文件中的指令不区分大小写
(1)PROJECT(projectname [CXX] [C] [Java]):
该函数定义工程名字,并指定了工程的语言,支持语言的列表可以省略,默认情况下表示支持所有语言,并隐式定义了两个cmake的变量
PROJECT_BINARY_DIR:执行cmake的目录
PROJECT_SOURCE_DIR:工程的根目录
(2).SET(<variable> <value>... [PARENT_SCOPE])
显式设置普通变量
variable:只能有一个;
value:可以有0个,1个或多个,当value值为空时,方法同unset,用于取消设置的值;
PARENT_SCOPE(父作用域):作用域,除PARENT_SCOPE外还有function scope(方法作用域)和directory scope(目录作用域)。
2.set(<variable> <value>... CACHE <type> <docstring> [FORCE]) #设置缓存条目
variable:只能有一个
value:可以有0个,1个或多个,当value值为空时,方法同unset,用于取消设置的值
CACHE:关键字,说明是缓存变量设置
type(类型):必须为以下中的一种:
BOOL:有ON/OFF,两种取值
FILEPATH:文件的全路径
PATH:目录路径
STRING:字符串
INTERNAL:字符串
docstring:总结性文字(字符串)
[FORCE]:变量名相同,第二次调用set方法时,第一次的value将会被覆盖
3.set(ENV{<variable>} [<value>]) #设置环境变量
variable:只有一个
value
:一般来说,只有一个,为空时,将清除之前设置的变量值,多个时,取值最近的一个,之后的值将被忽略
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_BINARY_DIR}/bin):设置可执行文件的输出路径为build/bin
set(LIBRARY_OUTPUT_PATH ${PROJECT_BINARY_DIR}/lib):设置库文件的输出路径为build/lib
(3)include_directories(xxx)
给工程添加头文件,例如使用opencv时需要包含/usr/local/include/opencv/cv.h这个头文件,则我们需要include_directories(/usr/local/include),在调用的函数里写 #include “opencv/cv.h”即可
target_include_directories()
为指定的目标添加搜索头文件
include_directories()和target_include_directories()区别
include_directories 会为当前CMakeLists.txt的所有目标,以及之后添加的所有子目录的目标添加头文件搜索路径。因此,慎用,会影响全局target
target_include_directories 只会为指定目标包含头文件搜索路径。如果想为不同目标设置不同的搜索路径,target_include_directories 更合适
例:target_include_directories(test xxx ${PROJECT_SOURCE_DIR}/include)
如果xxx为PRIVATE 则表示头文件只能由 test使用
如果xxx为INTERFACE 则表示头文件只能由 调用test的文件使用
如果xxx为PUBLIC 则test和任何调用test的文件都能使用头文件
(4)add_executable(可执行文件名 1.cpp 2.ppp …)
添加可执行文件,其中可执行文件需要用到1.cpp和2.cpp 工程会给1.cpp和2.cpp编译生成一个可执行文件
(5)add_library(生成的库名称 STATIC/SHARED 源文件.cpp)
将源文件生成 静态/动态 库文件 STSTIC 表示静态库最终会编入到可执行文件中,SHARED(常见参数)表示动态库(又称共享库)方式
(6)target_link_libraries (库/可执行文件 library1 library2 ...)
为库或者可执行文件添加需要链接的库
注:需要放在add_executable之后
(7)add_subdirectory(source_dir)
向当前工程添加存放其他源文件的子目录,用于多目录下都有CMakeLists.txt文件的情况
(8)aux_source_directory( 文件目录 变量名)
把文件目录下的所有源文件储存在变量中
例:aux_source_directory(${PROJECT_SOURCE_DIR}/ DIR_SRCS) 表示把工程目录的源文件添加到DIR_SRCS变量中
(9)message(模式 "output msg" )
打印输出信息,常见模式有FATAL_ERROR、WARNING、STATUS、DEBUG等
(10)find_package(<NAME> 版本号 EXACT/QUIET/REQUIRED)
version:指定查找库的版本号。 EXACT:要求该版本号必须精确匹配。 QUIET:禁掉没有找到时的警告信息。如果没找到则忽略这一问题,继续执行 REQUIRED选项表示如果包没有找到的话,CMake的过程会终止,并输出警告信息
当find_package找到一个库的时候,以下变量会自动初始化:
<NAME>_FOUND : 显示是否找到库的标记
<NAME>_INCLUDE_DIRS 或 <NAME>INCLUDES : 头文件路径
<NAME>_LIBRARIES 或 <NAME>_LIBS : 库文件
注:如果CMake自动找不到路径,我们需要手动设置路径,如 先 set(OpenCV_INCLUDE_DIRS “home/hwh/Opencv3.1/build”) 设置路径 然后find_package(OpenCV 3.1 REQUIRED)
(11)file(GLOB 变量 "路径")
会在路径下查找目标文件并保存在变量中
(12)execute_process(COMMAND shell命令 WORKING_DIRECTORY shell命令的工作目录)
执行shell命令
(13)foreach(var ${list})
xxx
endforeach()
变量var从list中取值,并循环执行xxx命令
(14)install指令
install(TARGETS a.a b.so exe ARCHIVE a.a DESTINATION lib/ LIBRARY b.so DESTINATION lib/ RUNTIME exe DESTINATION bin/)
TARGETS:通过ADD_EXECUTABLE ADD_LIBRARY定义的目标文件,ARCHIVE特指静态库,LIBRARY特指动态库,RUNTIME特指可执行目标二进制,DESTINATION定义了安装的路径
FILE:普通文件的安装
PROGRAMS :可执行脚本
DIRECTORY:目录安装
(15)add_definitions()
向编译器添加-D定义,如ADD_DEFINITIONS(-DENABLE_DEBUG -DABC),参数之间用空格隔开
如果代码中定义了#ifdef ENABLE_DEBUG #endif,这个代码块就会生效
如果要添加其他编译器开关,可以通过CMAKE_C_FLAGS变量和CMAKE_CXX_FLAGS变量设置
(16)ADD_DEPENDENCIES()
定义target依赖其他的target,确保在编译本target之前,其他的target以及被构建
(17)FILE()
文件操作指令
(18)include(file OPTIONAL)
用于载入CMakeLists.txt文件和.cmake文件,模块文件搜索路径与CMAKE_MODULE_PATH
变量指定的路径有关,OPTIONAL参数作用是即使文件不存在也不报错
(19)find_xxx(<VAR> name1 path1 path2)
查找相应的文件,VAR变量表示找到文件的全路径
(20)
function的定义格式如下:后面可作为命令供调用
function(<name> [<arg1> ...])
<commands>
endfunction()
其中name是function的名字,参数为arg1, arg2等。
注意:变量的取值使用${},但在if控制语句中和直接使用变量名
Make VERBOSE=1可以看到makefile执行的详细步骤
CMAKE_INCLUDE_PATH 与CMAKE_LIBRARY_PATH是环境变量,两者都被用于find_path
版权归原作者 上进的打工人 所有, 如有侵权,请联系我们删除。