Collection de templates C++23 construits avec CMake et vcpkg.
- CMake 4.4 ou supérieur
- un compilateur compatible C++23
- Git
- Ninja pour les presets Ninja
- Xcode pour le preset Xcode sur macOS
Pour VS Code, installer les extensions suivantes :
- CMake Tools (
ms-vscode.cmake-tools) - C/C++ (
ms-vscode.cpptools)
Cloner le dépôt avec ses sous-modules :
git clone --recurse-submodules git@github.com:kdridi/20GC.git
cd 20GCPour initialiser les sous-modules dans un dépôt déjà cloné :
git submodule update --init --recursiveInitialiser vcpkg sur macOS ou Linux :
./extern/vcpkg/bootstrap-vcpkg.shSur Windows :
.\extern\vcpkg\bootstrap-vcpkg.batAfficher tous les presets disponibles :
cmake --list-presets=allcmake --preset ninja-debug
cmake --build --preset ninja-debug
./build/ninja-debug/templates/simple_fmt/simple_fmtcmake --preset ninja-release
cmake --build --preset ninja-release
./build/ninja-release/templates/simple_fmt/simple_fmtPour supprimer le cache CMake et forcer une configuration propre :
cmake --preset ninja-debug --freshGénérer le projet Xcode en utilisant le chemin physique du dépôt :
cd "$(pwd -P)"
cmake --preset xcodeL'utilisation du chemin physique est importante lorsque le dépôt est atteint par un lien symbolique : Xcode exige que les chemins du projet et des sources soient identiques pour indexer correctement le code.
Compiler en Debug ou Release :
cmake --build --preset xcode-debug
cmake --build --preset xcode-releaseOuvrir le projet généré dans Xcode :
open "$(pwd -P)/build/xcode/tgc.xcodeproj"Exécuter directement le template compilé :
./build/xcode/templates/simple_fmt/Debug/simple_fmt
./build/xcode/templates/simple_fmt/Release/simple_fmtLe preset Xcode est disponible uniquement sur macOS.
La signature avec une identité Apple Development stable évite que macOS considère chaque nouveau build comme une nouvelle application lorsqu'il est exécuté depuis un volume amovible.
Afficher les identités disponibles :
security find-identity -v -p codesigningConfigurer un build Ninja signé :
cmake --preset ninja-debug \
-DTGC_CODESIGN_IDENTITY="Apple Development: name@example.com (TEAM_ID)"
cmake --build --preset ninja-debugConfigurer le projet Xcode signé :
cmake --preset xcode \
-DTGC_CODESIGN_IDENTITY="Apple Development: name@example.com (TEAM_ID)"
cmake --build --preset xcode-debugL'identité est conservée dans le cache du répertoire de build. Il faut la fournir à nouveau après une configuration avec --fresh ou après avoir supprimé ce répertoire.
Vérifier la signature :
codesign --verify --strict --verbose=2 \
build/ninja-debug/templates/simple_fmt/simple_fmt
codesign -dvv --requirements - \
build/ninja-debug/templates/simple_fmt/simple_fmtL'identité personnelle ne doit pas être ajoutée à CMakePresets.json. Elle peut être conservée dans un CMakeUserPresets.json, ignoré par Git.
Après configuration depuis le terminal, VS Code réutilise l'identité enregistrée dans le cache CMake correspondant.
Ouvrir le dépôt :
code .Ouvrir la palette de commandes avec Cmd+Shift+P sur macOS ou Ctrl+Shift+P sur Windows/Linux, puis utiliser les commandes suivantes.
- CMake: Select Configure Preset
- sélectionner Ninja Debug ou Ninja Release
- CMake: Configure
- CMake: Select Build Preset
- sélectionner le preset Ninja correspondant
- CMake: Build
- CMake: Select Configure Preset
- sélectionner Xcode
- CMake: Configure
- CMake: Select Build Preset
- sélectionner xcode-debug ou xcode-release
- CMake: Build
- CMake: Set Launch/Debug Target
- sélectionner simple_fmt
- utiliser CMake: Run Without Debugging pour l'exécuter
- ou utiliser CMake: Debug pour démarrer le débogueur
Si l'autocomplétion clangd ne se met pas à jour :
- CMake: Configure avec le preset Ninja Debug
- clangd: Restart language server
- si nécessaire, Developer: Reload Window
Chaque répertoire templates/<nom> produit automatiquement une cible portant le même nom.
Les sources C++ sont découvertes récursivement dans :
templates/<nom>/src
templates/<nom>/platform/<CMAKE_SYSTEM_NAME>
Seules les sources correspondant à la plateforme cible sont compilées. Par exemple, sur macOS, CMake utilise platform/Darwin.