【记那些年我们链不明白的青春】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")