Mac环境下如何通过CMake设置RPATH实现应用自包含？

我在Mac平台使用CMake和CPack构建C++项目，需要将应用分发到不同配置的电脑上，因此希望实现应用自包含，让所有依赖库从$AppFolder/lib目录加载。

我尝试了以下配置：

install(FILES 
    "${HOMEBREW_PREFIX}/opt/openssl@3/lib/libssl.3.dylib" 
    "${HOMEBREW_PREFIX}/opt/openssl@3/lib/libcrypto.3.dylib" 
    "${HOMEBREW_PREFIX}/opt/libzip/lib/libzip.5.dylib"
    DESTINATION lib)


# Ensure libraries are relocated properly and binaries can run standalone
set(CMAKE_INSTALL_RPATH "$ORIGIN/../lib")
set(CMAKE_MACOSX_RPATH True)
set(CMAKE_FIND_FRAMEWORK NEVER)
set(CMAKE_FIND_APPBUNDLE NEVER)
set(CMAKE_FIND_USE_CMAKE_SYSTEM_PATH FALSE)
set(CMAKE_FIND_USE_SYSTEM_ENVIRONMENT_PATH FALSE)

但二进制文件仍链接到原始Homebrew路径，在未安装Homebrew的电脑上运行失败。执行otool -L MyApplication的输出如下：

otool -L MyApplication

/opt/brew/opt/openssl@3/lib/libssl.3.dylib (compatibility version 3.0.0, current version 3.0.0)
/opt/brew/opt/openssl@3/lib/libcrypto.3.dylib (compatibility version 3.0.0, current version 3.0.0)
/opt/brew/opt/libzip/lib/libzip.5.dylib (compatibility version 5.0.0, current version 5.5.0)

请问如何无需在每台电脑重新构建，即可实现应用完全自包含？

问题核心是只设置了RPATH，但未修改已安装库和二进制文件的install name（Mac特有的库路径标识）。需要在CMake中添加路径修复步骤，确保所有依赖指向应用内的lib目录。

1. 调整CMake配置，自动修复路径 #

在CMakeLists.txt中补充以下配置，覆盖编译和安装阶段的路径规则：

# 开启RPATH支持并保留安装后的RPATH
set(CMAKE_MACOSX_RPATH ON)
set(CMAKE_INSTALL_RPATH_USE_LINK_PATH TRUE)
# 设置应用的RPATH指向相对路径（适配App Bundle结构）
set(CMAKE_INSTALL_RPATH "@executable_path/../lib")

# 定义函数：修复依赖库自身的install name
function(fix_lib_install_name lib_path)
    get_filename_component(lib_name "${lib_path}" NAME)
    install(CODE "execute_process(
        COMMAND install_name_tool -id \"@rpath/${lib_name}\" \"\$ENV{DESTDIR}\${CMAKE_INSTALL_PREFIX}/lib/${lib_name}\"
    )")
endfunction()

# 安装依赖库并修复它们的install name
install(FILES 
    "${HOMEBREW_PREFIX}/opt/openssl@3/lib/libssl.3.dylib" 
    "${HOMEBREW_PREFIX}/opt/openssl@3/lib/libcrypto.3.dylib" 
    "${HOMEBREW_PREFIX}/opt/libzip/lib/libzip.5.dylib"
    DESTINATION lib)

fix_lib_install_name("${HOMEBREW_PREFIX}/opt/openssl@3/lib/libssl.3.dylib")
fix_lib_install_name("${HOMEBREW_PREFIX}/opt/openssl@3/lib/libcrypto.3.dylib")
fix_lib_install_name("${HOMEBREW_PREFIX}/opt/libzip/lib/libzip.5.dylib")

# 修复主二进制文件中的依赖路径
install(CODE "execute_process(
    COMMAND install_name_tool -change \"/opt/brew/opt/openssl@3/lib/libssl.3.dylib\" \"@rpath/libssl.3.dylib\" \"\$ENV{DESTDIR}\${CMAKE_INSTALL_PREFIX}/bin/MyApplication\"
    COMMAND install_name_tool -change \"/opt/brew/opt/openssl@3/lib/libcrypto.3.dylib\" \"@rpath/libcrypto.3.dylib\" \"\$ENV{DESTDIR}\${CMAKE_INSTALL_PREFIX}/bin/MyApplication\"
    COMMAND install_name_tool -change \"/opt/brew/opt/libzip/lib/libzip.5.dylib\" \"@rpath/libzip.5.dylib\" \"\$ENV{DESTDIR}\${CMAKE_INSTALL_PREFIX}/bin/MyApplication\"
)")

2. 验证修复效果 #

构建并安装项目后，进入安装目录执行以下命令：

otool -L bin/MyApplication
otool -L lib/libssl.3.dylib

正常输出中，所有依赖路径应变为@rpath/libxxx.dylib格式，而非原始的Homebrew绝对路径。

3. 配置CPack打包 #

确保CPack包含bin和lib目录，生成可分发的安装包：

set(CPACK_GENERATOR "DragNDrop") # Mac常用的拖拽式安装包
set(CPACK_PACKAGE_NAME "MyApplication")
set(CPACK_PACKAGE_VERSION "1.0.0")
include(CPack)

关键说明 #

• install_name_tool是Mac平台专属工具，用于修改二进制文件和库的路径标识，必须在安装阶段执行（此时才能确定文件最终位置）。
• @rpath是RPATH的占位符，会被替换为@executable_path/../lib，指向应用同级的lib目录。
• 依赖库之间的相互引用（比如libssl依赖libcrypto），在修复各自的install name后，会自动使用@rpath，无需额外处理。

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