Opções de comando comuns

A maioria dos comandos vcpkg aceita um grupo de opções comuns que controlam aspectos transversais da ferramenta. Nem todas as opções afetam todos os comandos. Por exemplo, um comando que não baixa nenhum arquivo não será afetado pela alteração do diretório downloads.

Opções

--x-asset-sources=<config>

Observação

Esta seção cobre um recurso experimental do vcpkg que pode ser alterado ou removido a qualquer momento.

Especifique a configuração de cache para o Cache de ativos.

--binarysource=<config>

Adicione uma fonte para o Cache Binário.

Essa opção pode ser especificada várias vezes; consulte a documentação do Cache binário para saber como várias fontes binárias interagem.

--x-buildtrees-root=<path>

Observação

Esta seção cobre um recurso experimental do vcpkg que pode ser alterado ou removido a qualquer momento.

Especifica o caminho temporário para armazenar arquivos de compilação intermediários, como objetos ou código-fonte descompactado.

O padrão é buildtrees/ na pasta raiz vcpkg.

--classic

Força o modo clássico mesmo se um arquivo de manifesto for detectado.

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

Observação

Esta seção cobre um recurso experimental do vcpkg que pode ser alterado ou removido a qualquer momento.

Habilita CMake --debugger em sistemas de compilação upstream, CMakeLists.txtcomo em vcpkg_cmake_configure.

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

Se houver uma lista de portas separadas por ponto-e-vírgula, o depurador será usado apenas para portas nessa lista. Caso contrário, ele será 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. Como tal, não funcionará para substituição VCPKG_CMAKE_CONFIGURE_OPTIONSde trigêmeos personalizados. Passe manualmente as opções de depuração ou acrescente suas opções a VCPKG_CMAKE_CONFIGURE_OPTIONS ele.

Ao contrário --x-cmake-debug de não haverá nenhuma saída indicando que o build está aguardando a conexão de um depurador. A saída simplesmente parará em Configuring <triplet>.

Embora todas as portas devam chamar o CMake dentro do arquivo de porta para obter sinalizadores de compilação do conjunto de ferramentas do CMake. Este comando é útil principalmente para ports que realmente usam o CMake como seu sistema de compilação.

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

Observação

Esta seção cobre um recurso experimental do vcpkg que pode ser alterado ou removido a qualquer momento.

Habilita o CMake durante a --debugger execução de scripts CMake invocados diretamente, como arquivos triplos (por exemplo: x64-windows.cmake) ou portfile.cmake arquivos.

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

Se houver uma lista de portas separadas por ponto-e-vírgula, o depurador será usado apenas para portas nessa lista. Caso contrário, ele será usado para todas as portas.

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

--downloads-root=<path>

Especifique onde as ferramentas baixadas e os arquivos de código-fonte devem ser mantidos.

O padrão é a VCPKG_DOWNLOADS variável de ambiente. Se isso não estiver definido, o padrão é downloads/ na pasta raiz vcpkg.

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

Essa variável pode ser definida como uma lista de sinalizadores de recursos para aceitar o comportamento experimental.

--host-triplet=<triplet>

Especifique o trio de host.

O padrão é a VCPKG_DEFAULT_HOST_TRIPLET variável de ambiente. Se isso também não estiver definido, o valor será deduzido com base na arquitetura do host e no sistema operacional.

--x-install-root=<path>

Observação

Esta seção cobre um recurso experimental do vcpkg que pode ser alterado ou removido a qualquer momento.

Especifica o caminho para o layout dos pacotes instalados.

No modo Clássico, o padrão é installed/ na pasta raiz vcpkg.

No modo Manifesto, o padrão é vcpkg_installed/ na pasta de manifesto.

--x-manifest-root=<path>

Observação

Esta seção cobre um recurso experimental do vcpkg que pode ser alterado ou removido a qualquer momento.

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

O padrão é pesquisar para cima no diretório de trabalho atual o .vcpkg.json

--overlay-ports=<path>

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

Essa opção pode ser especificada várias vezes; As portas serão resolvidas para a primeira correspondência.

--overlay-triplets=<path>

Especifica um diretório que contém trigêmeos de sobreposição.

Essa opção pode ser especificada várias vezes para adicionar vários diretórios; trigêmeos serão resolvidos para a primeira correspondência por nome.

--x-packages-root=<path>

Observação

Esta seção cobre um recurso experimental do vcpkg que pode ser alterado ou removido a qualquer momento.

Especifica o caminho temporário para preparar arquivos de pacote intermediários antes da instalação final.

O padrão é packages/ na pasta raiz vcpkg.

--triplet=<triplet>

Especifique o trio de arquitetura de destino.

O padrão é a VCPKG_DEFAULT_TRIPLET variável de ambiente. Se isso não estiver definido, deduzido com base na arquitetura do host e no sistema operacional.

Nos sistemas operacionais Windows, a arquitetura é sempre deduzida como x86 por motivos herdados.

Observação

Todas as versões feitas em e após setembro de 2023 serão padronizadas para o trio de host no Windows em vez de x86-windows.

--vcpkg-root=<path>

Especifica a pasta raiz vcpkg.

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

Arquivos de resposta (@<file>)

A linha de comando vcpkg aceita arquivos de texto contendo parâmetros de linha de comando separados por nova linha.

A ferramenta agirá como se os itens no arquivo tivessem sido emendados na linha de comando no lugar da @ referência. Os arquivos de resposta não podem conter arquivos de resposta adicionais.