vcpkg_install_msbuild

Artikel
01/10/2024

Warnung

Diese Funktion wurde zugunsten von vcpkg_msbuild_install.

Erstellen und installieren Sie ein msbuild-basiertes Projekt. Hierdurch wird vcpkg_build_msbuild() ersetzt.

Verwendung

vcpkg_install_msbuild(
    SOURCE_PATH <${SOURCE_PATH}>
    PROJECT_SUBPATH <port.sln>
    [INCLUDES_SUBPATH <include>]
    [LICENSE_SUBPATH <LICENSE>]
    [RELEASE_CONFIGURATION <Release>]
    [DEBUG_CONFIGURATION <Debug>]
    [TARGET <Build>]
    [TARGET_PLATFORM_VERSION <10.0.15063.0>]
    [PLATFORM <Win32>]
    [PLATFORM_TOOLSET <v143>]
    [OPTIONS </p:ZLIB_INCLUDE_PATH=X>...]
    [OPTIONS_RELEASE </p:ZLIB_LIB=X>...]
    [OPTIONS_DEBUG </p:ZLIB_LIB=X>...]
    [USE_VCPKG_INTEGRATION]
    [ALLOW_ROOT_INCLUDES | REMOVE_ROOT_INCLUDES]
)

Parameter

SOURCE_PATH

Der Pfad zum Stamm der Quellstruktur.

Da MSBuild In-Source-Builds verwendet, wird die Quellstruktur an einen temporären Speicherort für den Build kopiert. Dieser Parameter ist die Basis für diese Kopie und bildet die Basis für alle XYZ_SUBPATH Optionen.

USE_VCPKG_INTEGRATION

Wenden Sie die normale integrate install Integration für das Erstellen des Projekts an.

Standardmäßig werden projekte, die mit diesem Befehl erstellt wurden, keine Bibliotheken automatisch verknüpfen oder Kopfzeilenpfade festgelegt.

PROJECT_SUBPATH

Der Unterpfad zur Projektmappe (.sln) oder Projektdatei (.vcxproj) relativ zu SOURCE_PATH.

LICENSE_SUBPATH

Der Unterpfad zur Lizenzdatei relativ zu SOURCE_PATH.

INCLUDES_SUBPATH

Der Unterpfad zum enthaltenden Verzeichnis relativ zu SOURCE_PATH.

Dieser Parameter sollte ein Verzeichnis sein und sollte nicht in einem nachgestellten Schrägstrich enden.

ALLOW_ROOT_INCLUDES

Gibt an, dass Dateien auf oberster Ebene (z. B. include/zlib.h) zulässig sein sollten.

REMOVE_ROOT_INCLUDES

Gibt an, dass Dateien auf oberster Ebene (z. B. include/Makefile.am) entfernt werden sollen.

SKIP_CLEAN

Gibt an, dass die Zwischendateien nicht entfernt werden sollen.

Ports, die diese Option verwenden, sollten später aufgerufen vcpkg_clean_msbuild() werden, um manuell sauber.

RELEASE_CONFIGURATION

Die konfiguration (/p:Configuration msbuild-Parameter), die für Releasebuild-Builds verwendet wird.

DEBUG_CONFIGURATION

Die Für Debugbuild-Builds verwendete Konfiguration (/p:Configuration msbuild-Parameter).

TARGET_PLATFORM_VERSION

Die WindowsTargetPlatformVersion (/p:WindowsTargetPlatformVersion msbuild-Parameter).

TARGET

Das ZU erstellende MSBuild-Ziel (/t:<TARGET>).

PLATTFORM

Die für den Build verwendete Plattform (/p:Platform msbuild-Parameter).

Dadurch wird standardmäßig eine Wertzuordnung VCPKG_TARGET_ARCHITECTURE zu den Standardwerten verwendet, die visual Studio beim Erstellen eines .vcxproj:

x86 wird zu Win32
x64 wird zu x64
arm wird zu ARM
arm64 wird zu arm64

Bei der Übergabe eines .sln Anstelles .vcxprojmuss dies möglicherweise auf die von Lösungen verwendeten Plattformzeichenfolgen zurückgesetzt ${VCPKG_TARGET_ARCHITECTURE} werden.

PLATFORM_TOOLSET

Das plattformtoolset (/p:PlatformToolset msbuild-Parameter), das für den Build verwendet wird.

OPTIONEN

Zusätzliche Optionen, die an msbuild für alle Builds übergeben wurden.

OPTIONS_RELEASE

Zusätzliche Optionen, die an msbuild für Releasebuilds übergeben wurden. Diese sind zusätzlich zu OPTIONS.

OPTIONS_DEBUG

Weitere Optionen, die an msbuild für Debugbuild-Builds übergeben wurden. Diese sind zusätzlich zu OPTIONS.

Quelle

scripts/cmake/vcpkg_install_msbuild.cmake

Freigeben über