Opciones de comando comunes
La mayoría de los comandos vcpkg aceptan un grupo de opciones comunes que controlan aspectos transversales de la herramienta. No todas las opciones afectan a todos los comandos. Por ejemplo, un comando que no descarga ningún archivo no se verá afectado cambiando el directorio de descargas.
Nota
En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.
Especifique la configuración de caché para el almacenamiento en caché de recursos.
Agregue un origen para el almacenamiento en caché binario.
Esta opción se puede especificar varias veces; consulte la documentación de almacenamiento en caché binario para saber cómo interactúan varios orígenes binarios.
Nota
En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.
Especifica la ruta de acceso temporal para almacenar archivos de compilación intermedios, como objetos o código fuente desempaquetado.
El valor predeterminado es buildtrees/
en la carpeta raíz vcpkg.
Fuerza el modo clásico incluso si se detecta un archivo de manifiesto.
Nota
En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.
Habilita CMake dentro de --debugger
los sistemas de compilación ascendentes, CMakeLists.txt
como dentro de vcpkg_cmake_configure
.
El <debugger-pipe>
valor se pasa como --debugger-pipe
en la línea de comandos de CMake.
Si hay una lista de puertos separados por punto y coma, el depurador solo se usa para los puertos de esa lista. De lo contrario, se usa para todos los puertos.
La variable VCPKG_CMAKE_CONFIGURE_OPTIONS
triplet se usa para pasar las opciones a la llamada de configuración interna de CMake.
Por lo tanto, no funcionará para los tripletes personalizados sobrescribir VCPKG_CMAKE_CONFIGURE_OPTIONS
.
Pase manualmente las opciones de depuración o anexe las opciones a VCPKG_CMAKE_CONFIGURE_OPTIONS
en su lugar.
A diferencia de --x-cmake-debug
que no habrá ninguna salida que indique que la compilación está esperando a que un depurador se conecte. La salida simplemente se detendrá en Configuring <triplet>
.
Aunque todos los puertos deben llamar a CMake dentro del archivo portfile para obtener marcas de compilación de la cadena de herramientas de CMake. Este comando es principalmente útil para los puertos que realmente usan CMake como sistema de compilación.
Nota
En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.
Habilita CMake mientras se ejecutan scripts de CMake --debugger
invocados directamente como archivos triplet (por ejemplo: x64-windows.cmake
) o portfile.cmake
archivos.
El <debugger-pipe>
valor se pasa como --debugger-pipe
en la línea de comandos de CMake.
Si hay una lista de puertos separados por punto y coma, el depurador solo se usa para los puertos de esa lista. De lo contrario, se usa para todos los puertos.
Nota: El depurador se puede adjuntar si Waiting for debugger client to connect...
se puede observar en la salida de vcpkg y la ejecución se detiene hasta que se conecta un depurador.
Especifique dónde se deben conservar las herramientas descargadas y los archivos de código fuente.
El valor predeterminado es la variable de VCPKG_DOWNLOADS
entorno. Si no se establece, el valor predeterminado es downloads/
en la carpeta raíz vcpkg.
Esta variable se puede establecer en una lista de marcas de características para participar en el comportamiento experimental.
Especifique el triplete de host.
El valor predeterminado es la variable de VCPKG_DEFAULT_HOST_TRIPLET
entorno. Si esto también no se establece, el valor se deduce en función de la arquitectura del host y del sistema operativo.
Nota
En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.
Especifica la ruta de acceso para diseñar paquetes instalados.
En el modo clásico, el valor predeterminado es installed/
en la carpeta raíz vcpkg.
En el modo manifiesto, el valor predeterminado es vcpkg_installed/
en la carpeta del manifiesto.
Nota
En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.
Especifica el directorio que contiene vcpkg.json
.
El valor predeterminado es buscar hacia arriba desde el directorio de trabajo actual para el más vcpkg.json
cercano.
Especifica un directorio, ya sea un puerto de superposición o subdirectorios que son puertos de superposición. Si <path>
es un directorio que contiene o vcpkg.json
CONTROL
, se trata como un directorio de puerto de superposición y los subdirectorios no se considerarán puertos de superposición adicionales.
Esta opción se puede especificar varias veces; los puertos se resolverán en la primera coincidencia.
Especifica un directorio que contiene tripletas de superposición.
Esta opción se puede especificar varias veces para agregar varios directorios; los tripletes se resolverán en la primera coincidencia por nombre.
Nota
En esta sección se describe una característica experimental de vcpkg que puede cambiar o quitarse en cualquier momento.
Especifica la ruta de acceso temporal a los archivos de paquete intermedios de fase antes de la instalación final.
El valor predeterminado es packages/
en la carpeta raíz vcpkg.
Especifique el triplete de arquitectura de destino.
El valor predeterminado es la variable de VCPKG_DEFAULT_TRIPLET
entorno. Si esto no se establece, se deduce en función de la arquitectura del host y del sistema operativo.
En los sistemas operativos Windows, la arquitectura siempre se deduce como x86 por motivos heredados.
Nota
Todas las versiones realizadas en y después de septiembre de 2023 tendrán como valor predeterminado el triplete host en Windows en lugar de x86-windows.
Especifica la carpeta raíz vcpkg.
El valor predeterminado es el directorio que contiene el programa vcpkg. El directorio debe ser una instancia vcpkg válida, como una git clone
de https://github.com/microsoft/vcpkg
. Esta opción se puede usar para ejecutar una copia personalizada de la herramienta directamente desde la carpeta de compilación.
La línea de comandos vcpkg acepta archivos de texto que contienen parámetros de línea de comandos separados por nuevas líneas.
La herramienta actuará como si los elementos del archivo se splicó en la línea de comandos en lugar de la @
referencia. Los archivos de respuesta no pueden contener archivos de respuesta adicionales.
Comentarios de vcpkg
vcpkg es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios: