LOCATION

磁碟上目標的唯讀位置。

對於匯入的目標,此唯讀屬性會傳回目標提供的未指定組態 <CONFIG>LOCATION_<CONFIG> 屬性值。

對於非匯入的目標,提供此屬性是為了與 CMake 2.4 及更早版本相容。它原本是用於取得可執行目標的輸出檔位置,以便在 add_custom_command() 中使用。路徑可能包含建置系統特定的部分,該部分在建置時會被替換為正在建置的組態(例如 VS 中的 $(ConfigurationName))。在 CMake 2.6 及更高版本中,add_custom_command() 會在其 COMMANDDEPENDS 選項中自動辨識目標名稱,並計算目標位置。在 CMake 2.8.4 及更高版本中,add_custom_command() 辨識 產生器 表達式,以便在命令中的任何位置引用目標位置。因此,建立自訂命令不需要此屬性。

在讀取此屬性後,請勿設定會影響目標位置的屬性。這些屬性包括名稱與 (RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?(IMPLIB_)?(PREFIX|SUFFIX) 或 "LINKER_LANGUAGE" 相符的屬性。不遵守此規則不會被診斷出來,並會使目標的位置未定義。