CMake 3.4 發行說明

自 CMake 3.3 以來所做的變更包括以下內容。

新功能

產生器

• Visual Studio 14 2015 產生器學會了根據 CMAKE_SYSTEM_VERSION 變數的值和主機上可用的 SDK 來選擇 Windows 10 SDK。

• CMake 學會了對 Apple Swift 語言的基本支援。當使用 Xcode 產生器搭配 Xcode 6.1 或更高版本時，可以使用 enable_language() 命令或 project() 命令啟用 Swift 語言 (對於其他產生器或當 Xcode 太舊時，會發生錯誤)。然後，可以在編譯目標中列出 .swift 原始檔。

命令

• find_program() 命令學會了 NAMES_PER_DIR 選項，以便在移至下一個目錄之前考慮每個目錄中所有給定的 NAMES。

• get_filename_component() 命令學會了新的 BASE_DIR 子命令。這用於在從相對路徑計算絕對路徑時指定基本目錄。

• if() 命令學會了一個新的 TEST 運算子，如果給定的測試名稱已由 add_test() 命令定義，則該運算子會評估為 true。請參閱政策 CMP0064。

• install(DIRECTORY) 命令的 DESTINATION 選項學會了支援 產生器表達式。

• install(FILES) 命令的 DESTINATION 選項學會了支援 產生器表達式。

• string() 命令學會了新的 APPEND 子命令。

變數

• Makefile 產生器 和 Ninja 產生器學會了為 C 和 CXX 語言新增編譯器啟動工具，例如 distcc 和 ccache。詳細資訊請參閱 CMAKE_<LANG>_COMPILER_LAUNCHER 變數和 <LANG>_COMPILER_LAUNCHER 目標屬性。

• 引入了新的 CMAKE_LINK_SEARCH_START_STATIC 和 CMAKE_LINK_SEARCH_END_STATIC 變數，以分別初始化 LINK_SEARCH_START_STATIC 和 LINK_SEARCH_END_STATIC 目標屬性。

屬性

• Visual Studio 產生器 學會了支援其他目標屬性，以自訂 NVIDIA Nsight Tegra Visual Studio Edition 的專案。

  • ANDROID_ANT_ADDITIONAL_OPTIONS

  • ANDROID_ARCH

  • ANDROID_ASSETS_DIRECTORIES

  • ANDROID_JAR_DEPENDENCIES

  • ANDROID_JAR_DIRECTORIES

  • ANDROID_JAVA_SOURCE_DIR

  • ANDROID_NATIVE_LIB_DEPENDENCIES

  • ANDROID_NATIVE_LIB_DIRECTORIES

  • ANDROID_PROCESS_MAX

  • ANDROID_PROGUARD

  • ANDROID_PROGUARD_CONFIG_PATH

  • ANDROID_SECURE_PROPS_PATH

  • ANDROID_SKIP_ANT_STEP

  • ANDROID_STL_TYPE

• 目標屬性ARCHIVE_OUTPUT_DIRECTORY、LIBRARY_OUTPUT_DIRECTORY和RUNTIME_OUTPUT_DIRECTORY已學習支援產生器運算式。

• 引入了SOURCE_DIR和BINARY_DIR目標屬性，以允許專案程式碼查詢目標的定義位置。

• OUTPUT_NAME目標屬性及其變體已學習支援產生器運算式。

• 新增了TARGET_MESSAGES全域屬性，以告知Makefile 產生器是否要產生在每個目標完成後列印輸出的命令。

• 在 Windows 上使用 MS 相容工具時，CMake 已學習為SHARED程式庫選擇性地產生模組定義 (.def) 檔案。請參閱WINDOWS_EXPORT_ALL_SYMBOLS目標屬性。

模組

• ExternalProject模組的ExternalProject_Add()函式的GIT_SUBMODULES選項現在也會限制初始化的子模組集合，除了先前限制更新的子模組集合的行為外。

• ExternalProject模組學習了新的USES_TERMINAL引數，以授予步驟獨佔的終端機存取權。這對於Ninja產生器監控 CMake 超級建置進度並防止 CPU 過度訂閱非常有用。

• FindBISON模組的BISON_TARGET巨集學習了一個新的DEFINES_FILE選項，以指定要產生的自訂輸出標頭。

• FindHDF5模組學習了一個新的HDF5_PREFER_PARALLEL選項，允許使用者指定如果平行 HDF5 工具和非平行工具都可用，則優先選擇平行工具。

• FindIce模組現在提供匯入的目標。

• FindJava模組已學習選擇性地尋找idlj和jarsigner工具。

• FindOpenSSL模組現在提供匯入的目標。

• FindOpenSSL模組學習了一個新的OPENSSL_USE_STATIC_LIBS選項，只搜尋靜態程式庫。

