vcpkg_configure_cmake

Konfigurieren Sie CMake für Debug- und Releasebuilds eines Projekts.

Verbrauch

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>...]
)

Parameter

SOURCE_PATH

Gibt das Verzeichnis an, das das Verzeichnis enthält.CMakeLists.txt Dies wird in der Regel in der Portdatei als Variable SOURCE_PATHfestgelegt.

PREFER_NINJA

Gibt an, dass vcpkg, wenn verfügbar, Ninja verwenden sollte, um den Build auszuführen. Dies sollte angegeben werden, es sei denn, der Port funktioniert nicht unter Ninja.

DISABLE_PARALLEL_CONFIGURE

Deaktiviert die Ausführung des CMake-Konfigurationsschritts parallel. Dies ist für Bibliotheken erforderlich, die während der Konfiguration wieder in ihr Quellverzeichnis schreiben.

Dadurch wird auch CMAKE_DISABLE_SOURCE_CHANGES deaktiviert.

NO_CHARSET_FLAG

Deaktiviert die Übergabe utf-8 als Standardzeichensatz an CMAKE_C_FLAGS und CMAKE_CXX_FLAGS.

Dies ist für Bibliotheken erforderlich, die den Zeichensatz ihres eigenen Quellcodes festlegen.

GENERATOR

Gibt den zu verwendenden genauen Generator an.

Dies ist nützlich, wenn ein projektspezifisches Buildsystem in ein cmake-Skript eingeschlossen wurde, das keinen tatsächlichen Build ausführt. Wenn sie für diesen Zweck verwendet wird, sollte sie auf "NMake Makefiles".

OPTIONEN

Zusätzliche Optionen, die während der Konfiguration an CMake übergeben wurden.

OPTIONS_RELEASE

Zusätzliche Optionen, die während der Releasekonfiguration an CMake übergeben wurden. Diese sind zusätzlich zu OPTIONS.

OPTIONS_DEBUG

Zusätzliche Optionen, die während der Debugkonfiguration an CMake übergeben werden. Diese sind zusätzlich zu OPTIONS.

MAYBE_UNUSED_VARIABLES

Alle CMake-Variablen, die explizit übergeben werden, die jedoch nicht auf allen Plattformen verwendet werden können. Zum Beispiel:

vcpkg_cmake_configure(
    ...
    OPTIONS
        -DBUILD_EXAMPLE=OFF
    ...
    MAYBE_UNUSED_VARIABLES
        BUILD_EXAMPLE
)

LOGNAME

Der Name des Protokolls, in das die Ausgabe des Configure-Aufrufs geschrieben werden soll.

Hinweise

Dieser Befehl stellt viele allgemeine Argumente für CMake bereit. Überprüfen Sie die Quelle, um die vollständige Liste anzuzeigen.

Quelle

scripts/cmake/vcpkg_configure_cmake.cmake