静态库私有链接时未传递共享库依赖的CMake问题

问题背景 #

项目结构为：可执行文件链接共享库SharedLib，SharedLib私有链接静态库StaticLib，StaticLib依赖共享库TransitiveLib。该项目在Linux x64原生GCC、MSVC环境下链接正常，但使用Raspbian GCC 10.2.0交叉编译时，最终链接可执行文件阶段报错找不到libTransitiveLib.so，提示transitive_library_function()未定义。核心原因是静态库本身不存储依赖信息，交叉编译的sysroot环境又改变了编译器的库搜索逻辑，导致上层目标无法自动获取StaticLib的共享库依赖。

规范解决方法 #

1. 让静态库正确传递共享库依赖（推荐） #

在StaticLib的CMake配置中，使用PUBLIC关键字声明对TransitiveLib的依赖，这样当其他目标链接StaticLib时，会自动继承该依赖关系：

# StaticLib的CMakeLists.txt
add_library(StaticLib STATIC static_library.cpp)
# 用PUBLIC标记依赖，确保依赖能传递给链接StaticLib的上层目标
target_link_libraries(StaticLib PUBLIC TransitiveLib)

之后SharedLib只需保持私有链接StaticLib即可：

# SharedLib的CMakeLists.txt
add_library(SharedLib SHARED shared_library.cpp)
target_link_libraries(SharedLib PRIVATE StaticLib)

CMake会自动处理依赖传递，把TransitiveLib的链接信息传递给最终的可执行文件，交叉编译环境下也能正确定位库文件。

2. 显式为可执行文件添加依赖 #

如果无法修改StaticLib的配置（比如是第三方静态库），可以直接在可执行文件的CMake配置中显式链接TransitiveLib：

# 可执行文件的CMakeLists.txt
add_executable(MyExecutable main.cpp)
target_link_libraries(MyExecutable PRIVATE SharedLib TransitiveLib)

这种方式直接有效，但缺点是StaticLib的依赖变更时，需要手动同步修改可执行文件的依赖配置。

3. 兼容旧版本CMake的属性设置（不推荐） #

若使用CMake 3.0之前的版本，可以通过设置StaticLib的LINK_INTERFACE_LIBRARIES属性来传递依赖：

set_target_properties(StaticLib PROPERTIES
    LINK_INTERFACE_LIBRARIES TransitiveLib
)

注意：此为旧写法，优先推荐使用target_link_libraries的关键字声明方式，更符合现代CMake的设计规范。

交叉编译sysroot环境的补充配置 #

如果上述方法仍存在库路径问题，可在工具链文件中明确配置库搜索路径：

# 交叉编译工具链文件
set(CMAKE_SYSROOT "/path/to/raspbian/sysroot")
# 将自定义库输出目录添加到链接搜索路径
link_directories(${CMAKE_BINARY_DIR}/lib)

也可以为TransitiveLib设置输出目录并开启自动rpath处理：

set_target_properties(TransitiveLib PROPERTIES
    LIBRARY_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/lib
    INSTALL_RPATH_USE_LINK_PATH TRUE
)

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