01-CMake常用指令

原创已于 2022-10-12 17:06:14 修改 · 286 阅读

2 ·

CC 4.0 BY-SA版权

文章标签：

#opencv #c++ #计算机视觉

于 2022-10-12 15:39:01 首次发布

CMake & Multi-threaded 专栏收录该内容

4 篇文章

订阅专栏

CMake

常用指令

cmake_minimum_required

指定要求最小的cmake版本，如果版本小于该要求，程序终止

project(test)

设置当前项目名称为test

CMAKE_BUILD_TYPE

Debug：调试模式，输出调试信息，不做优化
release：发布模式，没有调试信息，全优化
RelwithDebInfo：类似于Release，但包括调试模式
MinSizeRel：一种特殊的Release模式，会特别优化库的大小

CMAKE_CXX_FLAGS

编译CXX的设置标志，比如 -std=c++11， -Wall， -O3（优化，使用向量化、CPU流水线、cache等提高代码速度）
编译过程中输出警告（warnings）：set(CMAKE_CXX_FLAGS “-Wall”)
追加，不会丢失之前的定义：set(CMAKE_CXX_FLAGS “${CMAKE_CXX_FLAGS} -Wall”)

include_directories

指定头文件的搜索路径，编译器查找相应头文件
举例：文件main.cpp中使用到路径/usr/local/include/opencv/cv.h中这个文件
CMakeLists.txt中添加include_directories(/usr/local/include)
使用main.cpp前写上#include "opencv/cv.h"即可

set(variable value)

用变量代替值
set(SRC_LST main.cpp other.cpp)表示定义SRC_LST代替后面两个cpp文件

add_executable(hello main.cpp)

用指定的源文件为工程添加可执行文件
工程会用main.cpp生成一个文件名为hello的可执行文件

add_library(libname STATIC/SHARED sources)

将指定的源文件生成链接库文件。STATIC为静态链接库，SHARED为共享链接库

target_link_libraries(target library1 library2 ...)

为库或二进制可执行文件添加库链接，要用在add_executable之后。
例子如下：target_link_libraries(myProject libhello.a)

add_dependencies(target-name depend)

为上层target添加依赖项，一般不用
若只有一个targets有依赖关系，一般选择使用target_link_libraries
如果两个有target有依赖关系，并且依赖库也是通过编译源码产生的。这时候用该指令可以在编译上层target时，自动检查下层依赖库是否已经生成

add_subdirectory(source_dir)

向当前工程添加存放源文件的子目录，目录可以是绝对路径或者相对路径

aux_source_directory(dir varname)

message(mode "message text")

打印输出信息，mode包括FATAL_ERROR、WARNING、STATUS、DEBUG等
message(STATUS “Set debug mode”)

一些预定义好的指令：
PEOJECT_NAME:项目名称，与peoject(xxx)一致
PROJECT_SOURCE_DIR:即内容project()指令的CMakeLists所在的文件夹
EXECUTABLE_OUTPUT_PATH:可执行文件输出路径
LIBRARY_OUTPUT_PATH:库文件输出路径
CMAKE_BINARY_DIR:默认是build文件夹所在的绝对路径
CMAKE_SOURCE_DIR:源文件所在的绝对路径

find_package(package version EXACT/QUIET/REQUIRED)

功能：采用两种模式（FindXXX.cmake和XXXConfig.cmake）搜索外部库
示例：find_package(OpenCV 3.4 REQUIRED)
version：指定查找库的版本号。EXACT：要求该版本必须精确查找。QUIET：禁掉没有找到时的警告信息。REQUIRED选项表示如果包没有找到的话，CMake的过程会终止，并输出警告信息。
搜索有两种模式：
Module模式：搜索CMAKE_MODULE_PATH指定路径下的FindXXX.cmake文件，执行该文件从而找到XXX库。其中，具体查找库并给XXX_INCLUDE_DIRS和XXX_LIBRARIES两个变量赋值的操作由FindXXX.cmake模块完成。
Config模式：搜索XXX_DIR指定路径下的XXXConfig.cmake文件从而找到XXX库。其中具体查找库并给XXX_CINLUDE_DIRS和XXX_LIBRARIES两个变量赋值的操作由XXXConfig.cmake模块完成。
两种模式看起来似乎差不多，不过cmake默认采取Module模式，如果Module模式未找到库，才会采用Config模式。
如果XXX_DIR路径下找不到XXXConfig.cmake文件，则会找/usr/local/lib/cmake/XXX/中的XXXConfig.cmake文件。总之，Config模式是一个备选策略。通常，库安装时会拷贝一份XXXConfig.cmake到系统目录，因此在没有显式指定搜索路径时也可以顺利找到。
若XXX安装时没有安装到系统目录，则无法自动找到XXXConfig.cmake，需要在CMakeLists.txt最前面添加XXX的搜索路径。
set(XXX_DIR /home/zzx/3rdParty/OpenCV 3.1/build) #添加OpenCV的搜索路径
当find_package找到一个库的时候，以下变量会自动初始化：
NAME_FOUND:显示是否找到库的标记
NAME_INCLUDE_DIRS或NAME_INCLUDES:头文件路径
NAME_LIBRARIES或NAME_LIBRARIES或NAME_LIBS:库文件