CheckOBJCSourceRuns

加入於版本 3.16。

檢查給定的 Objective-C 原始碼是否可以編譯並連結成可執行檔,並隨後執行。

check_objc_source_runs
check_objc_source_runs(<code> <resultVar>)

檢查一次在 <code> 中提供的原始碼是否可以被建置、連結為可執行檔,然後執行。<code> 必須至少包含一個 main() 函數。

結果儲存在由 <resultVar> 指定的內部快取變數中。建置和執行的成功以布林值 true 表示。建置或執行失敗以布林值 false 表示,例如空字串或錯誤訊息。

另請參閱 check_source_runs() 以取得更通用的命令語法。

編譯和連結命令可以透過在呼叫 check_objc_source_runs() 之前設定以下任何變數來影響:

CMAKE_REQUIRED_FLAGS

要傳遞給編譯器的其他旗標字串。該字串必須以空格分隔——;-列表 將不起作用。CMAKE_<LANG>_FLAGS 及其相關的特定配置變數的內容會自動新增到編譯器命令中,在 CMAKE_REQUIRED_FLAGS 的內容之前。

CMAKE_REQUIRED_DEFINITIONS

形式為 -DFOO-DFOO=bar 的編譯器定義的 ;-列表。也會自動新增由 <resultVar> 指定的名稱的定義。

CMAKE_REQUIRED_INCLUDES

要傳遞給編譯器的標頭搜尋路徑的 ;-列表。這些將是唯一使用的標頭搜尋路徑——INCLUDE_DIRECTORIES 目錄屬性的內容將被忽略。

CMAKE_REQUIRED_LINK_OPTIONS

加入於版本 3.14。

要新增到連結命令的選項的 ;-列表 (請參閱 try_compile() 以取得更多詳細資訊)。

CMAKE_REQUIRED_LIBRARIES

要新增到連結命令的程式庫的 ;-列表。這些可以是系統程式庫的名稱,也可以是 已匯入目標 (請參閱 try_compile() 以取得更多詳細資訊)。

CMAKE_REQUIRED_LINK_DIRECTORIES

加入於版本 3.31。

要傳遞給連結器的程式庫搜尋路徑的 ;-列表 (請參閱 try_compile() 以取得更多詳細資訊)。

CMAKE_REQUIRED_QUIET

加入於版本 3.1。

如果此變數評估為布林值 true,則將會隱藏與檢查相關的所有狀態訊息。