语法规则
- CMake变量取值:
${}
- IF语句中直接使用变量名;
- 参数以空格或分号隔开:
指令(参数1 参数2)
- 环境变量赋值:
SET(ENV{VAR) VALUE)
- 环境变量取值:
$ENV{}
简短CMakeLists.txt
cmake_minimum_required(VERSION 3.12 FATAL_ERROR)
PROJECT(TESTVTK)
find_package(VTK REQUIRED)
include(${VTK_USE_FILE})
if (NOT VTK_FOUND)
message(FATAL_ERROR "ERROR: Unable to find the VTK build folder.")
endif()
# 只需将 FILENAME 替换为想要包含的.cpp 或者.cxx 文件
add_executable(TESTVTK MACOSX_BUNDLE FILENAME.cxx )
target_link_libraries(TESTVTK ${VTK_LIBRARIES})
加载外部库
find_package(OpenCV REQUIRED)
if(OpenCV_FOUND)
include_directories(${OPENCV_INCLUDE_DIRS})
target_link_libraries(sample ${OpenCV_LIBRARIES})
endif(OpenCV_FOUND)
find_package(PCL 1.12 REQUIRED)
if(PCL_FOUND)
include_directories(${PCL_INCLUDE_DIRS})
target_link_libraries(sample ${PCL_LIBRARIES})
endif(PCL_FOUND)
常用命令(按步骤顺序)
工程名
project(smaple)
cmake版本
cmake_minimum_required(VERSION 3.1.0)
工程构建类型
set(CMAKE_BUILD_TYPE "Release") # 文件执行更快
或者
set(CMAKE_BUILD_TYPE "Debug")
添加头文件
include_directories(
${PROJECT_SOURCE_DIR}
${PROJECT_SOURCE_DIR}/include
)
PROJECT_SOURCE_DIR、PROJECT_BINARY_DIR:CMake预定义的两个变量
添加源文件
aux_source_directory(${PROJECT_SOURCE_DIR} SOURCE_LIST)
aux_source_directory(${PROJECT_SOURCE_DIR}/src SOURCE_LIST)
SOURCE_LIST自行定义
生成可执行文件
add_executable(sample ${SOURCE_LIST})
build生成名为sample的文件
add_executable(sample main.cpp ${SOURCE_LIST})
主要文件也可以写在这用于突出
为可执行文件链接所需的库文件
target_link_libraries(sample
${PCL_LIBRARIES} ${OpenCV_LIBS} -lpthread)
更改可执行文件和生成库的输出路径
set(EXECUTABLE_OUTPUT_PATH ${PROJECT_SOURCE_DIR})
set(LIBRARY_OUTPUT_PATH ${PROJECT_SOURCE_DIR})
在add_executable之前添加以上语句,会发现可执行文件和生成的库,都生成在了工程根目录下,而不是build下了
编译子目录
add_subdirectory(${PROJECT_SOURCE_DIR}/test)
生成库
add_library(XXX [SHARED/STATIC])
- 不填参数或者填参数STATIC,生成的是静态库libXXX.a
- 参数写SHARED,生成的是动态库libXXX.so
编译子目录时如果使用add_subdirectory的参数指定了路径,库文件会生成在该路径,否则会生成在工程根目录的build下
查找库
find_library(XXX NAMES libYYY PPP)
在路径PPP下查找名字叫libYYY.so的库,将这个库命名为XXX
链接这个库时,可以替换成XXX
target_link_libraries(${PROJECT_NAME} ${XXX})
设置变量
SET(XXX YYY)
eg.
set(CMAKE_CXX_STANDARD 11)
将YYY命名为XXX,也可以是将变量XXX的值设置为YYY
选项
option(TEST "BUILD TEST" OFF)
if (TEST)
message("build test!")
add_subdirectory(${PROJECT_SOURCE_DIR}/test)
endif()