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 可能包含 ${ORIGIN},這與 CMake 語法一致,因此 INSTALL_RPATH 的內容在 cmake_install.cmake 指令碼中被正確地逸出 (請參閱政策 CMP0095)。

此屬性支援 generator expressions

在 Apple 平台上,請參閱 INSTALL_NAME_DIR 目標屬性。在 Windows 下,TARGET_RUNTIME_DLLS 產生器運算式是相關的。