Partager via

vcpkg env

  • Article

Synopsis

Remarque

Cette commande est uniquement prise en charge sur Windows.

vcpkg env [<optional command>] [--triplet=<triplet>] [--options]

Description

Crée un environnement de génération propre dans votre terminal actuel. L’environnement créé est une cmd session initialisée pour correspondre à celle utilisée par vcpkg pour générer des ports.

La configuration de la session dépend de vos paramètres de triplet. Utilisez l’option --triplet pour spécifier le triplet à cibler, sinon, un triplet par défaut est déduit. En fonction de vos paramètres, cela peut initialiser un environnement de build Visual Studio via vcvars.

La plupart des variables d’environnement sont effacées de la session, à l’exception des variables d’environnement spécifiées dans la VCPKG_KEEP_ENV_VARS variable d’environnement et du VCPKG_ENV_PASSTROUGH paramètre triplet.

L’utilisation des --binoptions , ou --python--include--tools, --debug-binprécède les chemins d’accès respectifs du dossier du triplet aux variables d’environnement installed de la session. Utilisez-les si vous souhaitez installer des outils et des bibliothèques par vcpkg dans la session. Consultez la documentation d’intégration manuelle du système de génération pour en savoir plus sur la installed hiérarchie du dossier.

Si vous le souhaitez, vous pouvez spécifier une seule commande à exécuter. La session se termine immédiatement après.

Exemples

Créer une session d’environnement de génération

PS C:\Users\vcpkg\vcpkg> vcpkg env
Microsoft Windows [Version 10.0.25905.1000]
(c) Microsoft Corporation. All rights reserved.

C:\Users\vcpkg\vcpkg>

Exécuter une seule commande

PS C:\Users\vcpkg\vcpkg> vcpkg env "cmake --version"
cmake version 3.20.21032501-MSVC_2

CMake suite maintained and supported by Kitware (kitware.com/cmake).

Conserver les variables d’environnement

PS C:\Users\vcpkg\vcpkg> $env:CLEARED_ENV_VAR="hello"
PS C:\Users\vcpkg\vcpkg> vcpkg env "set CLEARED_ENV_VAR"
Environment variable CLEARED_ENV_VAR not defined
PS C:\Users\vcpkg\vcpkg> $env:VCPKG_KEEP_ENV_VARS="CLEARED_ENV_VAR"
PS C:\Users\vcpkg\vcpkg> vcpkg env "set CLEARED_ENV_VAR"
CLEARED_ENV_VAR=hello

Ajouter --tools à l’environnement

PS C:\Users\vcpkg\vcpkg> vcpkg install minizip[tool]
PS C:\Users\vcpkg\vcpkg> vcpkg env --tools "minizip"
MiniZip 1.1, demo of zLib + MiniZip64 package, written by Gilles Vollant
more info on MiniZip at http://www.winimage.com/zLibDll/minizip.html

Usage : minizip [-o] [-a] [-0 to -9] [-p password] [-j] file.zip [files_to_add]

  -o  Overwrite existing file.zip
  -a  Append to existing file.zip
  -0  Store only
  -1  Compress faster
  -9  Compress better

  -j  exclude path. store only the file name.

Options

Toutes les commandes vcpkg prennent en charge un ensemble d’options courantes.

--triplet=<triplet>

Spécifie le triplet à cibler lors de la configuration de l’environnement. Cela affecte la façon dont l’environnement de build Visual Studio est initialisé et les installed chemins utilisés par les autres options.

Pour plus d’informations, consultez --triplet les options courantes .

--bin

Ajoute le dossier installé bin du triplet à la variable d’environnement de PATH la session.

--debug-bin

Ajoute le dossier installé debug/bin du triplet à la variable d’environnement de PATH la session.

--include

Ajoute le dossier installé include du triplet à la variable d’environnement de INCLUDE la session.

--tools

Ajoute le dossier installé tools du triplet à la variable d’environnement de PATH la session.

--python

Ajoute le dossier installé python du triplet à la variable d’environnement de PYTHONPATH la session.