Opções de comando comuns

A maioria dos comandos vcpkg aceita um conjunto de opções comuns que controlam os aspetos de corte transversal da ferramenta. Nem todas as opções afetam todos os comandos. Por exemplo, um comando que não descarrega ficheiros não será afetado ao alterar o diretório de downloads.

Opções

--x-asset-sources=<config>

Note

Esta secção abrange uma característica experimental do vcpkg que pode ser alterada ou removida a qualquer momento.

Especifique a configuração da cache para o Asset Caching.

--binary-cache-compression-level=<0-9>

Define o nível de compressão para arquivos ZIP em cache binária. O valor deve ser um dígito de 0 para 9: 0 armazena ficheiros sem compressão, 1 solicita a compressão mais rápida e 9 pede a compressão máxima. Os níveis intermédios trocam o tempo de compressão pelo tamanho do arquivo; os resultados exatos dependem da ferramenta de arquivo.

Esta opção tem precedência sobre a VCPKG_BINARY_CACHE_COMPRESSION_LEVEL variável de ambiente. Quando nenhuma das definições é fornecida, o vcpkg usa o nível padrão de compressão da ferramenta de arquivo. Valores inválidos, incluindo um valor vazio, são rejeitados ao inicializar a cache binária.

vcpkg install zlib --binary-cache-compression-level=1

A definição aplica-se a todos os fornecedores de cache binária que utilizam a criação de ZIP do vcpkg. A embalagem da NuGet não é afetada. Alterar o nível de compressão não altera os hashes ABI dos pacotes nem invalida entradas de cache existentes.

--binarysource=<config>

Adicione uma fonte para Cache Binário.

Esta opção pode ser especificada várias vezes; consulte a documentação de Cache Binária para saber como múltiplas fontes binárias interagem.

--x-buildtrees-root=<path>

Note

Esta secção abrange uma característica experimental do vcpkg que pode ser alterada ou removida a qualquer momento.

Especifica o caminho temporário para armazenar ficheiros de compilação intermédios, como objetos ou código-fonte descompactado.

Por defeito, fica buildtrees/ na pasta raiz vcpkg.

--classic

Força o modo clássico mesmo que seja detetado um ficheiro manifesto .

--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]

Note

Esta secção abrange uma característica experimental do vcpkg que pode ser alterada ou removida a qualquer momento.

Permite CMake's --debugger dentro de sistemas de build a montante, CMakeLists.txtcomo dentro vcpkg_cmake_configurede .

O <debugger-pipe> valor é passado como --debugger-pipe na linha de comandos CMake.

Se existir uma lista de portas separada por ponto e vírgula, o depurador é usado apenas para portas nessa lista. Caso contrário, é usado para todas as portas.

A variável VCPKG_CMAKE_CONFIGURE_OPTIONS triplet é usada para passar as opções para a chamada de configuração interna do CMake. Assim, não funcionará para tercinos personalizados que sobrescrevem VCPKG_CMAKE_CONFIGURE_OPTIONS. Ou passes manualmente as opções de depuração ou adicionas as tuas opções em VCPKG_CMAKE_CONFIGURE_OPTIONS vez disso.

Ao contrário, --x-cmake-debug não haverá qualquer saída que indique que a compilação está à espera que um depurador se ligue. A saída simplesmente vai parar em Configuring <triplet>.

Embora todas as portas devam chamar o CMake dentro do portfile para obter flags de compilação da toolchain CMake. Este comando é principalmente útil para portas que realmente usam o CMake como sistema de compilação.

--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]

Note

Esta secção abrange uma característica experimental do vcpkg que pode ser alterada ou removida a qualquer momento.

Ativa CMakes --debugger enquanto executa scripts CMake invocados diretamente, como ficheiros tripletes (por exemplo: x64-windows.cmake) ou portfile.cmake ficheiros.

O <debugger-pipe> valor é passado como --debugger-pipe na linha de comandos CMake.