• FindPkgConfig學習了一個新的pkg_get_variable()命令，可以用於查詢套件中的任意變數 (例如相關工具或資料和外掛程式安裝路徑)。

• FindProtobuf模組獲得了一個新的protobuf_generate_python()函式，可從.proto檔案產生 python 原始碼。

• FindTIFF模組已學習分別搜尋偵錯和發行變體。

• FindwxWidgets模組已學習支援版本要求。

• FindXercesC模組已學習分別搜尋偵錯和發行變體。

• FindZLIB模組已學習分別搜尋偵錯和發行變體。

• GNUInstallDirs模組已根據GNU 編碼標準和檔案系統階層標準學習某些安裝前置詞的特殊預設值。

• UseJava模組的add_jar函式已學習支援來源規格的回應檔 (例如@srcs.txt)。

• UseJava模組的install_jar函式已學習新的DESTINATION和COMPONENT選項，以指定相應的install()命令選項。

• UseJava模組獲得了一個新的create_javah函式，可以從 Java 類別建立 C 標頭。

產生器運算式

• 新增了一個新的$<SHELL_PATH:...> 產生器運算式。

CTest

• CTest 已學習在平行測試期間選擇性地測量 CPU 負載，並避免啟動可能導致負載超出給定臨界值的測試。請參閱ctest(1)命令的--test-load選項、CTest 測試步驟的TestLoad設定、CTEST_TEST_LOAD變數，以及ctest_test()命令的TEST_LOAD選項。

• ctest(1)已學習選項--test-output-size-passed和--test-output-size-failed，以自訂以儀表板用戶端身份執行時提交的測試輸出大小限制。

CPack

• CPack DEB 產生器已學習設定每個元件的套件相依性。請參閱變數

  • CPACK_DEBIAN_<COMPONENT>_PACKAGE_BREAKS

  • CPACK_DEBIAN_<COMPONENT>_PACKAGE_CONFLICTS

  • CPACK_DEBIAN_<COMPONENT>_PACKAGE_ENHANCES

  • CPACK_DEBIAN_<COMPONENT>_PACKAGE_PREDEPENDS

  • CPACK_DEBIAN_<COMPONENT>_PACKAGE_PROVIDES

  • CPACK_DEBIAN_<COMPONENT>_PACKAGE_RECOMMENDS

  • CPACK_DEBIAN_<COMPONENT>_PACKAGE_REPLACES

  • CPACK_DEBIAN_<COMPONENT>_PACKAGE_SUGGESTS

• CPack 模組現在可以打包空目錄。

• CPack 模組新增了一個設定 CPACK_VERBATIM_VARIABLES，可以用來確保 cpack 程式接收到的設定值與設定時完全相同，即使它們包含 CMake 特殊字元。為了相容性，預設是關閉的。

其他

• 編譯 特性 功能現在能識別 Windows 上 GNU C 編譯器支援的特性。

• CMake 現在能正確處理 MSVC 工具的 *.manifest 原始碼檔案。命名為 .exe 和 .dll 目標的來源的 Manifest 檔案將會與連結器產生的 manifest 合併，並嵌入到二進制文件中。

• 現在支援 Concurrent Fortran 77 編譯器。它的 編譯器 ID 為 CCur。

• cmake(1) 新增了一個 --trace-expand 命令列選項，功能類似於 --trace，但在輸出中會展開變數的引用。

已棄用和移除的功能

• CMakeExpandImportedTargets 模組現在被標示為已棄用。請參閱模組文件以獲取說明。

• CMAKE_USE_RELATIVE_PATHS 變數不再有任何作用。先前它只是部分實作且不可靠。

其他變更

• CheckFunctionExists、CheckLibraryExists、CheckSymbolExists 和 FindThreads 模組現在可以在僅啟用 CXX 的環境中運作。

• CPack DEB 產生器 現在在計算封裝的校驗和時，會正確地排除符號連結。

• CPack DEB 產生器 不再使用 fakeroot 和系統 tar 程式進行封裝。

• 當 CPack 模組的設定作為其他設定的預設值時，不再會混淆含有 CMake 特殊字元的設定。負責此行為的巨集 cpack_set_if_not_set 現在已棄用。

• 除非設定了 ENABLE_EXPORTS 目標屬性，否則 CMake 不再使用匯出符號的旗標來連結可執行檔。請參閱政策 CMP0065。

• 使用 add_library() 命令建立的 MODULE 函式庫不再設定 SONAME 欄位。MODULE 函式庫用於在執行時進行明確的動態載入。它們無法被連結，因此 SONAME 沒有用處。

• 內部 CMAKE_<LANG>_COMPILE_OBJECT 規則變數現在會將編譯器的包含旗標替換到獨立的 <INCLUDES> 佔位符，而不是主要 <FLAGS> 佔位符中。