INSTALL_RPATH

用於已安裝目標的 rpath。

預設情況下,安裝 rpath 是空的。可以使用此屬性來設定它,該屬性是一個以分號分隔的清單,指定用於已安裝目標的 rpath(適用於支援它的平台)。如果目標建立時設定了變數 CMAKE_INSTALL_RPATH,則此屬性會由此變數的值初始化。除了手動設定安裝 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 腳本中正確逸出(請參閱政策 CMP0095)。

此屬性支援 產生器 運算式

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