Compartilhar via


exportação vcpkg

Sinopse

vcpkg export [options] {<package>... | --x-all-installed}

Description

Exporta pacotes criados do diretório instalado para um SDK de desenvolvedor autônomo.

export produz um SDK autônomo e distribuível (Software Development Kit) que pode ser usado em outro computador sem adquirir separadamente vcpkg. Ele contém:

  1. Os binários predefinidos para os pacotes selecionados
  2. Suas dependências transitivas
  3. Arquivos de integração, como uma cadeia de ferramentas do CMake ou props/destinos do MSBuild

Observação

O comportamento desse comando é diferente no Modo Clássico e no Modo de Manifesto

O export comando não instala pacotes nem dependências transitivas. Ele exporta apenas pacotes que já estão instalados.

Consulte o Modo de Manifesto ou o Modo Clássico para obter mais detalhes.

Modo Clássico

No modo clássico, vcpkg export aceita argumentos de especificação de pacote qualificado por trigêmeos (por exemplo: zlib:x64-windows)

Especifique pacotes a serem exportados adicionando <port name>:<triplet> argumentos à linha de comando.

Por exemplo, para exportar o sqlite pacote ex64-linuxx64-windows, use:

vcpkg export sqlite:x64-windows sqlite:x64-linux --zip

Esse 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.

Modo de Manifesto

No modo de manifesto, o comando exporta todos os pacotes instalados no momento. 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 esse comando para garantir que todos os pacotes necessários estejam instalados.

Nesse modo, você não pode especificar pacotes individuais a serem exportados. O comando opera em todo o estado instalado como uma única entidade, respeitando as dependências e as versões especificadas no arquivo de manifesto.

Outra diferença é o requisito da opção --output-dir . Essa opção especifica o diretório em que os pacotes exportados serão armazenados.

Por exemplo, no diretório do 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.

Integração Padrão

A maioria dos formatos de exportação contém um conjunto padrão de arquivos de integração:

Alguns formatos de exportação diferem desse conjunto padrão; consulte a ajuda de formato individual abaixo para obter mais detalhes.

Formatos

Formatos do SDK com suporte oficial:

Diretório Bruto

vcpkg export --raw [options] <package>...

Crie um layout de diretório não compactado em <output-dir>/<output>/.

Contém os Arquivos de Integração Padrão.

Zip

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.

7Zip

vcpkg export --7zip [options] <package>...

Crie um layout de diretório de 7zip em <output-dir>/<output>.7z.

Contém os Arquivos de Integração Padrão.

NuGet

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 dar 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 em export conjunto-- apenas um dos pacotes será usado. Para adicionar bibliotecas adicionais, você deve criar uma nova exportação com o conjunto completo de dependências.

Formatar opções específicas:

IFW

A exportação IFW foi removida.

Chocolatey

A exportação de chocolate foi removida.

Prefab

A exportação de pré-fabricado foi removida.

Opções

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

<package>

Esta é a lista de pacotes internos de nível superior que serão incluídos no SDK. Todas as dependências desses pacotes também serão incluídas para garantir que o SDK resultante seja autocontido.

Sintaxe do pacote

<port name>:<triplet>

As referências de pacote sem um trigêmeo são automaticamente qualificadas pelo trigêmeo de destino padrão. Observação: <port name>:<triplet> argumentos não são permitidos ao usar vcpkg export no modo de manifesto.

--x-all-installed

Observação

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

Exportar todos os pacotes instalados. Essa opção é implícita ao usar vcpkg export no modo de manifesto.

Copia symlinks como arquivos e diretórios regulares nos resultados exportados.

--dry-run

Não execute a exportação, apenas imprima o plano de exportação.

--nuget-description=

Especifica a descrição de saída para arquivos .nupkg do NuGet .

O padrão é "Exportação do NuGet vcpkg".

--nuget-id=

Especifica a ID de saída para arquivos .nupkg do NuGet .

Essa opção substitui a opção --output especificamente para o exportador do NuGet. Consulte --output os valores padrão.

--nuget-version=

Especifica a versão de saída para arquivos .nupkg do NuGet .

Usa 1.0.0 como padrão.

--output=

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.

Usa vcpkg-export-<date>-<time> como padrão. O uso com export script deve sempre passar esse sinalizador para garantir a saída determinística.

--output-dir=

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.