Hosts suportados

Este documento descreve as arquiteturas e sistemas operacionais suportados pelo vcpkg.

Dependências

O vcpkg também depende de alguns componentes do sistema a serem instalados antes de ser executado.

Para usar o vcpkg, alguns componentes precisam ser instalados no sistema primeiro.

• Windows: Visual Studio 2017 ou posterior.
• macOS: Ferramentas de linha de comando do Xcode, tar, git, zip, unzip e curl. A maioria das portas também precisa de pkg-config. Recomendamos instalar essas dependências via Homebrew, como por meio de um comando brew install zip unzip curl pkgconfigde terminal .
• Linux: um compilador C++ para usar, tar, git, zip, unzip e curl. A maioria das portas também precisa de pkg-config. Recomendamos instalar essas dependências com o gerenciador de pacotes do sistema.
  • Plataformas baseadas em APT: apt install git curl zip unzip pkgconfig
  • Plataformas baseadas em RPM: dnf install git curl zip unzip pkgconfig
  • Plataformas baseadas em pacman: base-devel git curl zip unzip tar cmake ninja

Para usuários de Linux e macOS, também recomendamos instalar os seguintes pacotes: autoconf, autoconf-archive, automakee makelibtool. Embora não sejam obrigatórios, esses pacotes são usados frequentemente por bibliotecas disponíveis no vcpkg.

Níveis de suporte do registro selecionado

O suporte é dividido em 4 categorias distintas. Eles são:

• Suporte completo, testado
  As configurações usadas regularmente para testar o registro com curadoria do vcpkg. Problemas nessas configurações são rapidamente encontrados e corrigidos pelos mantenedores e pela comunidade do vcpkg.
• Suporte total, esperado
  Configurações tratadas com a mesma prioridade que "Suporte completo, testado", mas que não fazem parte dos testes regulares. Em geral, essas configurações são substancialmente semelhantes a uma das configurações totalmente testadas.
• Suporte da comunidade
  Configurações que não são ativamente suportadas pelos mantenedores do vcpkg, mas têm investimento substancial na comunidade. Os mantenedores do vcpkg aceitam alterações para corrigir problemas para essas plataformas, mas não garantem que essas configurações funcionem. A equipe vcpkg está interessada em mover o maior número possível de plataformas do suporte da comunidade para o suporte total.
• Sem suporte
  Configurações conhecidas por não funcionarem por algum motivo. Em geral, os PRs que fixam apenas essas plataformas não são aceitos.

Suporte completo, testado

As plataformas testadas e totalmente suportadas são:

Windows

• A versão mais recente do Windows / Windows Server. Estes são o Windows 11 e o Windows Server 2025 à data deste escrito.
• A atualização mais recente do Visual Studio, Visual Studio 2022 versão 17.14, até o presente momento.

macOS (arm64 / "Apple Silicon")

O macOS destina-se a rastrear a versão mais recente do macOS e a versão contemporânea das ferramentas de linha de comando do Xcode. No entanto, atualizar as máquinas macOS é um processo manual, e o macOS frequentemente muda as coisas de maneiras que interrompem os testes do vcpkg. No momento em que este texto está sendo escrito, estamos usando:

• macOS 26.1
• Ferramentas de Linha de Comando do XCode 26.1

Linux

• A versão lts mais recente do Ubuntu, atualmente 24.04.

Android

• Linux de 64 bits Android NDK versão r29

Suporte total, esperado

Windows

• Windows 10/Windows Server 2019 e posterior
• Visual Studio 2017 e posterior

macOS

• A versão mais recente do macOS, menos 2 versões principais. Por exemplo, a versão atual do macOS é macOS 26 Tahoe, portanto, esperamos que o vcpkg funcione desde o macOS 14 Sonoma. Isto foi feito para acompanhar o próprio suporte da Apple ao macOS.
• Versões contemporâneas das Ferramentas de Linha de Comando do Xcode para uma determinada versão do macOS.
• macOS x64

Linux

Pretendemos oferecer suporte a compilações AMD64 de distribuições Linux baseadas em glibc que ainda recebam suporte de seus fornecedores e que tenham sido lançadas nos últimos 5 anos. Exemplos:

