vcpkg_configure_cmake
警告
此函式已被取代為 vcpkg_cmake_configure
。。
針對專案的偵錯和發行組建設定 CMake。
使用方式
vcpkg_configure_cmake(
SOURCE_PATH <${SOURCE_PATH}>
[PREFER_NINJA]
[DISABLE_PARALLEL_CONFIGURE]
[NO_CHARSET_FLAG]
[GENERATOR <"NMake Makefiles">]
[OPTIONS <-DUSE_THIS_IN_ALL_BUILDS=1>...]
[OPTIONS_RELEASE <-DOPTIMIZE=1>...]
[OPTIONS_DEBUG <-DDEBUGGABLE=1>...]
[MAYBE_UNUSED_VARIABLES <OPTION_NAME>...]
)
參數
SOURCE_PATH
指定包含的 CMakeLists.txt
目錄。
依照慣例,這通常會在 portfile 中設定為 變數 SOURCE_PATH
。
PREFER_NINJA
指出,當可用時,vcpkg 應該使用 Ninja 來執行組建。 除非已知埠無法在 Ninja 下運作,否則應該指定此專案。
DISABLE_PARALLEL_CONFIGURE
停用平行執行 CMake 設定步驟。 這是在設定期間回寫至其來源目錄的連結庫所需的專案。
這也會停用CMAKE_DISABLE_SOURCE_CHANGES。
NO_CHARSET_FLAG
停用當做預設字元集傳遞 utf-8
至 CMAKE_C_FLAGS
和 CMAKE_CXX_FLAGS
。
這是設定自己原始程式碼字元集的連結庫所需的。
發電機
指定要使用的精確產生器。
如果某些專案特定的組建系統已包裝在不會執行實際建置的 Cmake 腳本中,這會很有用。
如果用於此目的,它應該設定為 "NMake Makefiles"
。
OPTIONS
在設定期間傳遞至 CMake 的其他選項。
OPTIONS_RELEASE
在發行組態期間傳遞至 CMake 的其他選項。 這些是 除了 OPTIONS
。
OPTIONS_DEBUG
在偵錯組態期間傳遞至 CMake 的其他選項。 這些是 除了 OPTIONS
。
MAYBE_UNUSED_VARIABLES
明確傳入但可能無法在所有平臺上使用的任何 CMake 變數。 例如:
vcpkg_cmake_configure(
...
OPTIONS
-DBUILD_EXAMPLE=OFF
...
MAYBE_UNUSED_VARIABLES
BUILD_EXAMPLE
)
LOGNAME
要寫入設定呼叫之輸出的記錄檔名稱。
備註
此命令提供許多常見的自變數給 CMake。 若要查看完整清單,請檢查來源。