编译时如何链接临时路径库且保留未来安装路径？

编译阶段如何将链接器指向临时路径？ #

背景 #

需要链接目前未安装、未来将安装到指定路径的库。

原CMake配置（存在语法/逻辑问题） #

...

# 原代码存在语法错误：set括号不匹配，变量引用缺少大括号
set(LIBS_TO_BE_INSTALLED)
   libA.so
   libB.so
) 

set(FUTURE_LIB_PATH
    /usr/lib/future/path
) # 库安装后会在此路径下

set(TEMPORARY_LIB_PATH
   /temporary/path
) # 安装前库在此路径下

add_library(${PROJECT_NAME} SHARED $SRCS $HDRS)
link_directories(AFTER $FUTURE_LIB_PATH) # 库安装后此配置生效
target_link_libraries(${PROJECT_NAME} ${LIBS_TO_BE_INSTALLED})

...

期望效果 #

最终生成的共享库通过ldd查看时，依赖库指向未来的安装路径：

$ ldd ${PROJECT_NAME}.so
    ...
    libA.so.X => /usr/lib/future/path/libA.so.X
    libB.so.Y => /usr/lib/future/path/libB.so.Y
    ...

遇到的问题 #

尝试添加临时路径的链接配置后，链接器报错找不到库：

link_directories(AFTER $TEMPORARY_LIB_PATH)

报错信息：

[100%] Linking CXX shared library ${PROJCET_NAME}.so
/usr/bin/ld: cannot find -llibA: No such file or directory
/usr/bin/ld: cannot find -llibB: No such file or directory

解决方案 #

核心需求是编译阶段让链接器找到临时路径的库，同时最终库的运行时路径（rpath）指向未来安装路径，以下是两种可靠实现方式：

方法1：使用目标级链接目录 + 安装时rpath配置

这种方式更符合CMake的现代最佳实践，通过目标级配置替代全局link_directories：

...

# 修正语法错误：正确定义依赖库列表
set(LIBS_TO_BE_INSTALLED libA.so libB.so)

set(FUTURE_LIB_PATH "/usr/lib/future/path")
set(TEMPORARY_LIB_PATH "/temporary/path")

add_library(${PROJECT_NAME} SHARED ${SRCS} ${HDRS})

# 1. 指定编译阶段链接器查找临时库的路径（目标私有配置，不影响其他目标）
target_link_directories(${PROJECT_NAME} PRIVATE ${TEMPORARY_LIB_PATH})

# 2. 设置最终安装后的运行时搜索路径（rpath）为未来的安装路径
set_target_properties(${PROJECT_NAME} PROPERTIES
    INSTALL_RPATH "${FUTURE_LIB_PATH}"
    # 强制保留自定义rpath，避免安装时被系统自动移除
    INSTALL_RPATH_USE_LINK_PATH FALSE
)

# 链接依赖库
target_link_libraries(${PROJECT_NAME} PRIVATE ${LIBS_TO_BE_INSTALLED})

...

方法2：直接传递链接器参数（-rpath-link）

通过target_link_options给链接器传递-rpath-link参数，明确指定编译阶段查找依赖库的临时路径，同时用INSTALL_RPATH设置未来的运行时路径：

...

set(LIBS_TO_BE_INSTALLED libA.so libB.so)
set(FUTURE_LIB_PATH "/usr/lib/future/path")
set(TEMPORARY_LIB_PATH "/temporary/path")

add_library(${PROJECT_NAME} SHARED ${SRCS} ${HDRS})

# 传递链接器参数：指定编译阶段查找依赖的临时路径（不影响最终rpath）
target_link_options(${PROJECT_NAME} PRIVATE "-Wl,-rpath-link=${TEMPORARY_LIB_PATH}")

# 设置安装后的运行时路径
set_target_properties(${PROJECT_NAME} PROPERTIES
    INSTALL_RPATH "${FUTURE_LIB_PATH}"
    INSTALL_RPATH_USE_LINK_PATH FALSE
)

target_link_libraries(${PROJECT_NAME} PRIVATE ${LIBS_TO_BE_INSTALLED})

...

报错原因分析 #

1. 语法错误：原代码中变量引用缺少大括号（如$FUTURE_LIB_PATH应为${FUTURE_LIB_PATH}），set(LIBS_TO_BE_INSTALLED)括号不匹配，导致CMake解析错误。
2. 链接目录作用域/顺序问题：全局link_directories的顺序可能被其他配置覆盖，且未正确指向临时路径。
3. 库文件检查：需确保临时路径下存在对应库文件（如libA.so或其符号链接到实际的libA.so.X）。

内容的提问来源于stack exchange，提问作者qt-x