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 生成器表达式与此相关。