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