instalação do vcpkg

Sinopse

• modo clássico

vcpkg install [options] <package>...

• modo de manifesto

vcpkg install [options]

Descrição

Compilar e instalar pacotes de porta.

Modo clássico

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

Sintaxe do pacote

portname[feature1,feature2]:triplet

As referências de pacote sem um trigêmeo são automaticamente qualificadas pelo de trigêmeo de destino padrão. Referências de pacote que não listam explicitamente core são consideradas para implicar todos os recursos padrão.

Modo de manifesto

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

Opções

Todos os comandos vcpkg dão suporte a um conjunto de opções comuns.

--allow-unsupported

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

Por padrão, o vcpkg se recusa a executar um plano de instalação que contém uma instalação de porta para um trigêmeo fora de sua cláusula "supports". A cláusula "supports" de um pacote descreve o conjunto completo de plataformas em que um pacote deve 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 após a criação de 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 downloads/ após a criação de cada pacote.

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

--clean-packages-after-build

Limpe a subpasta temporária dos pacotes após a criação de cada pacote.

A subpasta de pacotes do 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 todos os outros pacotes que precisam ser removidos e recriados.

--editable

• modo clássico apenas

Execute builds 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 sempre para garantir que as entradas sejam precisas. Isso é necessário para que o modo manifesto atualize com precisão o que está instalado e o cache binário para garantir que o conteúdo armazenado em cache esteja correto.

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

As fontes extraídas durante um build editável não têm um sufixo .clean/ no nome do diretório e não serão desmarcadas por builds não editáveis subsequentes.

--enforce-port-checks

Falha na instalação se uma porta detectou problemas ou tenta usar um recurso preterido.

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

--x-feature=<feature>

Nota

Esta seção aborda um recurso experimental de vcpkg que pode alterar ou ser removido a qualquer momento.

• modo manifesto apenas

Especifique um recurso de 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

• modo clássico apenas

Solicite todos os pacotes explicitamente referenciados na linha de comando para buscar as fontes mais recentes disponíveis ao compilar.

Esse sinalizador destina-se apenas a testes temporários e não se destina à produção ou ao uso a longo prazo. Isso desabilita de cache binário para todos os pacotes explicitamente referenciados e seus dependentes, pois o 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, o vcpkg será interrompido na primeira falha de build 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

Nota

Esta seção aborda um recurso experimental de vcpkg que pode alterar ou ser removido a qualquer momento.

• modo manifesto apenas

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

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

--no-downloads

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

Por padrão, as portas adquirirão código-fonte e ferramentas sob demanda da Internet (sujeitos a cache de ativos). Esse parâmetro bloqueia downloads e restringe portas apenas aos ativos que foram baixados e armazenados em cache no computador.

--only-downloads

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

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

--only-binarycaching

Recusar-se a executar quaisquer builds. Restaurar somente pacotes de caches binários.

Esse sinalizador impede que o vcpkg execute builds sob demanda e falhará se um pacote não puder ser encontrado em caches binários.

--recurse

• modo clássico apenas

Aprove um plano de instalação que requer a recriação de pacotes.

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

--x-write-nuget-packages-config

Nota

Esta seção aborda um recurso experimental de vcpkg que pode alterar ou ser removido a qualquer momento.

Grava um arquivo formatado em packages.configNuGet para uso com de 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 pacotes. Isso permite que a linha de comando do NuGet seja invocada separadamente para cenários avançados, como o uso de protocolos alternativos para adquirir os arquivos .nupkg.

--no-print-usage

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