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