VCPKG instalar

Sinopse

• Modo clássico

vcpkg install [options] <package>...

• Modo de manifesto

vcpkg install [options]

Descrição

Crie e instale pacotes de porta.

Modo clássico

No modo Clássico, esse verbo adiciona pacotes de porta ao conjunto existente no diretório instalado (o padrão é installed/ sob a raiz vcpkg). Isso pode exigir a remoção e a reconstrução de pacotes existentes, que podem falhar.

Sintaxe do pacote

portname[feature1,feature2]:triplet

Referências de pacote sem um triplete são automaticamente qualificadas pelo triplete de destino padrão. As referências de pacote que não listam core explicitamente são consideradas como implicando todos os recursos padrão.

Modo de manifesto

No modo Manifesto, esse comando define o diretório instalado para o estado especificado pelo arquivo de manifesto vcpkg.json , adicionando, removendo ou recriando pacotes conforme necessário.

Opções

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

--allow-unsupported

Em vez de parar em uma porta sem suporte, continue com um aviso.

Por padrão, vcpkg se recusa a executar um plano de instalação contendo uma instalação de porta para um triplete fora de sua "supports" cláusula. A "supports" cláusula de um pacote descreve o conjunto completo de plataformas em que se espera que um pacote possa ser compilado. Esse sinalizador instrui vcpkg a avisar que a compilação deve falhar em vez de parar.

--clean-after-build

Limpe buildtrees, pacotes e downloads depois de compilar cada pacote.

Essa opção tem o mesmo efeito que passar --clean-buildtrees-after-build, --clean-downloads-after-builde --clean-packages-after-build.

--clean-buildtrees-after-build

Limpe todos os subdiretórios da subpasta temporária buildtrees depois de compilar cada pacote.

Todos os arquivos de nível superior na subpasta buildtrees (por exemplo, buildtrees/zlib/config-x64-windows-out.log) serão mantidos. Todos os subdiretórios serão excluídos.

--clean-downloads-after-build

Limpe todos os ativos não extraídos da pasta depois de downloads/ compilar cada pacote.

Todos os arquivos de downloads/ nível superior na pasta serão excluídos. As ferramentas extraídas serão mantidas.

--clean-packages-after-build

Limpe a subpasta temporária dos pacotes depois de compilar cada pacote.

A subpasta packages para o pacote compilado (por exemplo, packages/zlib_x64-windows) será excluída após a instalação.

--dry-run

Imprima o plano de instalação, mas não remova nem instale nenhum pacote.

O plano de instalação lista todos os pacotes e recursos que serão instalados, bem como quaisquer outros pacotes que precisam ser removidos e reconstruídos.

--editable

• Apenas no modo clássico

Execute compilações editáveis para todos os pacotes diretamente referenciados na linha de comando.

Quando vcpkg cria portas, ele limpa e extrai novamente o código-fonte cada vez para garantir que as entradas sejam precisas. Isso é necessário para que o modo Manifesto atualize com precisão o que está instalado e para o cache binário para garantir que o conteúdo armazenado em cache esteja correto.

Passar o --editable sinalizador desabilita esse comportamento, preservando as edições nos códigos-fonte extraídos buildtrees/ na pasta. Isso ajuda a desenvolver patches rapidamente, evitando a necessidade de gravar um arquivo em cada alteração.

Os códigos-fonte extraídos durante uma compilação editável não têm um .clean/ sufixo no nome do diretório e não serão limpos por compilações subsequentes não editáveis.

--enforce-port-checks

Falha na instalação se uma porta tiver detectado problemas ou tentar usar um recurso preterido.

Por padrão, vcpkg executará várias verificações em pacotes criados e emitirá avisos se algum problema for detectado. Esse sinalizador atualiza esses avisos para um erro.

--x-feature=<feature>

Observação

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

• Somente modo de manifesto

Especifique um recurso adicional do vcpkg.json para o qual instalar dependências.

Por padrão, somente "dependencies" e as dependências de "default-features" serão instaladas.

--head

• Apenas no modo clássico

Solicite todos os pacotes explicitamente referenciados na linha de comando para buscar os códigos-fonte mais recentes disponíveis durante a compilação.

Este sinalizador destina-se apenas a testes temporários e não se destina à produção ou utilização a longo prazo. Isso desabilita o cache binário para todos os pacotes explicitamente referenciados e seus dependentes porque vcpkg não pode rastrear com precisão todas as entradas.

--keep-going

Continue o plano de instalação após a primeira falha.

Por padrão, vcpkg irá parar na primeira falha de compilação do pacote. Esse sinalizador instrui o vcpkg a continuar criando e instalando outras partes do plano de instalação que não dependem do pacote com falha.

--x-no-default-features

Observação

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

• Somente modo de manifesto

Não instale os recursos padrão a partir do manifesto de nível superior.

Ao usar install no modo Manifesto, por padrão, todas as dependências dos recursos listados em "default-features" serão instaladas. Esse sinalizador desabilita esse comportamento para que somente os recursos explicitamente habilitados por --x-feature sejam instalados.

--no-downloads

Ao criar um pacote, impeça que as portas baixem novos ativos durante a compilação.

Por padrão, as portas adquirirão código-fonte e ferramentas sob demanda da Internet (sujeito ao cache de ativos). Esse parâmetro bloqueia downloads e restringe as portas apenas aos ativos que foram baixados e armazenados em cache anteriormente na máquina.

--only-downloads

Tente baixar todos os ativos necessários para um plano de instalação sem executar nenhuma compilação.

Quando essa opção for aprovada, o vcpkg executará cada compilação no plano até que ele faça sua primeira chamada de processo externo sem download. A maioria das portas executa todos os downloads antes da primeira chamada de processo externo (geralmente para seu sistema de compilação), portanto, esse procedimento baixará todos os ativos necessários. As portas que não seguirem esse procedimento não terão seus ativos pré-baixados.

--only-binarycaching

Recuse-se a executar quaisquer compilações. Restaure somente pacotes de caches binários.

Esse sinalizador bloqueia vcpkg de executar compilações sob demanda e falhará se um pacote não puder ser encontrado em nenhum cache binário.

--recurse

• Apenas no modo clássico

Aprovar um plano de instalação que exija a reconstrução de pacotes.

Para modificar o conjunto de recursos de um pacote instalado, vcpkg deve remover e reconstruir esse pacote. Como isso tem o potencial de falhar e deixar a árvore de instalação com menos pacotes do que o usuário começou, o usuário deve aprovar planos que recriam pacotes passando esse sinalizador.

--x-use-aria2

Observação

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

Use aria2 para executar tarefas de download.

--x-write-nuget-packages-config

Observação

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

Grava um arquivo formatado em NuGet packages.configpara uso com cache binário.

Essa opção pode ser usada em conjunto com --dry-run para obter a lista de pacotes NuGet necessários do cache binário sem criar ou instalar nenhum pacote. Isso permite que a linha de comando NuGet seja invocada separadamente para cenários avançados, como o uso de protocolos alternativos para adquirir os .nupkg arquivos.

--no-print-usage

Suprimir a geração de texto de uso impresso no final da instalação.