cmake如何引入三方库

### 如何在CMake项目中添加和配置第三方库 #### 使用`add_library`的Imported用法 对于那些不提供CMake文件或pkg-config文件的第三方库，可以通过定义一个IMPORTED目标来优雅地将其集成到CMake构建系统中。通过这种方式指定库的位置以及头文件路径等属性[^1]。 ```cmake # 定义外部静态链接库test为导入库 add_library(test STATIC IMPORTED) # 设置接口包含目录和其他平台特定设置 set_target_properties( test PROPERTIES INTERFACE_INCLUDE_DIRECTORIES "${PROJECT_SOURCE_DIR}/third_party/include" IMPORTED_LOCATION_DEBUG "${PROJECT_SOURCE_DIR}/third_party/lib/debug/test.lib" IMPORTED_LOCATION_RELEASE "${PROJECT_SOURCE_DIR}/third_party/lib/release/test.lib" ) ``` #### 利用`find_package`命令查找并加载预设模块 当第三方库提供了相应的`.cmake`配置脚本时，则可以直接利用`find_package()`函数自动定位所需的依赖项，并简化链接过程。这通常适用于广泛使用的开源软件包，它们往往已经包含了标准格式的支持文件以便于与其他工具链兼容[^2]。 ```cmake # 增加搜索路径前缀以帮助找到自定义安装位置下的组件 set(CMAKE_PREFIX_PATH "/usr/local/mylib" ${CMAKE_PREFIX_PATH}) # 寻找名为MyLib的目标及其关联资源 find_package(MyLib REQUIRED) # 将发现的结果应用于当前工程中的可执行文件或其他共享对象上 target_link_libraries(my_project PRIVATE MyLib::MyLib) ``` #### 整合多级子目录结构内的多个源码单元 在一个复杂的工程项目里可能会存在若干个独立但又相互依存的小型子模块；此时可以在顶层`CMakeLists.txt`文件内调用`add_subdirectory()`指令依次处理各个部分的内容。此方法有助于保持整体架构清晰有序的同时也方便管理不同阶段的任务划分[^3]。 ```cmake # 设定最低支持版本号及其他全局选项... cmake_minimum_required(VERSION 3.8 FATAL_ERROR) project(Main CXX) option(BUILD_TESTS "Build unit tests." OFF) if(MSVC) string(APPEND CMAKE_CXX_FLAGS " /Zi /MP /openmp") endif() # 添加其他必要的宏定义、编译特性开关... # 加载位于相对路径'TestCMake'处的次级描述符 add_subdirectory(TestCMake) ``` #### 处理具有复杂布局模式的标准动态链接库(DLLs/Libs) 针对某些特殊情况下既含有DLL形式导出符号又有对应LIB实现体的情况，还需要进一步细化关于调试版与发行版之间差异化的设定逻辑。下面的例子展示了怎样正确指派这些细节给对应的变量名从而确保最终产物能够顺利运行[^4]。 ```cmake # 创建SHARED类型的imported library实例'test' add_library(test SHARED IMPORTED) # 对应不同的build type分别赋予恰当的实际文件地址作为输入参数传递过去 foreach(_config IN ITEMS DEBUG RELEASE) file(GLOB_RECURSE _implib_files CONFIGURE_DEPENDS RELATIVE "${CMAKE_CURRENT_SOURCE_DIR}" FOLLOW_SYMLINKS "${_config}/*.lib") list(GET _implib_files 0 first_item) set_property(TARGET test APPEND PROPERTY IMPORTED_IMPLIB_${_config} "${first_item}") endforeach() unset(_implib_files) # 同样也要记得告知使用者去哪里寻找配套的API声明语句所在的头文件夹哦～ set_target_properties(test PROPERTIES INTERFACE_INCLUDE_DIRECTORIES "${CMAKE_CURRENT_SOURCE_DIR}/include") ```