如何配置CMake使用rpath而非完整路径链接依赖库？

我来帮你搞定这个问题——要让编译后的libexample.dylib中依赖库的路径以@rpath开头（而非绝对路径），可以通过调整CMake的几个关键rpath相关属性实现。结合你的示例代码，以下是修改方案和详细说明：

修改后的CMakeLists.txt #

cmake_minimum_required(VERSION 3.9)
project(example)

# 显式开启macOS的rpath支持（CMake 3.0+默认已开启，显式声明更清晰）
set(CMAKE_MACOSX_RPATH ON)

# 让构建阶段直接使用安装时的rpath配置，避免硬编码构建目录路径
set(BUILD_WITH_INSTALL_RPATH ON)

# 自定义rpath的搜索路径，根据你的部署结构调整即可
# 比如：可执行文件在bin目录，库在lib目录就用@executable_path/../lib
set(CMAKE_INSTALL_RPATH "@executable_path/../lib")

add_library(${PROJECT_NAME} SHARED)
target_link_libraries(${PROJECT_NAME} PUBLIC objc)
set_target_properties(${PROJECT_NAME} PROPERTIES LINKER_LANGUAGE CXX)

关键设置详解 #

• CMAKE_MACOSX_RPATH ON：这是启用macOS rpath机制的基础，确保CMake生成的二进制文件支持rpath路径引用。
• BUILD_WITH_INSTALL_RPATH ON：默认情况下，CMake会在构建阶段临时使用指向构建目录的rpath，开启这个选项后，构建阶段就会直接使用你指定的安装rpath，避免生成的库中包含构建目录的绝对路径。
• CMAKE_INSTALL_RPATH "@executable_path/../lib"：这里定义了dyld加载依赖库时的搜索路径，你可以根据实际部署需求修改——比如库和可执行文件在同一目录就设为@executable_path，库单独放在lib子目录就用@executable_path/../lib。

针对自定义依赖库的额外设置 #

如果你的example库链接的是你自己的自定义库（而非系统库如objc），为了让自定义库本身也被@rpath引用，还需要给自定义库添加以下属性：

set_target_properties(your_custom_lib PROPERTIES
    INSTALL_NAME_DIR "@rpath"
)

这样，编译后libexample.dylib中对your_custom_lib的依赖就会显示为@rpath/your_custom_lib.dylib，而非绝对路径。

验证效果 #

修改后重新编译，执行otool -L libexample.dylib，就能看到依赖库路径已变为@rpath开头的形式啦。

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