CMake安装阶段如何保留RPATH，解决共享库查找失败问题？

问题根源 #

通过ExternalProject_add引入的libbar是构建阶段才完成编译安装的，CMake配置阶段无法感知到它的实际路径，导致CMAKE_INSTALL_RPATH_USE_LINK_PATH无法自动捕获该路径，最终安装时RPATH被清空，可执行文件找不到共享库。

具体解决步骤 #

1. 明确ExternalProject的安装目录 #

在定义ExternalProject_add时，显式指定INSTALL_DIR，确保依赖库的安装路径可被CMake捕获：

ExternalProject_Add(bar_external
    # 替换为你的libbar源码地址/本地路径
    GIT_REPOSITORY https://github.com/xxx/libbar.git
    # 固定libbar的安装目录到构建目录下的子文件夹
    INSTALL_DIR ${CMAKE_CURRENT_BINARY_DIR}/libbar_install
    # 传递CMake参数，指定libbar的安装前缀为上面的INSTALL_DIR
    CMAKE_ARGS -DCMAKE_INSTALL_PREFIX=<INSTALL_DIR>
)

2. 获取依赖库的安装路径并设置可执行文件的INSTALL_RPATH #

使用ExternalProject_Get_Property获取libbar的安装目录，然后为可执行文件foo设置INSTALL_RPATH：

# 获取libbar的安装前缀路径
ExternalProject_Get_Property(bar_external INSTALL_DIR)

# 定义可执行文件foo
add_executable(foo src/main.cpp)
# 确保foo在libbar构建完成后再编译
add_dependencies(foo bar_external)
# 链接libbar库
target_link_libraries(foo ${INSTALL_DIR}/lib/libbar.so)

# 设置foo的INSTALL_RPATH，指向libbar的库目录
set_target_properties(foo PROPERTIES
    # 指定安装后的RPATH为libbar的lib目录
    INSTALL_RPATH "${INSTALL_DIR}/lib"
    # 禁用自动使用链接路径（因为我们已经手动指定了正确路径）
    INSTALL_RPATH_USE_LINK_PATH FALSE
    # 确保安装时不跳过RPATH设置
    SKIP_INSTALL_RPATH FALSE
)

# 安装可执行文件到指定目录
install(TARGETS foo DESTINATION bin)

3. 验证效果 #

执行make install后，用ldd /bin/foo检查，应该能看到libbar.so指向构建目录下的libbar_install/lib路径，运行/bin/foo即可正常加载依赖库。

额外说明 #

• 如果libbar的库目录不是lib（比如部分64位系统是lib64），需要将${INSTALL_DIR}/lib替换为${INSTALL_DIR}/lib64，或者通过find_library动态查找库的位置。
• 若需要将libbar也安装到系统目录，可以在ExternalProject_add中添加INSTALL_COMMAND同步安装，此时可将INSTALL_RPATH设置为系统库路径（如/usr/local/lib），避免依赖构建目录。

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