Partager via


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 chemins de ports de superposition supplémentaires considérés après ceux répertoriés sur la ligne de commande. Répertorier les chemins d’accès aux superpositions à l’aide du séparateur PATH dépendant de la plateforme (Windows ; | autres :)

Exemple (Windows) : C:\custom-ports\boost;C:\custom-ports\sqlite3

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.