Compartir a través de


Instalación de vcpkg

Sinopsis

  • Modo clásico
vcpkg install [options] <package>...
  • Modo de manifiesto
vcpkg install [options]

Descripción

Compile e instale paquetes de puerto.

Modo clásico

En el modo clásico, este verbo agrega paquetes de puerto al conjunto existente en el directorio instalado (el valor predeterminado es installed/ bajo la raíz vcpkg). Esto puede requerir la eliminación y recompilación de paquetes existentes, lo que puede producir un error.

Sintaxis del paquete

portname[feature1,feature2]:triplet

Las referencias de paquete sin un triplet se califican automáticamente mediante el triplete de destino predeterminado. Las referencias de paquete que no enumeran core explícitamente se consideran que implican todas las características predeterminadas.

Modo de manifiesto

En el modo Manifiesto, este comando establece el directorio instalado en el estado especificado por el vcpkg.json archivo de manifiesto, agregando, quitando o recompilando paquetes según sea necesario.

Opciones

Todos los comandos vcpkg admiten un conjunto de opciones comunes.

--allow-unsupported

En lugar de detener en un puerto no admitido, continúe con una advertencia.

De forma predeterminada, vcpkg se niega a ejecutar un plan de instalación que contenga una instalación de puerto para un triplete fuera de su "supports" cláusula. La "supports" cláusula de un paquete describe el conjunto completo de plataformas en las que se espera que se pueda compilar un paquete. Esta marca indica a vcpkg que avise de que se espera que se produzca un error en la compilación en lugar de detenerla.

--clean-after-build

Limpie las compilaciones, los paquetes y las descargas después de compilar cada paquete.

Esta opción tiene el mismo efecto que pasar --clean-buildtrees-after-build, --clean-downloads-after-buildy --clean-packages-after-build.

--clean-buildtrees-after-build

Limpie todos los subdirectorios de la subcarpeta temporal buildtrees después de compilar cada paquete.

Todos los archivos de nivel superior de la subcarpeta buildtrees (por ejemplo, buildtrees/zlib/config-x64-windows-out.log) se conservarán. Se eliminarán todos los subdirectorios.

--clean-downloads-after-build

Limpie todos los recursos no extraídos de la downloads/ carpeta después de compilar cada paquete.

Se eliminarán todos los archivos de nivel superior de la downloads/ carpeta. Se conservarán las herramientas extraídas.

--clean-packages-after-build

Limpie la subcarpeta temporal de paquetes después de compilar cada paquete.

La subcarpeta de paquetes del paquete compilado (por ejemplo, packages/zlib_x64-windows) se eliminará después de la instalación.

--dry-run

Imprima el plan de instalación, pero no quite ni instale ningún paquete.

El plan de instalación enumera todos los paquetes y características que se instalarán, así como cualquier otro paquete que deba quitarse y volver a compilarse.

--editable

  • Solo modo clásico

Realice compilaciones editables para todos los paquetes a los que se hace referencia directamente en la línea de comandos.

Cuando vcpkg compila puertos, purga y vuelve a extraer el código fuente cada vez para asegurarse de que las entradas sean precisas. Esto es necesario para que el modo manifiesto actualice con precisión lo que está instalado y para el almacenamiento en caché binario para asegurarse de que el contenido almacenado en caché es correcto.

Pasar la --editable marca deshabilita este comportamiento, conservando las modificaciones en los orígenes extraídos de la buildtrees/ carpeta. Esto ayuda a desarrollar revisiones rápidamente evitando la necesidad de escribir un archivo en cada cambio.

Los orígenes extraídos durante una compilación editable no tienen un .clean/ sufijo en el nombre del directorio y no se borrarán mediante compilaciones posteriores no editables.

--enforce-port-checks

Error de instalación si un puerto ha detectado problemas o intenta usar una característica en desuso.

De forma predeterminada, vcpkg ejecutará varias comprobaciones en paquetes compilados y emitirá advertencias si se detectan problemas. Esta marca actualiza esas advertencias a un error.

--x-feature=<feature>

Nota:

En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.

  • Modo de manifiesto solo

Especifique una característica adicional de para la vcpkg.json que se van a instalar las dependencias.

De forma predeterminada, solo "dependencies" se instalarán las dependencias de "default-features" .

--head

  • Solo modo clásico

Solicite explícitamente a todos los paquetes a los que se hace referencia en la línea de comandos para capturar los orígenes más recientes disponibles al compilar.

Esta marca solo está pensada para pruebas temporales y no está pensada para producción o uso a largo plazo. Esto deshabilita el almacenamiento en caché binario para todos los paquetes a los que se hace referencia explícitamente y sus dependientes porque vcpkg no puede realizar un seguimiento preciso de todas las entradas.

--keep-going

Continúe con el plan de instalación después del primer error.

De forma predeterminada, vcpkg se detendrá en el primer error de compilación del paquete. Esta marca indica a vcpkg que siga compilando e instalando otras partes del plan de instalación que no dependen del paquete con errores.

--x-no-default-features

Nota:

En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.

  • Modo de manifiesto solo

No instale las características predeterminadas desde el manifiesto de nivel superior.

Cuando se usa install en el modo manifiesto, de forma predeterminada se instalarán todas las dependencias de las características enumeradas en "default-features" . Esta marca deshabilita ese comportamiento, por lo que solo se instalarán las características habilitadas explícitamente por --x-feature .

--no-downloads

Al compilar un paquete, evite que los puertos descarguen nuevos recursos durante la compilación.

De forma predeterminada, los puertos adquirirán código fuente y herramientas a petición de Internet (sujeto al almacenamiento en caché de recursos). Este parámetro bloquea las descargas y restringe los puertos solo a los recursos que se descargaron y almacenaron en caché anteriormente en el equipo.

--only-downloads

Intente descargar todos los recursos necesarios para un plan de instalación sin realizar ninguna compilación.

Cuando se pasa esta opción, vcpkg ejecutará cada compilación en el plan hasta que realice su primera llamada al proceso externo sin descargar. La mayoría de los puertos realizan todas las descargas antes de la primera llamada de proceso externo (normalmente a su sistema de compilación), por lo que este procedimiento descargará todos los recursos necesarios. Los puertos que no siguen este procedimiento no tendrán sus recursos descargados previamente.

--only-binarycaching

Se niega a realizar compilaciones. Restaure solo paquetes desde cachés binarias.

Esta marca impide que vcpkg realice compilaciones a petición y producirá un error si no se encuentra un paquete en ninguna caché binaria.

--recurse

  • Solo modo clásico

Apruebe un plan de instalación que requiera volver a generar paquetes.

Para modificar el conjunto de características de un paquete instalado, vcpkg debe quitar y recompilar ese paquete. Dado que esto tiene el potencial de error y dejar el árbol de instalación con menos paquetes que el usuario iniciado, el usuario debe aprobar planes que recompilan los paquetes pasando esta marca.

--x-use-aria2

Nota:

En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.

Use aria2 para realizar tareas de descarga.

--x-write-nuget-packages-config

Nota:

En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.

Escribe un archivo con formato NuGet packages.configpara su uso con almacenamiento en caché binario.

Esta opción se puede usar junto con --dry-run para obtener la lista de paquetes NuGet necesarios desde el almacenamiento en caché binario sin compilar ni instalar ningún paquete. Esto permite invocar la línea de comandos de NuGet por separado para escenarios avanzados, como el uso de protocolos alternativos para adquirir los .nupkg archivos.

--no-print-usage

Suprima la generación de texto de uso impreso al final de la instalación.