安装路径¶
用于已安装目标的 rpath。
默认情况下,安装 rpath 为空。它可以使用此属性进行设置,该属性是一个以分号分隔的列表,指定要在已安装目标中使用的 rpath(对于支持它的平台)。如果在创建目标时设置了此属性,则该属性由变量 CMAKE_INSTALL_RPATH 的值初始化。除了手动设置安装路径,使用 INSTALL_RPATH_USE_LINK_PATH 目标属性,它也可以由 CMake 自动生成。
通常 CMake 在使用 RPATH 的系统上构建可执行文件等时使用 RPATH 的构建树,请参阅 BUILD_RPATH 目标属性。安装软件后,CMake 会编辑(或重新链接)目标(请参阅 CMAKE_NO_BUILTIN_CHRPATH)以安装 RPATH。安装期间的这种编辑可以通过 BUILD_WITH_INSTALL_RPATH 目标属性来避免。
为了处理依赖于工具链的 RPATH 条目,可以使用 INSTALL_REMOVE_ENVIRONMENT_RPATH。可以通过 CMAKE_SKIP_RPATH 变量完全禁用运行时路径。
因为 rpath 可能包含 ${ORIGIN},这与 CMake 语法一致,INSTALL_RPATH 的内容在 cmake_install.cmake 脚本中被正确转义(参见策略:policy:CMP0095 .)
此属性支持 generator expressions。
在 Apple 平台上,请参考 INSTALL_NAME_DIR 目标属性。在 Windows 下, TARGET_RUNTIME_DLLS 生成器表达式是相关的。