Condividi tramite

vcpkg env

  • Articolo

Riepilogo

Nota

Questo comando è supportato solo in Windows.

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

Descrizione

Crea un ambiente di compilazione pulito nel terminale corrente. L'ambiente creato è una cmd sessione inizializzata in modo che corrisponda a quella usata da vcpkg per compilare le porte.

La configurazione della sessione dipende dalle impostazioni triplet. Usare l'opzione --triplet per specificare la tripletta di destinazione; in caso contrario, viene dedotto un tripletto predefinito. A seconda delle impostazioni, è possibile inizializzare un ambiente di compilazione di Visual Studio tramite vcvars.

La maggior parte delle variabili di ambiente viene cancellata dalla sessione, ad eccezione delle variabili di ambiente specificate nella VCPKG_KEEP_ENV_VARS variabile di ambiente e nell'impostazione VCPKG_ENV_PASSTROUGH triplet.

L'uso delle --binopzioni , --debug-bin--include, --tools, o --python antepone i rispettivi percorsi dalla cartella del installed tripletto alle variabili di ambiente della sessione. Usare questi strumenti se si vogliono rendere disponibili strumenti e librerie da vcpkg nella sessione. Per altre informazioni sulla gerarchia della cartella, vedere la documentazione sull'integrazione installed manuale del sistema di compilazione.

Facoltativamente, è possibile specificare un singolo comando da eseguire. La sessione verrà terminata immediatamente dopo.

Esempi

Creare una sessione dell'ambiente di compilazione

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

C:\Users\vcpkg\vcpkg>

Eseguire un singolo comando

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

Mantenere le variabili di ambiente

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

Aggiungere --tools all'ambiente

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.

Opzioni

Tutti i comandi vcpkg supportano un set di opzioni comuni.

--triplet=<triplet>

Specifica il triplo di destinazione durante la configurazione dell'ambiente. Ciò influisce sulla modalità di inizializzazione dell'ambiente di compilazione di Visual Studio e sui installed percorsi usati dalle altre opzioni.

Per altre informazioni, vedere --triplet le opzioni comuni.

--bin

Aggiunge la cartella installata bin della tripletta alla variabile di ambiente della PATH sessione.

--debug-bin

Aggiunge la cartella installata debug/bin della tripletta alla variabile di ambiente della PATH sessione.

--include

Aggiunge la cartella installata include della tripletta alla variabile di ambiente della INCLUDE sessione.

--tools

Aggiunge la cartella installata tools della tripletta alla variabile di ambiente della PATH sessione.

--python

Aggiunge la cartella installata python della tripletta alla variabile di ambiente della PYTHONPATH sessione.