vcpkg_install_msbuild

Article
01/10/2024

Avertissement

Cette fonction a été déconseillée en faveur de vcpkg_msbuild_install.

Générez et installez un projet msbuild. Ceci remplace vcpkg_build_msbuild().

Utilisation

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

Paramètres

SOURCE_PATH

Chemin d’accès à la racine de l’arborescence source.

Étant donné que MSBuild utilise des builds in source, l’arborescence source est copiée dans un emplacement temporaire pour la build. Ce paramètre est la base de cette copie et forme la base de toutes les options de XYZ_SUBPATH.

USE_VCPKG_INTEGRATION

Appliquez l’intégration normale integrate install pour la création du projet.

Par défaut, les projets générés avec cette commande ne relient pas automatiquement les bibliothèques ou n’ont pas de chemins d’en-tête définis.

PROJECT_SUBPATH

Sous-chemin vers le fichier de solution (.sln) ou de projet (.vcxproj) par rapport à SOURCE_PATH.

LICENSE_SUBPATH

Sous-chemin du fichier de licence relatif à SOURCE_PATH.

INCLUDES_SUBPATH

Sous-chemin d’accès au répertoire inclus par rapport à SOURCE_PATH.

Ce paramètre doit être un répertoire et ne doit pas se terminer par une barre oblique de fin.

ALLOW_ROOT_INCLUDES

Indique que les fichiers include de niveau supérieur (par exemple include/zlib.h) doivent être autorisés.

REMOVE_ROOT_INCLUDES

Indique que les fichiers include de niveau supérieur (par exemple include/Makefile.am) doivent être supprimés.

SKIP_CLEAN

Indique que les fichiers intermédiaires ne doivent pas être supprimés.

Les ports utilisant cette option doivent ultérieurement appeler vcpkg_clean_msbuild() pour propre manuellement.

RELEASE_CONFIGURATION

Configuration (/p:Configuration paramètre msbuild) utilisée pour les builds Release.

DEBUG_CONFIGURATION

Configuration (/p:Configuration paramètre msbuild) utilisée pour les builds de débogage.

TARGET_PLATFORM_VERSION

WindowsTargetPlatformVersion (/p:WindowsTargetPlatformVersion paramètre msbuild).

TARGET

Cible MSBuild à générer (/t:<TARGET>).

PLATEFORME

Plateforme (/p:Platform paramètre msbuild) utilisée pour la build.

Cela correspond par défaut à un mappage VCPKG_TARGET_ARCHITECTURE de valeurs aux valeurs par défaut que Visual Studio utilise lors de la création d’un .vcxproj:

x86 devient Win32
x64 devient x64
arm devient ARM
arm64 devient arm64

Lors de la transmission d’un .sln plutôt qu’un .vcxproj, il peut être nécessaire de revenir en arrière pour correspondre aux ${VCPKG_TARGET_ARCHITECTURE} chaînes de plateforme utilisées par les solutions.

PLATFORM_TOOLSET

Ensemble d’outils de plateforme (/p:PlatformToolset paramètre msbuild) utilisé pour la build.

OPTIONS

Options supplémentaires passées à msbuild pour toutes les builds.

OPTIONS_RELEASE

Options supplémentaires passées à msbuild pour les builds Release. Ils sont en plus de OPTIONS.

OPTIONS_DEBUG

Options supplémentaires passées à msbuild pour les builds de débogage. Ils sont en plus de OPTIONS.

Source

scripts/cmake/vcpkg_install_msbuild.cmake

Partager via