Instalación de vcpkg
- Modo clásico
vcpkg install [options] <package>...
- Modo de manifiesto
vcpkg install [options]
Compile e instale paquetes de puerto.
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.
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.
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.
Todos los comandos vcpkg admiten un conjunto de opciones comunes.
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.
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-build
y --clean-packages-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.
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.
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.
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.
- 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.
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.
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"
.
- 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.
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.
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
.
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.
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.
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.
- 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.
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.
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.config
para 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.
Suprima la generación de texto de uso impreso al final de la instalación.
Comentarios de vcpkg
vcpkg es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: