2026 vcpkg & CMake FetchContent : matrice CI, cache binaire & lockfile

Commencez par trancher où vit la « vérité de version ». Si le port existe déjà dans le registre que vous suivez, poussez-y la dépendance et laissez CMake consommer find_package via la toolchain vcpkg. Réservez FetchContent aux composants internes ou aux forks non portés, mais épinglez toujours GIT_TAG (idéalement un hash court immutable) et documentez pourquoi ce chemin existe.

Sur un runner macOS partagé, harmonisez manifest CMake et tout vcpkg install explicite : des chemins installed/ divergents entre étapes provoquent des éditions de liens incohérentes. Documentez le triplet cible (arm64-osx, x64-osx, profil statique/dynamique) pour que la matrice s’applique au même produit.

Ce tableau compare les modes de tirage pour les artefacts de compilation C++ (archives de ports, métadonnées de registre, blobs de cache binaire). Il ne remplace pas votre politique sécurité : validez les domaines autorisés avant d’activer un miroir.

Un miroir d’entreprise peut servir à la fois les métadonnées JSON du registre et les archives compressées attendues par les portfiles ; dans ce cas, vérifiez que les URL réécrites restent compatibles avec la vérification de hachage côté vcpkg. Un cache binaire files local accélère surtout les triplets déjà compilés sur la même famille de machines : invalidez-le lorsque Xcode ou le SDK macOS change de manière incompatible avec vos ABI. Pour une autre famille d’artefacts volumineux sur runner Apple Silicon, croisez avec la matrice transfert & cache Hugging Face Hub sur Mac distant : la logique de « remplir avant de compiler » est analogue, même si le protocole diffère.

Adaptez les chemins à votre arborescence (/usr/local/ci/... est un exemple pour NVMe interne). Exportez les variables avant la première invocation CMake qui charge la toolchain vcpkg.

export VCPKG_ROOT="/usr/local/ci/vcpkg"
export VCPKG_DEFAULT_BINARY_CACHE="/usr/local/ci/vcpkg-binary-cache"
export VCPKG_BINARY_SOURCES="clear;files,$VCPKG_DEFAULT_BINARY_CACHE,readwrite"
export X_VCPKG_MAX_CONCURRENCY="4"
export CMAKE_BUILD_PARALLEL_LEVEL="4"

Configurez ensuite le projet avec la toolchain officielle (chemin absolu recommandé dans les scripts CI) :

cmake -S . -B build \
  -DCMAKE_TOOLCHAIN_FILE="$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake" \
  -DVCPKG_MANIFEST_INSTALL=ON \
  -DCMAKE_BUILD_TYPE=Release

Pour FetchContent en mode « stable par défaut », ajoutez des cache entries (ou un preset CMake) plutôt que de modifier le CMakeLists à la volée :

cmake -S . -B build \
  -DFETCHCONTENT_UPDATES_DISCONNECTED=ON \
  -DFETCHCONTENT_QUIET=ON

Un bootstrap vcpkg figé dans le pipeline évite les surprises lorsque la branche par défaut avance entre deux nuits : épinglez le commit du clone vcpkg ou réutilisez une image runner déjà synchronisée. Vérifiez que vcpkg install manifest et cmake --build utilisent le même VCPKG_ROOT.

Pour un magasin objet (Azure Blob, S3, GCS…), la chaîne VCPKG_BINARY_SOURCES suit le motif clear;x-azblob,https://<compte>.blob.core.windows.net/<conteneur>,... avec secrets injectés par variables CI uniquement. Avec CMake Presets, dupliquez ces variables dans environment du preset ci.

Utilisez cette liste avant de déclarer un pipeline « prêt production » sur Mac partagé. Elle complète la matrice sans dupliquer les guides orientés gestionnaires de paquets d’autres langages.

• vcpkg.json versionné ; builtin-baseline (ou registre figé) aligné sur la révision d’outil réellement installée sur l’agent.
• overrides documentés pour tout port dont la résolution transitive a déjà glissé.
• Chaque FetchContent_Declare expose un GIT_TAG / hash immuable ; pas de branche mobile en CI release.
• Job de contrôle : échec attendu si la résolution vcpkg change sans mise à jour des métadonnées (politique équivalente à un lock pour C++).
• X_VCPKG_MAX_CONCURRENCY et CMAKE_BUILD_PARALLEL_LEVEL cohérents avec hw.ncpu et la charge du pool (souvent inférieur au nombre de cœurs).
• Répertoires buildtrees / packages / cache binaire sur disque local rapide, jamais sur un volume réseau SMB monté pour la compile.

Copiez-collez puis remplacez les segments entre crochets par votre angle produit (triplet, région, nom d’équipe). Gardez le title sous environ 60 caractères visibles et la description sous 155–160 caractères utiles.

2026 [Produit/équipe] : vcpkg + CMake FetchContent sur Mac distant — cache binaire & lockfile

Matrice CI : liaison directe vs miroir vs cache binaire ; variables VCPKG_BINARY_SOURCES, baseline manifest, FetchContent figé ; concurrence NVMe ; checklist reproductible — lecture sans connexion.

Faut-il mélanger vcpkg et FetchContent pour la même bibliothèque ? Non : choisissez une source de vérité pour éviter doubles tirages et collisions de symboles.

Quand activer FETCHCONTENT_FULLY_DISCONNECTED ? Seulement après un préremplissage fiable des répertoires _deps ; sinon la configure échouera sans aller sur le réseau.

Comment partager un cache binaire entre jobs ? Répertoire NVMe commun avec droits contrôlés, ou backend objet avec jetons émis par le pipeline ; planifiez une politique d’éviction.

Que couvre la checklist « lockfile » côté vcpkg ? Surtout vcpkg.json + builtin-baseline + overrides explicites ; exigez une PR lorsque la résolution change.

X_VCPKG_MAX_CONCURRENCY trop élevé : quel symptôme ? Latence disque et échecs réseau « fantômes » ; réduisez avant d’ajouter des miroirs distants.

Le bloc <head> embarque déjà BlogPosting, BreadcrumbList, HowTo et FAQPage alignés sur les sections visibles. Lors d’un fork, gardez les questions FAQ synchronisées avec le JSON-LD et évitez d’y placer secrets, jetons ou URL internes non publiques.

Sur un Mac distant partagé, la performance C++ dépend autant du cache binaire vcpkg et de la baseline manifest que du débit WAN. Louer un nœud proche de vos registres ou de votre magasin d’objets permet de valider en conditions réelles — tirages transfrontaliers, parallélisme disque, comportement FetchContent — avant de figer le pipeline pour toute l’équipe.

Pages utiles sans connexion : accueil, tarifs, achat, centre d’aide, blog technique.