Variables d’environnement
VCPKG_DOWNLOADS
Cette variable d’environnement peut être définie sur un répertoire existant à utiliser pour stocker des téléchargements au lieu du répertoire interne downloads/
. Elle doit toujours être définie sur un chemin absolu.
VCPKG_FEATURE_FLAGS
Cette variable d’environnement peut être définie sur une liste séparée par des virgules des fonctionnalités désactivées par défaut dans vcpkg. Ces fonctionnalités sont susceptibles de changer sans préavis et doivent être considérées comme hautement instables.
Il n’existe aucun indicateur de fonctionnalité désactivé par défaut pour l’instant.
ÉDITEUR
Cette variable d’environnement peut être définie sur le chemin d’accès complet d’un exécutable à utiliser pour vcpkg edit
. vcpkg help edit
Consultez l’aide spécifique à la commande.
VCPKG_ROOT
Cette variable d’environnement peut être définie sur un répertoire à utiliser comme racine de l’instance vcpkg. Cela sera utilisé uniquement si l’exécutable vcpkg n’est pas situé dans une racine valide et que le commutateur --vcpkg-root
de ligne de commande n’est pas utilisé.
VCPKG_VISUAL_STUDIO_PATH
Cette variable d’environnement peut être définie sur le chemin complet d’une instance Visual Studio sur l’ordinateur. Cette instance de Visual Studio sera utilisée si le triplet ne le remplace pas via le paramètre triplet VCPKG_VISUAL_STUDIO_PATH
.
Exemple : D:\2017
VCPKG_DEFAULT_TRIPLET
Cette variable d’environnement peut être définie sur un nom triplet qui sera utilisé pour les références triplet non qualifiées dans les lignes de commande.
VCPKG_DEFAULT_HOST_TRIPLET
Cette variable d’environnement peut être définie sur un nom triplet qui sera utilisé pour les références de port hôte non qualifiées dans les lignes de commande et toutes les références de port hôte dans les listes de dépendances. Pour plus d’informations, consultez la documentation sur les dépendances de l’hôte.
VCPKG_OVERLAY_PORTS
Cette variable d’environnement ajoute des ports de superposition supplémentaires ou des répertoires de ports de superposition considérés après ceux répertoriés sur la ligne de commande. Plusieurs valeurs sont séparées par le séparateur PATH dépendant de la plateforme (Windows ;
| autres :
)
Exemple (Windows) : C:\custom-ports\boost;C:\custom-ports\sqlite3;C:\other-ports
VCPKG_OVERLAY_TRIPLETS
Cette variable d’environnement permet aux utilisateurs d’ajouter des répertoires pour rechercher des triplets.
Répertorier les chemins d’accès aux superpositions à l’aide du séparateur PATH dépendant de la plateforme (Windows ;
, autres :
)
Voir exemple : triplets de superposition pour un exemple.
VCPKG_FORCE_SYSTEM_BINARIES
Cette variable d’environnement, si elle est définie, supprime le téléchargement de CMake et Ninja et force l’utilisation des fichiers binaires système.
VCPKG_FORCE_DOWNLOADED_BINARIES
Cette variable d’environnement, si elle est définie, ignore l’utilisation des fichiers binaires système et télécharge et utilise toujours la version définie par vcpkg.
VCPKG_KEEP_ENV_VARS
Cette variable d’environnement peut être définie sur une liste de variables d’environnement, séparées par ;
, qui seront propagées à l’environnement de génération.
Les valeurs des variables conservées ne sont pas suivies dans les API de package et ne provoquent pas de reconstructions lorsqu’elles changent. Pour transmettre des variables d’environnement qui doivent provoquer des reconstructions lors de la modification, consultez VCPKG_ENV_PASSTHROUGH
.
Exemple : FOO_SDK_DIR;BAR_SDK_DIR
VCPKG_MAX_CONCURRENCY
Ces variables d’environnement limitent la quantité d’accès concurrentiel utilisée par les systèmes de build sous-jacents. S’il n’est pas spécifié, cela est défini par défaut sur des cœurs logiques + 1.
VCPKG_DEFAULT_BINARY_CACHE
Cette variable d’environnement redirige l’emplacement par défaut pour stocker des packages binaires. Pour plus d’informations, consultez mise en cache binaire.
VCPKG_BINARY_SOURCES
Cette variable d’environnement ajoute ou supprime des sources binaires. Pour plus d’informations, consultez mise en cache binaire.
VCPKG_NUGET_REPOSITORY
Cette variable d’environnement modifie les métadonnées des packages NuGet produits. Pour plus d’informations, consultez mise en cache binaire.
VCPKG_USE_NUGET_CACHE
Cette variable d’environnement permet d’utiliser le cache de NuGet pour chaque source binaire nuget. Pour plus d’informations, consultez mise en cache binaire.
X_VCPKG_NUGET_PREFIX
Ajoute un préfixe au nom de tous les packages binaires envoyés ou restaurés à partir de caches binaires NuGet.
Par exemple, quand X_VCPKG_NUGET_PREFIX
est défini sur vcpkg_demo-
la valeur zlib_x64-windows.1.2.13-vcpkg8918746ce8b60474e5ebe68e53355fa70eb05119be913a1d1dc0b930b3b7b6e8.nupkg
le package binaire devient vcpkg_demo-zlib_x64-windows.1.2.13-vcpkg8918746ce8b60474e5ebe68e53355fa70eb05119be913a1d1dc0b930b3b7b6e8.nupkg
.
X_VCPKG_ASSET_SOURCES
Remarque
Cette section décrit une fonctionnalité expérimentale de vcpkg qui peut changer ou être supprimée à tout moment.
Cette variable d’environnement permet d’utiliser un miroir privé pour toutes les ressources avec balises SHA512. Pour plus d’informations, consultez La mise en cache des ressources.
VCPKG_NO_CI
Le paramètre VCPKG_NO_CI
désactive les heuristiques de détection d’environnement CI de vcpkg.
VSLANG
Cette variable d’environnement définit le langage utilisé par vcpkg pour afficher les messages. Elle doit être définie sur l’une des 14 LCID prises en charge (identificateur de paramètres régionaux, valeur de 4 octets correspondant à une langue).
Par exemple : 1033 correspond à la langue anglaise (ÉTATS-Unis). Pour obtenir la liste complète des LCID pris en charge, consultez Localisation.
ACTIONS_CACHE_URL
Cette variable d’environnement est l’URL du cache GitHub Actions. Pour plus d’informations, consultez mise en cache binaire.
ACTIONS_RUNTIME_TOKEN
Cette variable d’environnement est le jeton d’accès au cache GitHub Actions. Pour plus d’informations, consultez mise en cache binaire.