INSTALL_RPATH

用于已安装目标的 rpath。

默认情况下,安装 rpath 为空。可以使用此属性进行设置,该属性是一个分号分隔的列表,用于指定在已安装目标中使用的 rpath(对于支持它的平台)。如果在创建目标时设置了此属性,则会用变量 CMAKE_INSTALL_RPATH 的值初始化此属性。除了手动设置安装 rpath 外,还可以使用 INSTALL_RPATH_USE_LINK_PATH 目标属性自动生成安装 rpath。

在使用 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 生成器表达式相关。