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
產生器運算式是相關的。