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
。)
此属性支持 generator expressions
。
在 Apple 平台上,请参阅 INSTALL_NAME_DIR
目标属性。在 Windows 下,TARGET_RUNTIME_DLLS
生成器表达式是相关的。