INSTALL_RPATH

用于已安装目标的 rpath。

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

通常,在支持 RPATH 的系统上生成可执行文件等时,CMake 使用构建树中的 RPATH,请参阅 BUILD_RPATH 目标属性。当软件安装时,目标会被 CMake 编辑(或重新链接)(请参阅 CMAKE_NO_BUILTIN_CHRPATH)以包含 install 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 生成器表达式与之相关。