VCPKG ENV

Sinopse

Observação

Esse comando só tem suporte no Windows.

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

Descrição

Cria um ambiente de construção limpo em seu terminal atual. O ambiente criado é uma cmd sessão inicializada para corresponder àquela que vcpkg usa para criar portas.

A configuração da sessão depende de suas configurações triplet. Use a opção para especificar o triplete a --triplet ser direcionado, caso contrário, um triplete padrão será deduzido. Dependendo de suas configurações, isso pode inicializar um ambiente de compilação do Visual Studio via vcvars.

A maioria das variáveis de ambiente é limpa da sessão, com exceção das variáveis de ambiente especificadas na variável de ambiente e na VCPKG_KEEP_ENV_VARSVCPKG_ENV_PASSTROUGH configuração triplete.

O uso das --binopções , , , --tools, --debug-bin--includeou --python precede os respectivos caminhos da pasta do triplete installed para as variáveis de ambiente da sessão. Use-os se quiser disponibilizar ferramentas e bibliotecas instaladas pelo vcpkg na sessão. Consulte a documentação de integração manual do sistema de compilação para saber mais sobre a installed hierarquia da pasta.

Opcionalmente, você pode especificar um único comando a ser executado. A sessão terminará imediatamente a seguir.

Exemplos

Criar uma sessão de ambiente de compilação

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

C:\Users\vcpkg\vcpkg>

Executar um único 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).

Preservar variáveis de 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

Adicionar --tools ao 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.

Opções

Todos os comandos vcpkg suportam um conjunto de opções comuns.

--triplet=<triplet>

Especifica o triplete a ser direcionado ao configurar o ambiente. Isso afeta como o ambiente de compilação do Visual Studio é inicializado e os installed caminhos usados pelas outras opções.

Consulte --triplet as opções comuns para obter mais informações.

--bin

Adiciona a pasta instalada bin do triplet à variável de PATH ambiente da sessão.

--debug-bin

Adiciona a pasta instalada debug/bin do triplet à variável de PATH ambiente da sessão.

--include

Adiciona a pasta instalada include do triplet à variável de INCLUDE ambiente da sessão.

--tools

Adiciona a pasta instalada tools do triplet à variável de PATH ambiente da sessão.

--python

Adiciona a pasta instalada python do triplet à variável de PYTHONPATH ambiente da sessão.