• O Ubuntu 24.04 e 22.04 são compatíveis com a Canonical e lançados nos últimos 5 anos, portanto, espera-se que funcionem. O Ubuntu 20.04 ainda está no suporte de ESM da Canonical, mas foi lançado há mais de cinco anos, portanto, não consideramos mais totalmente compatível. 23.10 é mais recente que 22.04, mas não o consideramos totalmente compatível porque ele não tem mais suporte da Canonical.
• O Red Hat Enterprise Linux 9 é totalmente suportado.
• O CentOS e o Red Hat Enterprise Linux 8 deixaram o suporte da Red Hat em 31 de maio de 2024 e foram lançados há mais de 5 anos e, portanto, não são mais suportados.
• O CentOS e o RHEL 7 estão sem suporte da Red Hat e não devem funcionar, pois foram lançados há mais de 5 anos. O fork do Oracle Linux agora suportado pela Oracle ainda está em suporte da Oracle, mas ainda não deve funcionar, pois foi lançado há mais de 5 anos.
• O Fedora 43 e 42 têm suporte total, mas o 41 não tem mais suporte do Fedora.
• Debian 13 "Trixie", 12 "Book worm" e 11 "Bullseye" são todos apoiados por Debian e lançados nos últimos 5 anos. O Debian 10 "Buster" deixou o suporte do projeto Debian em julho de 2024 e, portanto, não é suportado pelo vcpkg.

Também assumimos que os sistemas de compilação dos usuários corresponderão à versão do Linux que eles estão usando e tomamos cuidado para garantir que componentes como nossa integração CMake no modo de manifesto funcionem com as versões dessas dependências que vêm com uma das distribuições acima. No momento em que este artigo foi escrito, essas versões de dependência e as distribuições associadas são:

• 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)

Suporte da comunidade

Windows

• Windows 7 / Windows Server 2008 R2 e posterior

vcpkg.exe deve funcionar em versões do Windows 7, mas a grande maioria do registro com curadoria requer componentes MSYS2, como pkg-config os quais não suportam mais versões do Windows anteriores a 8.1.

• MinGW ou Clang como compilador para compilação.

Atualmente, o vcpkg tem várias suposições do Visual Studio; em particular, nossos recursos que copiam PDBs correspondentes para executáveis atualmente exigem dumpbin, um componente do Visual Studio. No entanto, temos vários membros dedicados da comunidade que se preocupam com o suporte ao MinGW e incluem conjuntos de ferramentas do MinGW na caixa.

Linux

• Linux não AMD64. Temos grande interesse em receber ajuda de pessoas voltadas para Linux em arm64, se for possível demonstrar como fornecer binários com alta probabilidade de funcionar em todo o hardware Linux arm64.
• Linux não glibc. Várias ferramentas que o vcpkg normalmente fornece para você são distribuídas em formas binárias que esperam que a libc do sistema seja glibc. Fornecemos um binário do vcpkg baseado em muslc, que testamos e confirmamos funcionar no Alpine, mas não podemos disponibilizar versões baseadas em muslc de várias dependências, como o CMake.

BSDs ou outros sistemas POSIX

Em destinos BSD, nenhum binário vcpkg é fornecido para download. Em vez disso, a lógica de bootstrap baixará o código-fonte vcpkg e o compilará localmente.

OHOS (OpenHarmony / HarmonyOS)

Os triplets da comunidade arm64-ohos, arm-ohos e x64-ohos têm como alvo a plataforma OHOS, que é a cadeia de ferramentas e a ABI compartilhadas usadas tanto pelo OpenHarmony quanto pelo HarmonyOS da Huawei. É possível usar o SDK do OpenHarmony ou o SDK do HarmonyOS; ambos fornecem a cadeia de ferramentas OHOS (o CMAKE_SYSTEM_NAME=OHOS do CMake, triplas de destino como aarch64-unknown-linux-ohos). Defina OHOS_SDK_ROOT para apontar para o SDK instalado.

Dependências

O vcpkg requer vários pacotes de software que não fazem parte do sistema operacional e precisam ser instalados usando o gerenciador de pacotes:

• 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 no Linux, é recomendável instalar também alguns pacotes adicionais:

• Freebsd: pkg install -y autoconf autoconf-archive gmake pkgconf python
• Openbsd: pkg_add -Iz autoconf-2.71 autoconf-archive gmake pkgconf python3

Advertências

• vcpkg executa unzip a partir de PATH. Eventualmente, isso pode fazer com que o vcpkg execute o sistema operacional fornecido unzip , apesar de um adicional ter sido instalado usando o gerenciador de pacotes. A variável de ambiente PATH deve ser configurada para dar preferência ao unzip de terceiros em vez do do sistema operacional; caso contrário, o vcpkg não conseguirá extrair seu cache de binários.

Sem suporte

• Windows de 32 bits. Ter como alvo x86-windows ou arm-windows funciona perfeitamente, mas o próprio vcpkg espera executar versões AMD64 de ferramentas de suporte como o CMake.
• Visual Studio 2015 ou anterior.
• Windows Vista ou anterior.
• Hosts com macOS ou Linux mais antigos do que aqueles em uma das outras categorias mencionadas.