Exportar vcpkg

Sinopsis

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

Description

Exporta paquetes integrados desde el directorio instalado a un SDK de desarrollador independiente.

export genera un SDK distribuible independiente (Kit de desarrollo de software) que se puede usar en otra máquina sin adquirir vcpkg por separado. Contiene:

1. Los archivos binarios creados previamente para los paquetes seleccionados
2. Sus dependencias transitivas
3. Archivos de integración, como una cadena de herramientas de CMake o propiedades o destinos de MSBuild

El export comando no instala ningún paquete ni dependencias transitivas. Solo exporta paquetes que ya están instalados.

Consulte Modo de manifiesto o Modo clásico para obtener más detalles.

Modo clásico

En el modo clásico, vcpkg export acepta argumentos de especificación de paquete triplet calificado (por ejemplo: zlib:x64-windows)

Para especificar paquetes que se van a exportar, agregue <port name>:<triplet> argumentos a la línea de comandos.

Por ejemplo, para exportar el sqlite paquete para x64-windows y x64-linux, use:

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

Este comando exporta los paquetes especificados en formato ZIP. Tanto sqlite:x64-windows como sqlite:x64-linux deben instalarse antes de ejecutar vcpkg export.

Modo de manifiesto

En el modo de manifiesto, el comando exporta todos los paquetes instalados actualmente. El directorio de instalación incluye todos los paquetes declarados en el manifiesto (vcpkg.json) así como sus dependencias transitivas. Ejecute vcpkg install antes de usar este comando para asegurarse de que todos los paquetes necesarios están instalados.

En este modo no se pueden especificar paquetes individuales para exportar. El comando funciona en todo el estado instalado como una sola entidad, respetando las dependencias y versiones especificadas en el archivo de manifiesto.

Otra diferencia es el requisito de la --output-dir opción. Esta opción especifica el directorio donde se almacenarán los paquetes exportados.

Por ejemplo, desde el directorio del manifiesto

vcpkg export --zip --output-dir=.\exports

Exporta todos los paquetes instalados actualmente al .\exports directorio en un archivo ZIP. La --zip opción especifica que los paquetes exportados deben comprimirse en un archivo ZIP.

Integración estándar

La mayoría de los formatos de exportación contienen un conjunto estándar de archivos de integración:

• Cadena de herramientas de CMake en /scripts/buildsystems/vcpkg.cmake
• Propiedades y destinos de MSBuild en /scripts/buildsystems/msbuild/vcpkg.props y /scripts/buildsystems/msbuild/vcpkg.targets
• Árbol de instalación en /

Algunos formatos de exportación difieren de este conjunto estándar; consulte la ayuda de formato individual siguiente para obtener más detalles.

Formatos

Formatos de SDK compatibles oficialmente:

• Directorio sin formato
• Zip
• 7zip
• NuGet

Directorio sin formato

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

Cree un diseño de directorio sin comprimir en <output-dir>/<output>/.

Contiene los archivos de integración estándar.

Código postal

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

Cree un diseño de directorio comprimido zip en <output-dir>/<output>.zip.

Contiene los archivos de integración estándar.

7Zip

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

Cree un diseño de directorio 7zip en <output-dir>/<output>.7z.

Contiene los archivos de integración estándar.

NuGet

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

Cree un paquete NuGet en <output-dir>/<nuget-id>.<nuget-version>.nupkg.

Contiene los archivos de integración estándar , así como la integración adicional de MSBuild para admitir la inclusión en un proyecto de C++ de MSBuild (.vcxproj) a través del Administrador de paquetes NuGet. Tenga en cuenta que no se pueden mezclar varios paquetes NuGet generados con export juntos, solo se usará uno de los paquetes. Para agregar bibliotecas adicionales, debe crear una nueva exportación con el conjunto completo de dependencias.

Dar formato a opciones específicas:

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

IFW

Se ha quitado la exportación de IFW.

Chocolatey

Se ha quitado la exportación de chocolate.

Prefabricada

Se ha quitado la exportación de objetos prefabricados.

Options

Todos los comandos vcpkg admiten un conjunto de opciones comunes.

<package>

Esta es la lista de paquetes integrados de nivel superior que se incluirán en el SDK. Todas las dependencias de estos paquetes también se incluirán para asegurarse de que el SDK resultante es independiente.

Sintaxis del paquete

<port name>:<triplet>

Las referencias de paquete sin un triplet se califican automáticamente mediante el triplete de destino predeterminado. Nota: <port name>:<triplet> no se permiten argumentos al usar vcpkg export en modo de manifiesto.

--x-all-installed

Exporte todos los paquetes instalados. Esta opción está implícita cuando se usa vcpkg export en modo de manifiesto.

--dereference-symlinks

Copia los vínculos simbólicos como archivos y directorios normales en los resultados exportados.

--dry-run

No realice la exportación, solo imprima el plan de exportación.

--nuget-description=

Especifica la descripción de salida de los archivos .nupkg de NuGet .

El valor predeterminado es "Exportación de NuGet Vcpkg".

--nuget-id=

Especifica el identificador de salida de los archivos .nupkg de NuGet .

Esta opción invalida la --output opción específicamente para el exportador de NuGet. Consulte --output para obtener los valores predeterminados.

--nuget-version=

Especifica la versión de salida de los archivos .nupkg de NuGet .

Tiene como valor predeterminado 1.0.0.

--output=

Especifica el nombre base de salida.

Cada tipo de SDK usa este nombre base para determinar sus archivos de salida específicos. Consulte la documentación específica del SDK anterior para obtener más información.

Tiene como valor predeterminado vcpkg-export-<date>-<time>. El uso con scripts de export debe pasar siempre esta marca para garantizar la salida determinista.

--output-dir=

Especifica el directorio de salida.

Todos los archivos del SDK de nivel superior se generarán en este directorio. Esta opción es necesaria en modo de manifiesto. En el modo clásico, este valor es opcional y tiene como valor predeterminado el directorio raíz vcpkg.