CMake导出静态库为何需私有链接？链接fooStatic遇gpgme依赖问题

为什么fooStatic的INTERFACE_LINK_LIBRARIES包含gpgme::gpgme？ #

这是静态库的固有特性导致的：

• 共享库（foo）在构建时会记录自身依赖关系，运行时动态加载依赖库，因此CMake不会将其PRIVATE依赖传递给使用者。
• 静态库（fooStatic）本质是目标文件的归档，不会处理自身依赖，链接静态库的目标必须同时链接其所有依赖才能解决符号引用。CMake为保证构建正确性，会自动将静态库的PRIVATE依赖添加到INTERFACE_LINK_LIBRARIES中（用$<LINK_ONLY>标记，仅在链接阶段生效），这就是gpgme::gpgme出现在生成的fooTargets.cmake中的原因。

即使你链接了gpgme的静态目标，CMake依然会传递这个依赖——因为fooStatic本身并没有包含gpgme的代码，使用者必须自行链接gpgme才能完成构建。

如何让用户无需安装libgpgme-dev即可链接fooStatic？ #

核心思路是将gpgme的静态库代码嵌入到fooStatic中，让fooStatic成为不依赖外部gpgme的独立静态库。具体实现步骤如下：

1. 修改foo项目的CMakeLists.txt #

针对fooStatic，在链接gpgme静态库时使用链接器参数强制将gpgme的所有符号嵌入到fooStatic中（以Unix-like系统为例）：

find_package(gpgme REQUIRED)

# 获取gpgme静态库的实际路径
get_target_property(GPGME_STATIC_LIB_PATH gpgme::gpgme IMPORTED_LOCATION)

# 构建fooStatic时，用--whole-archive参数将gpgme静态库的所有代码嵌入
target_link_libraries(fooStatic
  PUBLIC fooObjects
  PRIVATE
    "-Wl,--whole-archive" ${GPGME_STATIC_LIB_PATH} "-Wl,--no-whole-archive"
)

• --whole-archive：告诉链接器将指定静态库中的所有目标文件都包含到输出库中，而非仅包含被引用的符号。
• --no-whole-archive：恢复默认链接行为，避免影响后续其他依赖。

2. 验证效果 #

重新构建并安装foo项目后，生成的fooStatic会包含gpgme的全部代码。此时用户执行：

find_package(foo)
add_executable(bar ...)
target_link_libraries(bar PRIVATE fooStatic)

构建时不会再出现找不到gpgme::gpgme的错误，也无需安装libgpgme-dev。

注意事项 #

• 该方法仅适用于静态链接gpgme的场景，且需要确保gpgme提供静态库版本。
• 嵌入第三方库代码时，需确认其许可证允许这种分发方式，避免合规问题。

内容的提问来源于stack exchange，提问作者Stewart