共用方式為

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。 若要查看完整清單，請檢查來源。

範例

來源

scripts/cmake/vcpkg_configure_cmake.cmake