VCPKG Exportação

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 (Software Development Kit) independente e distribuível que pode ser usado em outra máquina sem adquirir vcpkg separadamente. Contém:

1. Os binários pré-construídos para os pacotes selecionados
2. Suas dependências transitivas
3. Arquivos de integração, como uma cadeia de ferramentas CMake ou props/targets do MSBuild

O export comando não instala pacotes ou dependências transitivas. Ele só exporta 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 qualificados para trigêmeos (por exemplo: zlib:x64-windows)

Você especifica pacotes para exportar 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 exportdo .

Modo de Manifesto

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.

Neste modo, não é possível especificar pacotes individuais para exportação. 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. Esta 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.

Integração padrão

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

• Uma cadeia de ferramentas CMake na /scripts/buildsystems/vcpkg.cmake
• Props/alvos 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 de padrões; Consulte a Ajuda do Formato Individual abaixo para obter mais detalhes.

Formats

Formatos SDK oficialmente suportados:

• Diretório bruto
• Código Postal
• 7zip
• NuGet

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.

Código Postal

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.

7CEP

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.

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 a integração adicional do MSBuild para dar suporte à inclusão em um projeto MSBuild C++ (.vcxproj) por meio do Gerenciador de Pacotes NuGet. Observe que você não pode misturar vários pacotes NuGet produzidos com export -- 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:

• --nuget-id
• --nuget-version
• --nuget-description

IFW

A exportação IFW foi removida.

Chocolatey

A exportação de chocolates foi removida.

Pré-fabricados

A exportação pré-fabricada foi removida.

Opções

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

<package>

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>

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

--x-all-installed

Exporte todos os pacotes instalados. Esta opção está implícita ao usar vcpkg export no modo de manifesto.

--dereference-symlinks

Copia links simbólicos como arquivos e diretórios regulares nos resultados exportados.

--dry-run

Não realize 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 é "Vcpkg NuGet export".

--nuget-id=

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

Essa opção substitui a --output opção 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 .

O padrão é 1.0.0.

--output=

Especifica o nome da 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.

O padrão é vcpkg-export-<date>-<time>. O uso com script de export deve sempre passar esse sinalizador para garantir uma 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. Esta opção é necessária no modo de manifesto. No modo clássico, isso é opcional e usa como padrão o diretório raiz vcpkg.