vcpkg_msbuild_install

Artikel
01/10/2024

Erstellen und installieren Sie ein MSBuild-Projekt.

Diese Funktion ersetzt vcpkg_install_msbuild.

vcpkg_msbuild_install generiert eine Props-Datei und Zieldatei mit den CMake-Toolchain-Build-Flags und schließt sie über /p:ForceImportAfterCpp(Props|Targets)

Verwendung

vcpkg_install_msbuild(
    SOURCE_PATH <${SOURCE_PATH}>
    PROJECT_SUBPATH <port.sln>
    [ADD_BIN_TO_PATH]
    [NO_INSTALL]
    [NO_TOOLCHAIN_PROPS]
    [CLEAN]
    [RELEASE_CONFIGURATION <Release>]
    [DEBUG_CONFIGURATION <Debug>]
    [TARGET <Build>]
    [PLATFORM <Win32>]
    [OPTIONS </p:ZLIB_INCLUDE_PATH=X>...]
    [OPTIONS_RELEASE </p:ZLIB_LIB=X>...]
    [OPTIONS_DEBUG </p:ZLIB_LIB=X>...]
    [DEPENDENT_PKGCONFIG <zlib>]
    [ADDITIONAL_LIBS <getopt.lib>]
    [ADDITIONAL_LIBS_DEBUG <zlibd.lib>]
    [ADDITIONAL_LIBS_RELEASE <zlib.lib>]
)

Um diese Funktion zu verwenden, müssen Sie vom Hilfsport vcpkg-msbuildabhängig sein:

"dependencies": [
  { 
    "name": "vcpkg-msbuild",
    "host": true
  }
]

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.

PROJECT_SUBPATH

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

ADD_BIN_TO_PATH

Fügt vor dem Build den konfigurationsabhängigen binären Pfad zur PATH Umgebungsvariable hinzu. Dies ist erforderlich, um tools auszuführen, die vom Projekt selbst erstellt wurden. Die PATH Umgebungsvariable wird bei Bedarf VCPKG_CROSSCOMPILING nicht stummgeschaltet. true

NO_TOOLCHAIN_PROPS

Generieren Sie die Eigenschaften der Toolkette nicht über cmake. Dadurch werden alle vcpkg-Integrationen automatisch deaktiviert.

NO_INSTALL

Versuchen Sie nicht automatisch, .lib|zu installieren. dll|. pdb|. exe Dateien im Build dir gefunden.

SAUBER

Gibt an, dass die Zwischendateien nach der Installation entfernt werden sollen.

RELEASE_CONFIGURATION

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

DEBUG_CONFIGURATION

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

TARGET

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

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.

OPTIONEN

Zusätzliche Optionen zum Übergeben an MSBuild für alle Builds.

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.

DEPENDENT_PKGCONFIG

Eine Liste der pkg-config Abhängigkeiten, die dem Build hinzugefügt werden sollen. Dadurch werden den Buildeigenschaften alle erforderlichen Buildkennzeichen (einschließlich/Definitionen/Bibliotheken) hinzugefügt.

ADDITIONAL_LIBS

Weitere Bibliotheken, die dem Projekt hinzugefügt werden sollen.

ADDITIONAL_LIBS_DEBUG

Zusätzliche Bibliotheken, die msbuild für Release-Builds hinzugefügt werden sollen. Diese sind zusätzlich zu ADDITIONAL_LIBS.

ADDITIONAL_LIBS_RELEASE

Zusätzliche Bibliotheken, die msbuild für Debugbuild-Builds hinzugefügt werden sollen. Diese sind zusätzlich zu ADDITIONAL_LIBS.

Quelle

ports/vcpkg-msbuild/vcpkg_msbuild_install.cmake

Freigeben über