vcpkg env

Краткие сведения

Примечание.

Эта команда поддерживается только в Windows.

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

Description

Создает чистую среду сборки в текущем терминале. Созданная среда — это сеанс, инициализируемый cmd для сопоставления одного vcpkg, который используется для создания портов.

Конфигурация сеанса зависит от параметров триплета. --triplet Используйте параметр, чтобы указать триплет для целевого объекта, в противном случае будет выведена тройная строка по умолчанию. В зависимости от параметров это может инициализировать среду сборки Visual Studio с помощью vcvars.

Большинство переменных среды очищаются из сеанса, за исключением переменных среды, указанных в VCPKG_KEEP_ENV_VARS переменной среды и тройном параметре VCPKG_ENV_PASSTROUGH .

--binПри использовании параметров , --debug-binили --tools--include--python параметров используются соответствующие пути из папки триплета installed в переменные среды сеанса. Используйте их, если вы хотите сделать средства и библиотеки, установленные vcpkg, доступными в сеансе. Дополнительные сведения об installed иерархии папок см. в документации по интеграции с системой сборки вручную.

При необходимости можно указать одну команду для выполнения. Сеанс завершится сразу после этого.

Примеры

Создание сеанса среды сборки

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

C:\Users\vcpkg\vcpkg>

Выполнение одной команды

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

Сохранение переменных среды

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

Добавление --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.

Параметры

Все команды vcpkg поддерживают набор общих параметров.

--triplet=<triplet>

Задает триплет для целевого объекта при настройке среды. Это влияет на инициализацию среды сборки Visual Studio и installed пути, используемые другими параметрами.

Дополнительные сведения см --triplet . в общих параметрах .

--bin

Добавляет установленную bin папку triplet в переменную среды сеанса PATH .

--debug-bin

Добавляет установленную debug/bin папку triplet в переменную среды сеанса PATH .

--include

Добавляет установленную include папку triplet в переменную среды сеанса INCLUDE .

--tools

Добавляет установленную tools папку triplet в переменную среды сеанса PATH .

--python

Добавляет установленную python папку triplet в переменную среды сеанса PYTHONPATH .