Hosts admitidos

En este documento se describen las arquitecturas y los sistemas operativos compatibles con vcpkg.

Dependencias

vcpkg también depende de algunos componentes del sistema que se van a instalar antes de poder ejecutarse.

Para usar vcpkg, primero es necesario instalar algunos componentes en el sistema.

• Windows: Visual Studio 2017 o posterior.
• macOS: Herramientas de línea de comandos de Xcode, tar, git, zip, descomprimir y curl. La mayoría de los puertos también necesitan pkg-config. Se recomienda instalar estas dependencias a través de Homebrew, como a través de un comando brew install zip unzip curl pkgconfigde terminal .
• Linux: un compilador de C++ para usar, tar, git, zip, descomprimir y curl. La mayoría de los puertos también necesitan pkg-config. Se recomienda instalar estas dependencias con el administrador de paquetes del sistema.
  • plataformas basadas en apt: apt install git curl zip unzip pkgconfig
  • Plataformas basadas en rpm: dnf install git curl zip unzip pkgconfig
  • Plataformas basadas en pacman: base-devel git curl zip unzip tar cmake ninja

Para los usuarios de Linux y macOS también se recomienda instalar los siguientes paquetes: autoconf, autoconf-archive, automakemakey libtool. Aunque no es necesario, las bibliotecas disponibles en vcpkg usan estos paquetes a menudo.

Niveles de soporte del registro seleccionado

El soporte técnico se divide en 4 categorías distintas. Son las siguientes:

• Compatibilidad completa, probada
  Las configuraciones utilizadas para probar de forma periódica el registro seleccionado de vcpkg. Los problemas en estas configuraciones se encuentran rápidamente y se corrigen mediante los mantenedores y la comunidad de vcpkg.
• Compatibilidad completa, esperada
  Las configuraciones se tratan con la misma prioridad que "Compatibilidad completa, probada", pero que no forman parte de las pruebas normales. En general, estas configuraciones son sustancialmente similares a una de las configuraciones totalmente probadas.
• Soporte técnico de la comunidad
  Configuraciones que no cuentan con soporte activo por parte de los responsables de mantenimiento de vcpkg, pero en las que la comunidad ha invertido un esfuerzo considerable. Los mantenedores de vcpkg aceptan cambios para corregir problemas para estas plataformas, pero no garantizan que estas configuraciones funcionen. El equipo de vcpkg está interesado en pasar tantas plataformas como sea posible del soporte de la comunidad al soporte completo.
• No compatible
  Las configuraciones que se sabe que no funcionan por algún motivo. En general, las solicitudes de incorporación de cambios que corrigen solo estas plataformas no se aceptan.

Compatibilidad completa, probada

Las plataformas totalmente compatibles y probadas son:

Windows

• La versión más reciente de Windows o Windows Server. Estos son Windows 11 y Windows Server 2025 a partir de este artículo.
• La actualización más reciente de Visual Studio, Visual Studio 2022 versión 17.14, hasta la fecha de redacción de este texto.

macOS (arm64 / "Apple Silicon")

macOS está diseñado para realizar un seguimiento de la versión más reciente de macOS y la versión contemporánea de las herramientas de línea de comandos de Xcode. Sin embargo, la actualización de máquinas macOS es un proceso manual y macOS cambia con frecuencia cosas de maneras que interrumpen las pruebas de vcpkg. A partir de este escrito, estamos usando:

• macOS 26.1
• Herramientas de línea de comandos de XCode 26.1

Linux

• La versión más reciente de LTS de Ubuntu, actualmente 24.04.

Androide

• Linux 64 bits Android NDK versión r29

Compatibilidad completa, esperada

Windows

• Windows 10/ Windows Server 2019 y versiones posteriores
• Visual Studio 2017 y versiones posteriores

macOS

• La versión más reciente de macOS, menos 2 versiones principales. Por ejemplo, la versión actual de macOS es macOS 26 Tahoe, por lo que esperamos que vcpkg funcione hasta macOS 14 Sonoma. Esto está pensado para realizar un seguimiento con la compatibilidad propia de Apple con macOS.
• Versiones contemporáneas de las herramientas de línea de comandos de Xcode para una versión determinada de macOS.
• macOS x64

Linux

Tenemos previsto ofrecer compatibilidad con compilaciones AMD64 de distribuciones Linux basadas en glibc, publicadas en los últimos 5 años y que sigan recibiendo soporte por parte del proveedor de la distribución. Ejemplos:

