如何避免将不必要的静态库与 CMake 链接？

Question

我有一个包含 2 个静态库和一个可执行文件的小项目。

• utils：静态库。
• lib1：一个静态库。 lib1 中的一些函数使用了utils 代码，但大多数没有。
• main ：使用来自lib1 的函数的可执行文件，不使用来自utils 的代码。

在一个简单的 Visual Studio 项目中，main 只会链接lib1。但由于 lib1 需要一些 utils 的 target_include_directories 来编译，lib1 的 cmake 代码包含一个 target_link_libraries 调用：

utils CMakeLists.txt：

target_include_directories(utils INTERFACE ${CMAKE_CURRENT_SOURCE_DIR}) # lib1 needs this

lib1：CMakeLists.txt：

target_link_libraries(lib1 PRIVATE utils) # some of lib1 code uses utils

主要：CMakeLists.txt：

target_link_libraries(main PRIVATE lib1) # this causes utils to link as well

问题是在生成的项目中，main 包含 2 个依赖项而不是 1 个。如果我手动从依赖项列表中删除 utils，一切正常。

但现在我必须编译 utils 才能编译 main。

让main 仅与lib1 链接的正确方法是什么？更一般地说，如何避免使用 cmake 链接不必要的静态库？

Answer 1

我找到了解决问题的方法。在我有限的测试中，它适用于 MSVC 和 GCC。

基本上，我没有在 lib1 的 CMakeLists.txt 中使用target_link_libraries，而是使用以下函数：

function(add_interface_includes target_library src_library)    
    get_target_property(library_interface_includes ${src_library} INTERFACE_INCLUDE_DIRECTORIES)
    set_target_properties(${target_library} PROPERTIES INCLUDE_DIRECTORIES "${library_interface_includes}")
endfunction()

当我写add_interface_includes(lib1 utils) 时，我基本上模仿target_link_libraries 的行为，而不创建链接器依赖项。当main链接lib1时，如果我明确指定它只会链接utils。

Answer 2

如果utils 库的某些功能可以通过仅获取标头来使用，那么我将制作仅标头目标。

utilsCMakeLists.txt:

add_library(utils_hdr INTERFACE)
target_include_directories(utils_hdr INTERFACE ${CMAKE_CURRENT_SOURCE_DIR})

add_library(utils STATIC *.c)
target_link_libraries(utils PUBLIC utils_hdr)

lib1CMakeLists.txt:

target_link_libraries(lib1 PRIVATE utils_hdr)

mainCMakeLists.txt:

target_link_libraries(main PRIVATE lib1)

Answer 3

主要问题是静态库只不过是目标文件的存档。链接静态库就像链接目标文件本身一样。

这导致两件事：

1. 静态库本身不链接；
2. 您需要链接静态库的所有依赖项。

对于您的项目，main 程序必须与两个静态库链接。