vcpkg exportação
vcpkg export [options] {<package>... | --x-all-installed}
Exporta pacotes criados do diretório instalado para um SDK de desenvolvedor autônomo.
export
produz um SDK (Software Development Kit) autônomo e distribuível que pode ser usado em outra máquina sem adquirir separadamente vcpkg. Ele contém:
- Os binários pré-criados para os pacotes selecionados
- Suas dependências transitivas
- Arquivos de integração, como um conjunto de ferramentas CMake ou props/targets do MSBuild
Observação
O comportamento deste comando é diferente no Modo Clássico e no Modo Manifesto
O export
comando não instala nenhum pacote ou dependências transitivas. Ele só exporta pacotes que já estão instalados.
Consulte o Modo Manifesto ou o Modo Clássico para obter mais detalhes.
No modo clássico, vcpkg export
aceita argumentos de especificação de pacote qualificados para tripletes (por exemplo: zlib:x64-windows
)
Você especifica pacotes a serem exportados adicionando <port name>:<triplet>
argumentos à linha de comando.
Por exemplo, para exportar o sqlite
pacote para x64-windows
e x64-linux
, use:
vcpkg export sqlite:x64-windows sqlite:x64-linux --zip
Este comando exporta os pacotes especificados em formato zip. Ambos sqlite:x64-windows
e sqlite:x64-linux
devem ser instalados antes da execução vcpkg export
do .
No modo de manifesto, o comando exporta todos os pacotes atualmente instalados. O diretório de instalação inclui todos os pacotes declarados no manifesto (vcpkg.json
), bem como suas dependências transitivas. Execute vcpkg install
antes de usar este comando para garantir que todos os pacotes necessários estejam instalados.
Nesse modo, não é possível especificar pacotes individuais a serem exportados. O comando opera em todo o estado instalado como uma única entidade, respeitando as dependências e versões especificadas no arquivo de manifesto.
Outra diferença é a exigência da --output-dir
opção. Essa opção especifica o diretório onde os pacotes exportados serão armazenados.
Por exemplo, a partir do diretório de manifesto
vcpkg export --zip --output-dir=.\exports
Exporta todos os pacotes atualmente instalados para o .\exports
diretório em um arquivo zip. A --zip
opção especifica que os pacotes exportados devem ser compactados em um arquivo zip.
A maioria dos formatos de exportação contém um conjunto padrão de arquivos de integração:
- A CMake toolchain na
/scripts/buildsystems/vcpkg.cmake
- Props/targets do MSBuild em
/scripts/buildsystems/msbuild/vcpkg.props
e/scripts/buildsystems/msbuild/vcpkg.targets
- A árvore de instalação em
/
Alguns formatos de exportação diferem deste conjunto padrão; Consulte a ajuda do formato individual abaixo para obter mais detalhes.
Formatos SDK oficialmente suportados:
Formatos experimentais do SDK (podem ser alterados ou removidos a qualquer momento):
vcpkg export --raw [options] <package>...
Crie um layout de diretório descompactado em <output-dir>/<output>/
.
Contém os arquivos de integração padrão.
vcpkg export --zip [options] <package>...
Crie um layout de diretório compactado zip em <output-dir>/<output>.zip
.
Contém os arquivos de integração padrão.
vcpkg export --7zip [options] <package>...
Crie um layout de diretório 7zip em <output-dir>/<output>.7z
.
Contém os arquivos de integração padrão.
vcpkg export --nuget [options] <package>...
Crie um pacote NuGet em <output-dir>/<nuget-id>.<nuget-version>.nupkg
.
Contém os arquivos de integração padrão, bem como integração adicional do MSBuild para oferecer suporte à inclusão em um projeto do MSBuild C++ (.vcxproj
) por meio do Gerenciador de Pacotes NuGet. Observe que você não pode misturar vários pacotes NuGet produzidos com export
juntos -- apenas um dos pacotes será usado. Para adicionar bibliotecas adicionais, você deve criar uma nova exportação com o conjunto completo de dependências.
Opções específicas de formato:
Observação
Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.
vcpkg export --ifw [options] <package>...
Exporte para um instalador baseado em IFW.
Opções específicas de formato:
--ifw-configuration-file-path
--ifw-installer-file-path
--ifw-packages-directory-path
--ifw-repository-directory-path
--ifw-repository-url
Observação
Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.
vcpkg export --x-chocolatey [options] <package>...
Exporte um pacote de chocolate.
Opções específicas de formato:
Observação
Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.
vcpkg export --prefab [options] <package>...
Exportar para o formato pré-fabricado.
Opções específicas de formato:
--prefab-artifact-id
--prefab-group-id
--prefab-maven
--prefab-min-sdk
--prefab-target-sdk
--prefab-version
Todos os comandos vcpkg suportam um conjunto de opções comuns.
Esta é a lista de pacotes construídos de nível superior que serão incluídos no SDK. Quaisquer dependências desses pacotes também serão incluídas para garantir que o SDK resultante seja independente.
Sintaxe do pacote
<port name>:<triplet>
Referências de pacote sem um triplete são automaticamente qualificadas pelo triplete de destino padrão.
Nota: <port name>:<triplet>
argumentos não são permitidos ao usar vcpkg export
no modo de manifesto.
Observação
Esta seção cobre uma característica experimental do vcpkg que pode mudar ou ser removida a qualquer momento.
Exporte todos os pacotes instalados. Essa opção está implícita ao usar vcpkg export
no modo de manifesto.
Não execute a exportação, apenas imprima o plano de exportação.
Especifique o caminho do arquivo temporário para a configuração do instalador.
Especifique o caminho do arquivo para o instalador exportado.
Especifique o caminho do diretório temporário para os pacotes recompactados.
Especifique o caminho do diretório para o repositório exportado.
Especifique a URL do repositório remoto para o instalador on-line.
Especifique o mantenedor para o pacote Chocolatey exportado.
Especifica a descrição de saída para arquivos .nupkg do NuGet .
O padrão é "Vcpkg NuGet export".
Especifica a id de saída para arquivos .nupkg do NuGet .
Essa opção substitui a --output
opção especificamente para o exportador NuGet. Consulte --output
para obter os valores padrão.
Especifica a versão de saída para arquivos .nupkg do NuGet .
Assume o padrão de 1.0.0
.
Especifica o nome base de saída.
Cada tipo de SDK usa esse nome base para determinar seus arquivos de saída específicos. Consulte a documentação específica do SDK acima para obter detalhes.
Assume o padrão de vcpkg-export-<date>-<time>
. O uso por script de export
deve sempre passar esse sinalizador para garantir a saída determinística.
Especifica o diretório de saída.
Todos os arquivos SDK de nível superior serão produzidos neste diretório. Essa opção é necessária no modo de manifesto. No modo clássico, isso é opcional e padrão para o diretório raiz vcpkg.
Artifact Id é o nome do projeto de acordo com as especificações do Maven.
O GroupId identifica exclusivamente seu projeto de acordo com as especificações do Maven.
Habilite o Maven.
Android versão mínima suportada sdk.
Versão sdk suportada pelo Android target.
Versão é a versão do projeto de acordo com as especificações do Maven.
Especifique o sufixo de versão a ser adicionado para o pacote Chocolatey exportado.
Comentários do vcpkg
O vcpkg é um projeto código aberto. Selecione um link para fornecer comentários: