VCPKG instalar

Sinopse

• modo clássico

vcpkg install [options] <package>...

• Modo de manifesto

vcpkg install [options]

Descrição

Crie e instale pacotes de portas.

Modo clássico

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

Sintaxe do pacote

portname[feature1,feature2]:triplet

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

Modo de manifesto

No modo de manifesto , este comando define o de diretório instalado para o estado especificado pelo arquivo de manifesto vcpkg.json, adicionando, removendo ou reconstruindo 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 cláusula "supports". A cláusula "supports" de um pacote descreve o conjunto completo de plataformas em que se espera que um pacote possa ser compilado. Esse sinalizador instrui o vcpkg a avisar que a compilação deve falhar em vez de parar.

--clean-after-build

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

Esta 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 criar 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/ depois de criar 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 depois de criar cada pacote.

A subpasta pacotes para o pacote construído (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 precisem ser removidos e reconstruídos.

--editable

• modo Clássico apenas

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

Quando vcpkg constrói 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 de 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 sinalizador --editable desabilita esse comportamento, preservando edições nas fontes extraídas na pasta buildtrees/. Isso ajuda a desenvolver patches rapidamente, evitando a necessidade de escrever um arquivo em cada alteração.

As fontes extraídas durante uma compilação editável não têm um sufixo .clean/ no nome do diretório e não serão limpas por compilações não editáveis subsequentes.

--enforce-port-checks

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

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

--x-feature=<feature>

Observação

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

• modo de manifesto apenas

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

Por padrão, apenas "dependencies" e as dependências do "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 durante a construção.

Esta bandeira destina-se apenas a testes temporários e não se destina a produção ou utilização a longo prazo. Isso desativa de cache binário para todos os pacotes explicitamente referenciados e seus dependentes, porque 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, 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 secção abrange uma característica experimental do vcpkg que pode ser alterada ou removida a qualquer momento.

• modo de manifesto apenas

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

Ao usar install no modo de manifesto, por padrão, todas as dependências dos recursos listados em "default-features" serão instaladas. Esse sinalizador desabilita esse comportamento, portanto, apenas os recursos explicitamente habilitados por --x-feature serão 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 (sujeitas a 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 compilações.

Quando essa opção for aprovada, o vcpkg executará cada build no plano até fazer 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, este procedimento baixará todos os ativos necessários. As portas que não seguirem este procedimento não terão seus ativos pré-baixados.

--only-binarycaching

Recusar-se a executar quaisquer construções. Restaure apenas pacotes de caches binários .

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

--recurse

• modo Clássico apenas

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

Para modificar o conjunto de recursos de um pacote instalado, o 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-write-nuget-packages-config

Observação

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

Grava um arquivo formatado para packages.configdo NuGet para uso com cache binário.

Essa opção pode ser usada em conjunto com o --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 arquivos .nupkg.

--no-print-usage

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