【记那些年我们链不明白的青春】Cmake常用函数一文总结
前言
以一个简短且好理解的方式记录一下常用Cmake的函数，区别于网上的那些抄来抄去。废话少，全精华。
link_directories
link_directories(${PROJECT_SOURCES_DIR}/lib)
是对于 .so 文件的
函数作用：添加一个.so库文件的搜索路径 使得链接的时候直接在后面添加库的名称可以被找得到
（比如liberal.so 库的名称即为gdal而不是全称）
target_link_libraries
target_link_libraries(${PROJECT_NAME} ...)
...放的即是上面说到的库的名称
函数作用：将...（可以多个）全部链接到PROJECT_NAME这个东西上 但这里...部分都已经是.so文件了（包括自己生成的.so和已有的.so）
这个函数不仅可以将库文件链接到可执行文件上 也可以将库文件链接到库文件上（串起来 有画面了）
include_directories
include_directories(${INCLUDE_PATH})
函数作用：添加头文件所在路径
不仅是第三方库的头文件 还有自己写的头文件的路径
这个目录直接影响cpp代码中#include的搜索路径
即如果第三方头文件在这里被include了 那么我们自己引用头文件时直接#include 不用添加冗杂的路径
FILE(GLOB_RECURCE MY_SRC ${SRC_PATH}/*.cpp)
FILE(GLOB_RECURCE MY_SRC ${SRC_PATH}/*.cpp)
函数作用：将SRC_PATH路径下的所有.cpp文件全部用一个名称——MY_SRC代替 相当好用了
add_library(mylib ${MY_SRC})
add_library(mylib ${MY_SRC})
函数作用：将MY_SRC中的.cpp文件编译成.so库
这里因为没有STATIC 所以是动态库
和上一个结合使用 很方便
add_library(mylib STATIC ${MY_SRC})
add_library(mylib STATIC ${MY_SRC})
函数作用：将MY_SRC中的.cpp文件编译成静态库.a
获取上一级目录
string(REGEX REPLACE "(.*)/${PROJECT_NAME}$" "\\1" PROJECT_PRE_DIR ${PROJECT_SOURCE_DIR})
正则表达式 上一级目录保存在PROJECT_PRE_DIR变量中
最后
易混淆的应该都有了 以后遇见更常用的再来更新
install
安装可执行文件
这将安装 my_executable 可执行文件到 bin 目录下。
add_executable(my_executable main.cpp)
install(TARGETS my_executable DESTINATION bin)
安装库文件
这将安装 my_library 共享库文件到 lib 目录下，并将静态库文件也安装到 lib 目录下。
add_library(my_library SHARED my_library.cpp)
install(TARGETS my_library
LIBRARY DESTINATION lib
ARCHIVE DESTINATION lib
)
安装文件
这将安装文件列表 file1.txt 和 file2.txt 到 data 目录下。
set(MY_FILES file1.txt file2.txt)
install(FILES ${MY_FILES} DESTINATION data)
安装目录
这将安装目录 my_directory 到 share 目录下。
set(MY_DIR my_directory)
install(DIRECTORY ${MY_DIR} DESTINATION share)
参数总结
ARCHIVE：用于静态库文件。
LIBRARY：用于共享库文件（动态库）。
RUNTIME：用于可执行文件。
PUBLIC_HEADER：用于公共头文件。
PRIVATE_HEADER：用于私有头文件。
install(TARGETS main_proc
RUNTIME DESTINATION bin
LIBRARY DESTINATION lib
ARCHIVE DESTINATION lib)
get_property与set_property
可设置变量名为全局可见：
设置MODULE变量为全局可见
set_property(GLOBAL APPEND PROPERTY MODULE)
随后在各个子目录中的CMakeLists为MODULE赋值，然后拿取属性：
get_property(MODULE GLOBAL PROPERTY MODULE)
给变量赋值：
上述示例中，my_global_property属性被设置为全局范围，其值为my_value。
set_property(GLOBAL PROPERTY my_global_property my_value)
my_list_property属性的值被设置为一个包含"value1"和"value2"的列表。如果目标my_target之前已经有my_list_property属性，那么这些新的值将被追加到已有的列表中。
set_property(TARGET my_target APPEND PROPERTY my_list_property "value1" "value2")
