CMake 打包已经存在的动态库生成 target

本文介绍如何在CMake中将模块C打包为Target,解决A、B模块间接依赖时的路径问题。通过Target封装,提高模块间依赖的友好性和可维护性,并探讨了INTERFACE方式的适用场景和限制。

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

一. 背景

在 CMakeLists.txt 中,某模块 A 通过 add_subdirectory 引入模块 B ,模块 B 通过 add_subdirectory 引入模块 C。模块 C 里面本身就是一个开源的动态库,比如 libtask。目的想要将 C 模块打包成一个 Target ,以便在 A 模块中中使用方便。

二. 旧版本实现和存在问题

A 模块不直接使用 C 模块,但是 A 模块使用到了 B 模块,B 模块编译依赖 C 模块,就需要导致 A 编译时要通过下面的方式引入 C 模块

  include_directories(${CMAKE_SOURCE_DIR}/thirdparty/B/thirdparty/C/include)
  link_directories(${CMAKE_SOURCE_DIR}/thirdparty/B/thirdparty/C/lib)

该使用方式 A 即为不友好。如果上层存在 M 模块依赖 A 模块,也要通过类似方式用 C,导致使用上极为不友好。

三.解决方案

在 CMake 中有 Target 的概念,尝试单独将 C 打包成一个 Target,这样之后,当 A 依赖 B 时,B 依赖 C,A 不需要直接通过上面相对路径的方式,因为 Target 已经被包进去了。于是在 C 模块中,将所有的已经存在的 so 打包起来:

cmake_minimum_required (VERSION 3.10)

project(libtask)

file(WRITE ${PROJECT_BINARY_DIR}/empty.cpp "")
add_library (${PROJECT_NAME} SHARED ${PROJECT_BINARY_DIR}/empty.cpp)

target_include_directories(${PROJECT_NAME} PUBLIC include)
target_link_libraries(${PROJECT_NAME} PUBLIC
  ${CMAKE_CURRENT_SOURCE_DIR}/lib/libtask-a.so
  ${CMAKE_CURRENT_SOURCE_DIR}/lib/libtask-b.so
)

在 B 模块使用 A 模块时,可以使用下面的方式

xxx
add_subdirectory(thirdparty/libtask)
xxx
target_link_libraries(${PROJECT_NAME} PRIVATE libtask)

其他有问题的方案:
在实现 C 时也可以通过 INTERFACE 的方式打包 C,使用下面的方式:

cmake_minimum_required (VERSION 3.10)

project(libtask)

add_library (${PROJECT_NAME} INTERFACE)

target_include_directories(${PROJECT_NAME} INTERFACE include)
target_link_libraries(${PROJECT_NAME} INTERFACE
  ${CMAKE_CURRENT_SOURCE_DIR}/lib/libtask-a.so
  ${CMAKE_CURRENT_SOURCE_DIR}/lib/libtask-b.so
)

由于想要使用 INTERFACE 的方式打包库文件,此时就就必须使用 INTERFACE 的方式包含头文件和库文件,这样子就导致外部 A 模块无法直接使用 C 的库文件和头文件,还要使用

xxx
add_subdirectory(thirdparty/libtask)
xxx
target_link_libraries(${PROJECT_NAME} PRIVATE libtask)
### 使用CMake生成动态库和静态库 在C++开发过程中,通过CMake可以方便地管理项目并生成不同类型的库文件。为了创建动态库(共享库)和静态库,可以在`CMakeLists.txt`中定义相应的设置。 #### 创建静态库 静态库是在编译阶段链接到目标程序中的二进制文件集合。要创建一个名为`my_static_lib`的静态库: ```cmake add_library(my_static_lib STATIC src/static.cpp) ``` 这条命令告诉CMake将指定源码文件打包成静态库[^1]。 对于更复杂的场景,比如处理头文件复制以及解决多重包涵依赖关系时,则可参照如下配置方式来增强构建脚本的功能性[^3]: ```cmake set(header_files "path/to/header.h") file(COPY ${header_files} DESTINATION ${PROJECT_BINARY_DIR}/out/include) target_include_directories(my_static_lib PUBLIC ${PROJECT_SOURCE_DIR}/include) ``` 这里不仅指定了静态库本身的信息,还设置了公共包含路径以便其他模块能够访问该库提供的接口。 #### 创建动态库 相比之下,动态库会在运行时加载,并允许多个应用程序共享同一份副本。以下是创建名为`my_shared_lib`的动态库的方法: ```cmake add_library(my_shared_lib SHARED src/shared.cpp) ``` 此指令会指示CMake按照平台约定的方式去生产共享对象(.so) 或者DLL (.dll),具体取决于操作系统环境。 当涉及到多层依赖项之间的相互作用时——特别是针对那些既含有内部又存在外部依赖性的大型工程来说,在链接选项上做适当调整就显得尤为重要了: ```cmake set(LIBS "-L/path/to/libraries -llibrary_name") target_link_libraries(my_shared_lib PRIVATE -Wl,--start-group ${LIBS} -Wl,--end-group) ``` 上述代码片段展示了如何利用特定于链接器的关键字参数(`-Wl`) 来确保所有必要的符号都能被正确解析出来。 综上所述,无论是静态还是动态库的制作过程都离不开合理规划好各个组成部分间的关联逻辑;而借助像CMake这样的工具则可以让整个流程变得更加高效便捷。
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值