位置¶
目標在磁碟上的唯讀位置。
對於匯入的目標,此唯讀屬性會傳回目標提供的未指定組態 <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()
識別 generator expressions
,以便在命令中的任何位置參照目標位置。因此,不需要此屬性來建立自訂命令。
請勿在讀取此屬性後設定會影響目標位置的屬性。這些包括名稱符合 (RUNTIME|LIBRARY|ARCHIVE)_OUTPUT_(NAME|DIRECTORY)(_<CONFIG>)?
、(IMPLIB_)?(PREFIX|SUFFIX)
或 "LINKER_LANGUAGE" 的屬性。若不遵守此規則,將不會診斷出來,且會使目標的位置未定義。