BUILD_RPATH

版本 3.8 新增。

一个分号分隔的列表,指定要添加到构建树中二进制文件的运行时路径(RPATH)条目(适用于支持此功能的平台)。默认情况下,CMake 会将构建树中二进制文件的运行时路径设置为包含它知道查找它们链接的共享库所需的搜索路径。项目可以通过设置 BUILD_RPATH 来指定额外的搜索路径。

构建树运行时路径不会用于安装树中的二进制文件。在安装步骤中,它将被安装树运行时路径替换。另请参阅 INSTALL_RPATH 目标属性。

此属性由变量 CMAKE_BUILD_RPATH 的值初始化,如果该变量在创建目标时已设置。

此属性支持 生成器表达式

其他影响构建树运行时路径的设置包括:

  • 变量 CMAKE_SKIP_RPATH 完全禁用构建树和安装树中的运行时路径。

  • 目标属性 SKIP_BUILD_RPATH 禁用在构建树中设置任何运行时路径。

  • 目标属性 BUILD_RPATH_USE_ORIGIN 导致自动生成的运行时路径使用相对于 $ORIGIN 的条目。

  • 目标属性 BUILD_WITH_INSTALL_RPATH 导致构建树中的二进制文件使用安装树运行时路径进行构建。