LOCATION¶
磁碟上目標的唯讀位置。
對於匯入的目標,此唯讀屬性會傳回目標提供的未指定組態 <CONFIG>
的 LOCATION_<CONFIG>
屬性值。
對於非匯入的目標,提供此屬性是為了與 CMake 2.4 及更早版本相容。它原本是用於取得可執行目標的輸出檔位置,以便在 add_custom_command()
中使用。路徑可能包含建置系統特定的部分,該部分在建置時會被替換為正在建置的組態(例如 VS 中的 $(ConfigurationName)
)。在 CMake 2.6 及更高版本中,add_custom_command()
會在其 COMMAND
和 DEPENDS
選項中自動辨識目標名稱,並計算目標位置。在 CMake 2.8.4 及更高版本中,add_custom_command()
辨識 產生器 表達式
,以便在命令中的任何位置引用目標位置。因此,建立自訂命令不需要此屬性。
在讀取此屬性後,請勿設定會影響目標位置的屬性。這些屬性包括名稱與 (RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?
、(IMPLIB_)?(PREFIX|SUFFIX)
或 "LINKER_LANGUAGE" 相符的屬性。不遵守此規則不會被診斷出來,並會使目標的位置未定義。