CMake调用第三方库的两种方法

RabinSong

已于 2023-08-31 21:40:07 修改

阅读量2.2k

点赞数

分类专栏： CMake构建自动化文章标签： c++ linux arm开发运维 ci/cd gitlab git

于 2023-08-29 23:22:08 首次发布

本文链接：https://blog.youkuaiyun.com/rabinsong/article/details/132550344

版权

CMake构建自动化专栏收录该内容

4 篇文章

订阅专栏

项目链接第三方库时，让链接器搜索库一般有两种方法。一是用link_directories命令增加链接库路径，使用简单但不适合跨平台项目；二是用find_library命令，会到特定cmake配置文件中找库，若没有对应文件需自己编写，相对麻烦。还提及了find_package cmake config文件生成方法。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

项目中经常要使用到第三方库，在链接时，为了让链接器能搜索到库，一般有两种方法，一是通过link_directories命令增加链接的库路径；二是通过find_library命令方法。

link_directories命令

使用步骤

## 在add_executable或add_library前引入第三方库
# 1.引入第三方库,${THIRD_PARTY_PREFIX}为用户定义的第三方库目录
link_directories(${THIRD_PARTY_PREFIX}/lib)
# 2.增加第三方库头文件目录
include_directories(${THIRD_PARTY_PREFIX}/include)
# 3.给目标增加依赖库(如main)
target_link_libraries(main PRIVATE freetype)

参考资料
命令介绍

find_library命令
link_directories命令不需要cmake配置文件，只需要给出库的路径就可以了，使用相对简单，但不适合跨平台项目。而find_library会到类似XxxConfig.cmake 或 xxx-config.cmake 或 FindXxx.cmake文件去找动态库或静态库，如果自己写的库，或者第三方库没有对应的配置文件，需要自己编写对应的cmake config文件，相对于link_directories方法，就有些麻烦。

使用步骤

   # 1.THIRD_PARTY_PREFIX加入到find_package搜索路径
   set(CMAKE_PREFIX_PATH ${THIRD_PARTY_PREFIX})
   # 2.搜索freetype库 
   find_package(freetype REQUIRED)
   # 3.给目标添加依赖库
   target_link_libraries(main PRIVATE freetype)

参考资料
命令介绍

find_package cmake config文件生成方法

include(CMakePackageConfigHelpers)
write_basic_package_version_file(
  ${PROJECT_NAME}ConfigVersion.cmake
  VERSION ${PACKAGE_VERSION}
  COMPATIBILITY SameMajorVersion)

install(
    EXPORT ${PROJECT_NAME}Targets
    FILE ${PROJECT_NAME}Targets.cmake
    DESTINATION lib/cmake/)

configure_package_config_file(
    cmake/config.cmake.in ${PROJECT_NAME}Config.cmake
    INSTALL_DESTINATION lib/cmake/)

install(
  FILES ${PROJECT_BINARY_DIR}/${PROJECT_NAME}Config.cmake
        ${PROJECT_BINARY_DIR}/${PROJECT_NAME}ConfigVersion.cmake
        DESTINATION lib/cmake/)

## config.cmake.in文件内容
@PACKAGE_INIT@
# include(CMakeFindDependencyMacro)
include("${CMAKE_CURRENT_LIST_DIR}/@PROJECT_NAME@Targets.cmake")
find_dependency(spdlog REQUIRED)
check_required_components("@PROJECT_NAME@")