CMake 面向Tatget编程
自CMake升级到3.0之后,CMake支持面向Target编程,下面展示一个编译的示例:
现有一个项目,包含Vision(基于OpenCV)和Socket(Win32)两部分,其目录下面结构所示:
│
├─build (编译缓存目录及默认可执行文件生成目录)
│
├─socketServer
│ ├─include
│ │ └─socket.h
│ │
│ ├─src
│ │ └─socketServer.cpp
│ │
│ └───CMakeLists.txt (Socket子目录)
│
├─Vision
│ ├─include
│ │ └─vision.h
│ │
│ ├─src
│ │ └─vision.cpp
│ │
│ └───CMakeLists.txt (Vision子目录)
│
└──────CMakeLists.txt (根目录)
那么,我们就可以认为Vision和Socket是两个独立的Target,那么每个Tatget就需写上其对于CMakeLists.txt
,而根目录下的CMakeList.txt
只需要包含Target中的CMakeLists.txt
即可,CMake会按照根目录中的CMakeLists.txt
顺序生成每个Target。
既然确定了思路,那么我们就要开始编写CMakeLists.txt,使其够正常的生成我们想要的可执行文件。
1.1 根目录CMakeLists.txt包含子目录CMakeLists.txt
cmake_minimum_required(VERSION 3.0.0) # CMake最小版本号,要是用面向Target必须版本大于3.0
project(Vision VERSION 0.0.1) # 项目名称
set(CMAKE_CXX_COMPILER "g++") # 设置编译器(若不是gcc,g++可以更换)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -std=c++11 -pthread" ) # 编译指令(由于Vision使用了OpenCV 4,故必须开启C++11支持)
# 使用了标准线程库,故加上编译选项-pthread
接下来是很重要的,包含子目录中的CMakeLists.txt
include(${CMAKE_CURRENT_LIST_DIR}/socketServer/CMakeLists.txt) # 包括socketServer目录下的CMakeLists.txt
include(${CMAKE_CURRENT_LIST_DIR}/vision/CMakeLists.txt) # 包括Vision目录下的CMakeLists.txt
1.2 编写每个Target的信息,首先是Socket
add_executable(socketServer) # 设置Target名称,并且指定生成可执行文件
# 注意,如果是生成库文件可以用add_library()
target_sources(socketServer # target_sources目标源文件
PUBLIC
${CMAKE_CURRENT_LIST_DIR}/include/socket.h # 加入头文件,头文件可根据情况设置PUBLIC或者是PRIVARE
PRIVATE
${CMAKE_CURRENT_LIST_DIR}/src/socketServer.cpp) # 加入源文件,源文件一般都是PRIVATE
target_include_directories(socketServer # target_include_directories目标头文件目录
PUBLIC
${CMAKE_CURRENT_LIST_DIR}/include)
target_link_libraries(socketServer wsock32) # target_link_libraries目标链接库文件,因为是win32下面写的socket,故需链接wsock32
到此第一个Target的信息就填写完毕了,下面填写第二个Target的信息:
1.3 Target Vision
由于项目使用了OpenCV,故先使用find_package()
找到系统中OpenCV相关信息
find_package(OpenCV REQUIRED) # 在系统环境变量中寻找OpenCV头文件以及库文件
add_executable(Vision) # 设置Target名称并生成可执行文件
target_sources(Vision # 目标源文件
PUBLIC
${CMAKE_CURRENT_LIST_DIR}/include/vision.h
PRIVATE
${CMAKE_CURRENT_LIST_DIR}/src/vision.cpp
)
target_include_directories(Vision # 目标头文件目录
PUBLIC
${CMAKE_CURRENT_LIST_DIR}/include
)
target_link_libraries(Vision ${OpenCV_LIBS}) # 链接OpenCV库
到此为止,一个最基本的两个Target项目编译信息就写好了,尝试在CMake中生成即可,如果填写的信息都正确,那么使用cmake生成的时候应该会如图所示: