vcpkg_msbuild_install

Article
01/10/2024

Générez et installez un projet MSBuild.

Cette fonction remplace vcpkg_install_msbuild.

vcpkg_msbuild_install génère un fichier de propriétés et un fichier cible contenant les indicateurs de génération de chaîne d’outils CMake et l’inclut via /p:ForceImportAfterCpp(Props|Targets)

Utilisation

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

Pour utiliser cette fonction, vous devez dépendre du port vcpkg-msbuildd’assistance :

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

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.

PROJECT_SUBPATH

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

ADD_BIN_TO_PATH

Ajoute le chemin binaire dépendant de la configuration à la variable d’environnement PATH avant la génération. Cela est nécessaire pour exécuter des outils générés par le projet lui-même. La PATH variable d’environnement n’est pas mutée si VCPKG_CROSSCOMPILING elle est true

NO_TOOLCHAIN_PROPS

Ne générez pas les propriétés de la chaîne d’outils via cmake. Cela désactive automatiquement toute intégration vcpkg.

NO_INSTALL

N’essayez pas automatiquement d’installer .lib|. dll|. pdb|. fichiers exe trouvés dans le dir de build.

PROPRE

Indique que les fichiers intermédiaires doivent être supprimés après l’installation.

RELEASE_CONFIGURATION

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

DEBUG_CONFIGURATION

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

TARGET

Cible MSBuild à générer (/t:<TARGET>). Valeurs par défaut : Rebuild

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.

OPTIONS

Options supplémentaires à passer à 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.

DEPENDENT_PKGCONFIG

Liste des pkg-config dépendances à ajouter à la build. Cela ajoute tous les indicateurs de build requis (inclut/définitions/bibliothèques) aux propriétés de build.

ADDITIONAL_LIBS

Bibliothèques supplémentaires à ajouter au projet.

ADDITIONAL_LIBS_DEBUG

Bibliothèques supplémentaires à ajouter à msbuild pour les builds Release. Ils sont en plus de ADDITIONAL_LIBS.

ADDITIONAL_LIBS_RELEASE

Bibliothèques supplémentaires à ajouter à msbuild pour les builds de débogage. Ils sont en plus de ADDITIONAL_LIBS.

Source

ports/vcpkg-msbuild/vcpkg_msbuild_install.cmake

Partager via