• Ubuntu 24.04 y 22.04 están en soporte técnico de Canonical y publicados en los últimos 5 años, por lo que se espera que funcionen. Ubuntu 20.04 sigue siendo compatible con ESM de Canonical, pero se lanzó hace más de 5 años, por lo que ya no lo consideramos totalmente compatible. La versión 23.10 es posterior a la 22.04, pero no se considera totalmente compatible porque ya no está compatible con Canonical.
• Red Hat Enterprise Linux 9 es totalmente compatible.
• CentOS y Red Hat Enterprise Linux 8 abandonaron el soporte técnico de Red Hat el 31 de mayo de 2024 y se publicaron hace más de 5 años y, por tanto, ya no se admiten.
• CentOS y RHEL 7 no son compatibles con Red Hat y no se espera que funcionen como se publicaron hace más de 5 años. El fork de Oracle Linux que ahora cuenta con soporte de Oracle sigue teniendo soporte de Oracle, pero aun así no se espera que funcione, ya que se publicó hace más de 5 años.
• Fedora 43 y 42 son totalmente compatibles, pero 41 ya no es compatible con Fedora.
• Debian 13 "Trixie", 12 "Bookworm" y 11 "Bullseye" son compatibles con Debian y lanzados en los últimos 5 años. Debian 10 "Buster" dejó el soporte técnico del proyecto de Debian en julio de 2024 y, por tanto, no es compatible con vcpkg.

También suponemos que los sistemas de compilación de los usuarios se corresponderán con la versión de Linux que estén usando, y nos aseguramos de que componentes como nuestra integración de CMake en modo manifiesto funcionen con las versiones de estas dependencias incluidas en alguna de las distribuciones mencionadas anteriormente. A partir de este artículo, esas versiones de dependencia y las distribuciones asociadas son:

• GCC 10.2.1 (Debian 11)
• CMake 3.18.4 (Debian 11)
• Ninja 1.10.0 (Todos)
• Curl 7.74.0 (Debian 11)
• zip 3.0 (todos)
• unzip 6.0 (Todos)

Soporte de la comunidad

Windows

• Windows 7/ Windows Server 2008 R2 y versiones posteriores

vcpkg.exe debería funcionar en las distintas versiones de Windows 7, pero la gran mayoría del registro seleccionado requiere componentes de MSYS2 como pkg-config, que ya no admiten versiones de Windows anteriores a Windows 8.1.

• MinGW o Clang como compilador para la compilación.

Actualmente vcpkg tiene una serie de suposiciones de Visual Studio; en concreto, nuestras características que copian archivos PDF coincidentes para los ejecutables actualmente requieren dumpbin, un componente de Visual Studio. Eso sí, contamos con varios miembros de la comunidad comprometidos con el soporte para MinGW, y sí incluimos de serie las herramientas de compilación de MinGW.

Linux

• Linux que no es AMD64. Estamos muy interesados en la ayuda de usuarios que tienen como destino arm64 Linux si se puede mostrar cómo entregar archivos binarios que tienen una alta probabilidad de éxito en ejecución en todo el hardware linux arm64.
• Linux que no es glibc. Varias herramientas que vcpkg normalmente proporciona se distribuyen en formato binario y suponen que la libc del sistema es glibc. Proporcionamos un binario basado en muslc de vcpkg que hemos probado para trabajar en Alpine, pero no podemos proporcionar copias basadas en muslc de una serie de dependencias como CMake.

BSD u otros sistemas POSIX

En los destinos de BSD, no se proporciona ningún archivo binario vcpkg para su descarga. En su lugar, la lógica de arranque descargará el código fuente de vcpkg y lo compilará localmente.

OHOS (OpenHarmony / HarmonyOS)

Los tripletes de la comunidad arm64-ohos, arm-ohos y x64-ohos están dirigidos a la plataforma OHOS, que es la cadena de herramientas y la ABI compartidas que usan tanto OpenHarmony como HarmonyOS de Huawei. Se puede utilizar el SDK de OpenHarmony o el SDK de HarmonyOS; ambos proporcionan la cadena de herramientas de OHOS (el CMAKE_SYSTEM_NAME=OHOS de CMake, tripletas de destino como aarch64-unknown-linux-ohos). Establezca OHOS_SDK_ROOT para que apunte al SDK instalado.

Dependencias

vcpkg requiere una serie de paquetes de software que no forman parte del sistema operativo y deben instalarse mediante el administrador de paquetes:

• FreeBSD: pkg install -y bash cmake curl git ninja zip unzip
• OpenBSD: pkg_add -Iz bash cmake coreutils curl git ninja zip unzip-6.10-iconv

Como en Linux, también se recomienda instalar algunos paquetes adicionales:

• FreeBSD: pkg install -y autoconf autoconf-archive gmake pkgconf python
• OpenBSD: pkg_add -Iz autoconf-2.71 autoconf-archive gmake pkgconf python3

Advertencias

• vcpkg se ejecuta unzip desde PATH. Finalmente, esto podría hacer que vcpkg ejecute el sistema operativo proporcionado unzip a pesar de que se ha instalado otro con el administrador de paquetes. La variable de entorno PATH debe configurarse para dar preferencia a la versión de terceros de unzip en lugar de la del sistema operativo; de lo contrario, vcpkg no podrá extraer su caché binaria.

No se admite

• Windows de 32 bits. Compilar para x86-windows o arm-windows funciona sin problemas, pero el propio vcpkg espera ejecutarse con versiones AMD64 de herramientas auxiliares como CMake.
• Visual Studio 2015 o versiones anteriores.
• Windows Vista o versiones anteriores.
• Los hosts de macOS o Linux más antiguos que los de las otras categorías mencionadas.