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 会导致构建树中的二进制文件使用安装树运行时路径进行构建。