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.

Opciones

--x-asset-sources=<config>

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.

--binarysource=<config>

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.

--x-buildtrees-root=<path>

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.

--x-cmake-configure-debug=<debugger-pipe>[;semicolon;port;list]

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.txtcomo 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.

--x-cmake-debug=<debugger-pipe>[;semicolon;port;list]

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.

--downloads-root=<path>

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.

--feature-flags=<flag1>,...

Esta variable se puede establecer en una lista de marcas de características para participar en el comportamiento experimental.

--host-triplet=<triplet>

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.

--x-install-root=<path>

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.

--x-manifest-root=<path>

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.jsoncercano.

--overlay-ports=<path>

Especifica un directorio que contiene puertos de superposición.

Esta opción se puede especificar varias veces; los puertos se resolverán en la primera coincidencia.

--overlay-triplets=<path>

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.

--x-packages-root=<path>

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.

--triplet=<triplet>

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.

--vcpkg-root=<path>

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.

Archivos de respuesta (@<file>)

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.