Se existir uma lista de portas separada por ponto e vírgula, o depurador é usado apenas para portas nessa lista. Caso contrário, é usado para todas as portas.

Nota: O depurador pode ser ligado se Waiting for debugger client to connect... for observado na saída do vcpkg e a execução é interrompida até que um depurador seja ligado.

--downloads-root=<path>

Especifique onde devem ser guardadas as ferramentas descarregadas e os arquivos do código-fonte.

Por defeito, a VCPKG_DOWNLOADS variável de ambiente. Se isso não estiver definido, por defeito fica downloads/ na pasta raiz do vcpkg.

--feature-flags=<flag1>,...

Esta variável pode ser definida para uma lista de flags de características para optar pelo comportamento experimental.

--host-triplet=<triplet>

Especifique o trio anfitrião.

Por defeito, a VCPKG_DEFAULT_HOST_TRIPLET variável de ambiente. Se esse também não estiver definido, o valor é deduzido com base na arquitetura do host e do sistema operativo.

--x-install-root=<path>

Note

Esta secção abrange uma característica experimental do vcpkg que pode ser alterada ou removida a qualquer momento.

Especifica o caminho para apresentar os pacotes instalados.

No modo Clássico, por defeito está installed/ na pasta raiz do vcpkg.

No modo Manifest, por defeito fica vcpkg_installed/ na pasta manifest.

--x-manifest-root=<path>

Note

Esta secção abrange uma característica experimental do vcpkg que pode ser alterada ou removida a qualquer momento.

Especifica o diretório que contém vcpkg.json.

Por defeito é procurar para cima, a partir do diretório de trabalho atual, o mais próximo vcpkg.json.

--overlay-ports=<path>

Especifica um diretório, seja uma porta de sobreposição, ou subdiretórios que são eles próprios portas de sobreposição. Se <path> for um diretório contendo um CONTROL ou vcpkg.json, é tratado como um diretório de portas de sobreposição, e os subdiretórios não serão considerados como portas de sobreposição adicionais.

Esta opção pode ser especificada várias vezes; as portas resolvem-se para a primeira partida.

--overlay-triplets=<path>

Especifica um diretório contendo tripletas sobrepostas.

Esta opção pode ser especificada várias vezes para adicionar múltiplos diretórios; tercinos resolve-se para a primeira correspondência pelo nome.

--x-packages-root=<path>

Note

Esta secção abrange uma característica experimental do vcpkg que pode ser alterada ou removida a qualquer momento.

Especifica o caminho temporário para o estágio intermédio dos ficheiros de pacote antes da instalação final.

Por defeito, fica packages/ na pasta raiz vcpkg.

--triplet=<triplet>

Especifique o triplo da arquitetura alvo.

Por defeito, a VCPKG_DEFAULT_TRIPLET variável de ambiente. Se isso não estiver definido, deduzido com base na arquitetura do host e no sistema operativo.

Nos sistemas operativos Windows, a arquitetura é sempre deduzida como x86 por razões legadas.

Note

Todos os lançamentos feitos em setembro de 2023 e após terão por defeito o triplo host no Windows em vez de x86-windows.

--vcpkg-root=<path>

Especifica a pasta raiz vcpkg.

Por defeito, o diretório contém o programa vcpkg. O diretório deve ser uma instância válida de vcpkg, como um git clone de https://github.com/microsoft/vcpkg. Esta opção pode ser usada para executar uma cópia personalizada da ferramenta diretamente a partir da pasta de build.

Ficheiros de Resposta (@<file>)

A linha de comandos vcpkg aceita ficheiros de texto contendo parâmetros de linha de comandos separados por nova linha.

A ferramenta comporta-se como se os itens do ficheiro tivessem sido inseridos na linha de comandos em vez da @ referência. Os ficheiros de resposta não podem conter ficheiros de resposta adicionais.