vcpkg env

Streszczenie

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

opis

Tworzy czyste środowisko kompilacji w bieżącym terminalu. Utworzone środowisko to sesja zainicjowana cmd tak, aby pasowała do tego, którego program vcpkg używa do kompilowania portów.

Konfiguracja sesji zależy od ustawień potrójnych. --triplet Użyj opcji , aby określić trojaczki do wartości docelowej, w przeciwnym razie jest dedukowana domyślna trójka. W zależności od ustawień może to spowodować zainicjowanie środowiska kompilacji programu Visual Studio za pomocą polecenia vcvars.

Większość zmiennych środowiskowych jest czyszczone z sesji, z wyjątkiem zmiennych środowiskowych określonych w VCPKG_KEEP_ENV_VARS zmiennej środowiskowej i ustawienia potrójnego VCPKG_ENV_PASSTROUGH .

--binZa pomocą opcji , , --debug-bin, --include--toolslub --python poprzedza odpowiednie ścieżki z folderu triplet installed do zmiennych środowiskowych sesji. Użyj tych narzędzi, aby narzędzia i biblioteki zainstalowane przez program vcpkg były dostępne w sesji. Zobacz dokumentację ręcznej integracji systemu kompilacji, aby dowiedzieć się więcej o installed hierarchii folderu.

Opcjonalnie możesz określić jedno polecenie do wykonania. Sesja zostanie zakończona natychmiast później.

Przykłady

Tworzenie sesji środowiska kompilacji

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

C:\Users\vcpkg\vcpkg>

Uruchamianie pojedynczego polecenia

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

Zachowywanie zmiennych środowiskowych

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

Dodawanie --tools do środowiska

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.

Opcje

Wszystkie polecenia vcpkg obsługują zestaw typowych opcji.

--triplet=<triplet>

Określa potrójny element docelowy podczas konfigurowania środowiska. Ma to wpływ na sposób inicjowania środowiska kompilacji programu Visual Studio i installed ścieżek używanych przez inne opcje.

Aby uzyskać więcej informacji, zobacz --triplet w artykule Typowe opcje .

--bin

Dodaje folder zainstalowany bin triplet do zmiennej środowiskowej PATH sesji.

--debug-bin

Dodaje folder zainstalowany debug/bin triplet do zmiennej środowiskowej PATH sesji.

--include

Dodaje folder zainstalowany include triplet do zmiennej środowiskowej INCLUDE sesji.

--tools

Dodaje folder zainstalowany tools triplet do zmiennej środowiskowej PATH sesji.

--python

Dodaje folder zainstalowany python triplet do zmiennej środowiskowej PYTHONPATH sesji.