Compartilhar via


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 de downloads.

Opções

--x-asset-sources=<config>

Observação

Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.

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

--binarysource=<config>

Adicione uma fonte para o Cache Binário.

Esta opção pode ser especificada várias vezes; consulte a documentação do Binary Caching para saber como várias fontes binárias interagem.

--x-buildtrees-root=<path>

Observação

Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida 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.

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

Observação

Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.

Habilita CMake dentro de --debugger sistemas de compilação upstream' CMakeLists.txt, como dentro vcpkg_cmake_configuredo .

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

Se houver uma lista de portas separada 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 trigêmeos personalizados sobrescrevendo VCPKG_CMAKE_CONFIGURE_OPTIONS. Passe manualmente as opções de depuração ou anexe suas opções a VCPKG_CMAKE_CONFIGURE_OPTIONS elas.

Ao contrário --x-cmake-debug , não haverá saída indicando que a compilação está aguardando que um depurador se conecte. A saída simplesmente ficará parada em Configuring <triplet>.

Embora todas as portas devam estar chamando CMake dentro do portfile para obter sinalizadores de compilação do CMake toolchain. Este comando é útil principalmente para portas 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 uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.

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

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

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

Nota: 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 será na downloads/ 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 triplete do 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 uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.

Especifica o caminho para dispor os pacotes instalados.

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

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

--x-manifest-root=<path>

Observação

Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.

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

O padrão é pesquisar para cima a partir do diretório de trabalho atual para o vcpkg.jsonarquivo .

--overlay-ports=<path>

Especifica um diretório que contém portas de sobreposição.

Esta opção pode ser especificada várias vezes; As portas serão resolvidas para a primeira partida.

--overlay-triplets=<path>

Especifica um diretório contendo trigêmeos de sobreposição.

Essa opção pode ser especificada várias vezes para adicionar vários diretórios; Os trigêmeos resolverão para a primeira partida pelo nome.

--x-packages-root=<path>

Observação

Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida 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 triplete da 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.

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

Observação

Todos os lançamentos feitos em e após setembro de 2023 terão como padrão o triplet 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 a 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 fossem emendados na linha de comando no lugar da @ referência. Os arquivos de resposta não podem conter arquivos de resposta adicionais.