vcpkg env

Übersicht

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

Beschreibung

Erstellt eine sauber Buildumgebung in Ihrem aktuellen Terminal. Die erstellte Umgebung ist eine cmd Sitzung, die initialisiert wird, um mit dem vcpkg übereinzugleichen, der zum Erstellen von Ports verwendet wird.

Die Konfiguration der Sitzung hängt von Ihren Tripleteinstellungen ab. Verwenden Sie die --triplet Option, um das Triplet anzugeben, das als Ziel verwendet werden soll, andernfalls wird ein Standard-Triplet abgeleitet. Je nach Ihren Einstellungen initialisiert dies möglicherweise eine Visual Studio-Buildumgebung über vcvars.

Die meisten Umgebungsvariablen werden aus der Sitzung gelöscht, mit Ausnahme der Umgebungsvariablen, die in der VCPKG_KEEP_ENV_VARS Umgebungsvariable und der VCPKG_ENV_PASSTROUGH Tripleteinstellung angegeben sind.

Mit den --binOptionen , , --debug-bin, --includeoder --python --toolsden Optionen werden die entsprechenden Pfade aus dem Ordner des installed Triplets in die Umgebungsvariablen der Sitzung verschoben. Verwenden Sie diese, wenn Sie Tools und Bibliotheken, die von vcpkg installiert werden, in der Sitzung zur Verfügung stellen möchten. Weitere Informationen zur installed Ordnerhierarchie finden Sie in der Dokumentation zur manuellen Integration des Buildsystems.

Optional können Sie einen einzelnen auszuführenden Befehl angeben. Die Sitzung wird unmittelbar danach beendet.

Beispiele

Erstellen einer Buildumgebungssitzung

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

C:\Users\vcpkg\vcpkg>

Ausführen eines einzelnen Befehls

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

Beibehalten von Umgebungsvariablen

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

Zur Umgebung hinzufügen --tools

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.

Optionen

Alle vcpkg-Befehle unterstützen eine Reihe allgemeiner Optionen.

--triplet=<triplet>

Gibt das Triplet an, das beim Konfigurieren der Umgebung als Ziel festgelegt werden soll. Dies wirkt sich darauf aus, wie die Visual Studio-Buildumgebung initialisiert wird und welche installed Pfade von den anderen Optionen verwendet werden.

Weitere Informationen finden Sie --triplet in den allgemeinen Optionen .

--bin

Fügt den installierten bin Ordner des Triplets zur Umgebungsvariablen der PATH Sitzung hinzu.

--debug-bin

Fügt den installierten debug/bin Ordner des Triplets zur Umgebungsvariablen der PATH Sitzung hinzu.

--include

Fügt den installierten include Ordner des Triplets zur Umgebungsvariablen der INCLUDE Sitzung hinzu.

--tools

Fügt den installierten tools Ordner des Triplets zur Umgebungsvariablen der PATH Sitzung hinzu.

--python

Fügt den installierten python Ordner des Triplets zur Umgebungsvariablen der PYTHONPATH Sitzung hinzu.