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