INSTALL_RPATH¶
用于安装目标的 rpath。
默认情况下,安装 rpath 为空。它可以利用此属性进行设置,该属性是一个分号分隔的列表,用于指定安装目标中使用的 rpath(针对支持该特性的平台)。此属性由变量 CMAKE_INSTALL_RPATH 的值初始化(如果在创建目标时已设置该变量)。除了手动设置安装 rpath 外,还可以使用 INSTALL_RPATH_USE_LINK_PATH 目标属性,让 CMake 自动生成它。
通常,在支持 RPATH 的系统上构建可执行文件等时,CMake 会使用构建树中的 RPATH,请参阅 BUILD_RPATH 目标属性。当软件被安装时,目标会由 CMake 进行编辑(或重新链接)(参见 CMAKE_NO_BUILTIN_CHRPATH),以具备安装时的 RPATH。通过 BUILD_WITH_INSTALL_RPATH 目标属性,可以避免这种安装过程中的编辑。
对于处理依赖于工具链的 RPATH 条目,可以使用 INSTALL_REMOVE_ENVIRONMENT_RPATH。可以通过 CMAKE_SKIP_RPATH 变量完全禁用运行时路径。
由于 rpath 可能包含与 CMake 语法冲突的 ${ORIGIN},因此 INSTALL_RPATH 的内容会在 cmake_install.cmake 脚本中进行正确转义(参见策略 CMP0095)。
此属性支持 生成器表达式。
在 Apple 平台上,请参考 INSTALL_NAME_DIR 目标属性。在 Windows 下,TARGET_RUNTIME_DLLS 生成器表达式与之相关。