13 KiB
PHASE 21 — Build demo légère + packaging distribuable
Objectif
Produire un .exe Vercora envoyable à quelqu'un qui n'a ni le dépôt ni
l'environnement de développement (pas de Vulkan SDK, pas de VC++
Redistributable installé, pas CMake), qui montre le terrain LiDAR réel
25 km² avec LOD/streaming, l'orthophoto, les arbres/herbe procéduraux, la
marche et le vol libre — et rien d'autre.
1. Configuration "démo" : un flag runtime, pas une macro de compilation
Choix : --demo, un argument de ligne de commande lu dans main()
(comme --no-wildlife, --no-scene, etc.), plutôt qu'une macro
VERCORA_DEMO évaluée à la compilation.
Raison : la démo ne retire aucun code, seulement de l'initialisation —
exactement le rôle que jouent déjà --no-wildlife et --no-scene depuis les
Phases 17 et 15. Une deuxième configuration de build à maintenir en parallèle
(macro + #ifdef disséminés) aurait un coût permanent pour un besoin
ponctuel, et le harnais de validation Vulkan (tools/run_vulkan_check.ps1)
continue de piloter le binaire normal sans rien changer.
--demo fait exactement ceci, au démarrage (voir src/main.cpp, recherche
demoMode) :
- force
useWildlife = false→ faune et mémoire du milieu (Habitat) coupées, comme--no-wildlife; - force
useScene = falseetstartInEditor = false→ aucun objet posé chargé/sauvé, touche F2 sans effet (le bloc qui bascule le mode éditeur est déjà gardé parterrainScene && useScene) ; - désactive
Needsen entier (jauges, effet sur la vitesse de marche, boire) — la vitesse redevient la constantekWalkSpeed, non modulée ; - coupe les touches parapente (V), vélo (B) et escalade (X) : les blocs
d'entrée dans ces activités sont gardés par
!demoMode; - coupe abattage (E), ramassage (R) et percussion (C) : même garde. La forêt et le sol restent construits, visibles et solides (collision inchangée) — seule l'interaction est coupée, pas le rendu ni la géométrie.
- charge par défaut la dalle de la zone entière (
vercora_zone_1m.vchm, 25 km²) et non plus la dalle unique de développement (LHD_0907_6440_1m.vchm), avec repli en cascade sur la version 2 m si le package ne contient que celle-ci (voir §3).
Ce que --demo NE touche PAS : LOD/streaming du terrain, orthophoto,
végétation procédurale (arbres et herbe), marche, vol libre (F), compteur
FPS. C'est exactement le périmètre demandé.
Usage :
vercora.exe --demo
Se combine avec les autres options existantes si besoin (--start=E,N,
--no-grass, etc.) — --demo ne fait que poser des défauts, il ne bloque
rien.
2. Chemins : la fin des chemins absolus codés en dur
Avant cette phase, ASSETS_DIR et SHADERS_OUTPUT_DIR étaient deux macros
CMake portant le chemin absolu du dépôt de développement
(C:/Users/theog/Documents/_CODE/_Vercora/...). Correct pour développer
(l'exécutable retrouve ses données depuis n'importe quel répertoire courant),
mais rend le binaire indistribuable : sur une autre machine, ces chemins ne
désignent rien.
Nouveau fichier src/core/Paths.hpp / .cpp : résout assetsDir() et
shadersDir() avec la règle suivante, dans cet ordre —
- le sous-dossier
assets\(oushaders\) à côté de l'exécutable, s'il existe → cas du package distribué ; - sinon la macro CMake (
ASSETS_DIR/SHADERS_OUTPUT_DIR) → cas du développement, comportement inchangé.
L'exécutable de développement (compilé dans build\, sans dossier assets\
ni shaders\ juste à côté) retombe donc automatiquement sur l'ancien
comportement — rien ne change pour le développement courant, y compris
le harnais de validation Vulkan qui pointe toujours vers build\vercora.exe.
Le même binaire copié dans un dossier qui contient assets\ et shaders\
lit ceux-là.
GetModuleFileNameW (Windows) donne le chemin de l'exécutable ; le résultat
est mis en cache (une résolution touche le disque, et assetsDir() est
interrogée à chaque chargement de dalle).
Fichiers modifiés pour utiliser ces fonctions plutôt que les macros
directement : src/renderer/Pipeline.cpp (chemin des .spv),
src/main.cpp (kDefaultTerrainFile, kDemoTerrainFile,
kDemoTerrainFallback, kEditorAssetsDir, kScenesDir).
Ce qui reste dans le binaire : les macros ASSETS_DIR et
SHADERS_OUTPUT_DIR définies par CMake existent toujours (elles servent de
repli, cas 2 ci-dessus), donc leur valeur — le chemin absolu du poste de
développement — reste une chaîne de caractères embarquée dans l'exécutable.
Elle n'est jamais lue quand le dossier adjacent existe (le cas du
package), mais elle est visible par un outil comme strings. Sans
conséquence fonctionnelle ni fuite de données sensibles (c'est un chemin de
projet local, pas une information personnelle exploitable), mais à savoir
si le binaire est un jour distribué à quelqu'un qui inspecterait ses chaînes.
3. Build Release
tools\build.bat Release fonctionne sans modification (le script acceptait
déjà Debug/Release en paramètre). Confirmé :
CMAKE_BUILD_TYPE=Releasecorrectement appliqué (vérifié dansCMakeCache.txt) ;VERCORA_DEBUGn'est définie que par$<$<CONFIG:Debug>:VERCORA_DEBUG>dansCMakeLists.txt→ absente en Release ;src/renderer/VulkanContext.cppn'activeVK_LAYER_KHRONOS_validationque sous#ifdef VERCORA_DEBUG→ aucune couche de validation demandée en Release, confirmé par lancement réel (voir §5).- Taille de l'exécutable Release : 844 Ko (optimisations activées, pas de symboles de debug embarqués comme en Debug).
Attention pratique notée pendant cette phase : tools\build.bat réutilise
toujours le dossier build\ quel que soit le paramètre — changer de
configuration dedans exige que vercora.exe ne soit pas verrouillé par un
processus en cours (sinon LNK1168/LNK1104 à l'édition de liens). Le
dossier build\ a été remis en configuration Debug à la fin de cette
phase, pour laisser l'environnement de développement inchangé.
4. Dépendances runtime identifiées
dumpbin /dependents sur l'exécutable Release :
| DLL | Origine | Présente sur une machine tierce ? |
|---|---|---|
vulkan-1.dll |
pilote GPU (NVIDIA/AMD/Intel) | Oui sur toute machine avec des pilotes à jour depuis ~2016. Non fournie dans le package — installée par les pilotes, pas par le SDK Vulkan (le SDK ne redistribue pas ce fichier ; vérifié : absent de l'arborescence C:\VulkanSDK\...). |
KERNEL32.dll, USER32.dll, GDI32.dll, SHELL32.dll |
Windows | Toujours présentes (composants du système). |
MSVCP140.dll, VCRUNTIME140.dll, VCRUNTIME140_1.dll |
Visual C++ Redistributable 2015-2022 (x64) | Pas garanti sur une machine neuve. Fournies dans le package, copiées depuis VC\Redist\MSVC\...\x64\Microsoft.VC145.CRT\ de l'installation Visual Studio (fichiers officiellement redistribuables). |
api-ms-win-crt-*.dll (8 fichiers) |
Universal CRT | Composant du système depuis Windows 10 1607+ / présent nativement sur Windows 10/11. Non fournies, non nécessaires. |
Conséquence : l'ami n'a rien à installer si sa machine est un Windows 10/11 avec des pilotes GPU à jour (le cas normal de tout PC utilisé pour jouer ou avec une mise à jour Windows Update récente). La seule vraie inconnue est l'état de ses pilotes GPU — voir §6.
vulkan-1.dll n'a PAS été ajoutée au package : c'est un composant lié au
pilote installé (son fichier ICD JSON dans le registre pointe vers un pilote
précis), embarquer une copie risquerait un dépareillage silencieux plutôt que
d'aider. Mieux vaut que l'ami ait la version que son propre pilote a posée.
5. Contenu exact du package (dist/VercoraDemo/)
vercora.exe 844 Ko (Release, sans validation layers)
msvcp140.dll 629 Ko (VC++ Redistributable)
vcruntime140.dll 174 Ko (VC++ Redistributable)
vcruntime140_1.dll 49 Ko (VC++ Redistributable)
LisezMoi.txt (mode d'emploi pour l'ami)
shaders/
cube.vert.spv, cube.frag.spv
terrain.vert.spv, terrain.frag.spv
foliage.vert.spv, foliage.frag.spv 40 Ko au total
assets/terrain/
vercora_zone_1m.vchm 95,4 Mo (terrain 25 km², pas 1 m)
vercora_zone_ortho.vcto 42,7 Mo (orthophoto drapee)
Total : 140 Mo.
Alternative plus légère non retenue par défaut mais disponible si besoin :
remplacer vercora_zone_1m.vchm par vercora_zone_2m.vchm (23,9 Mo au lieu
de 95,4 Mo) → package total ≈ 68 Mo, même emprise de 25 km², relief deux fois
moins fin. Le code gère déjà ce repli tout seul si seule la dalle 2 m est
présente (voir kDemoTerrainFallback dans src/main.cpp).
Aucun fichier _canopy : absent du package, sans conséquence (le jeu retombe
sur un semis de végétation par pente/altitude, avec un message de log qui le
dit explicitement — comportement déjà existant, pas ajouté pour la démo).
6. Tests effectués
- Build Debug normal (développement) : compile sans erreur après tous les changements de cette phase.
- Scénario A du harnais de validation Vulkan
(
tools\run_vulkan_check.ps1 -Only A) sur le build Debug : 0 message [Validation], 0 [ERROR], fermeture propre. Gameplay réellement exercé (abattage, ramassage, percussion, bascule marche/vol). Confirme que les changements de chemins et le flag--demon'ont rien cassé sur le chemin de développement normal. --dump-world --demo(sans fenêtre ni Vulkan) : la zone 25 km² se charge, la faune/besoins sont bien annoncés comme désactivés dans les logs.- Build Release : compile et édite les liens sans erreur ; confirmé
CMAKE_BUILD_TYPE=Releaseet absence deVERCORA_DEBUG. - Test d'emplacement tiers : le dossier
dist/VercoraDemo/entier copié sur le lecteur E: (disque différent de celui du dépôt), lancé depuis là :vercora.exe --dump-world --demo: charge correctement la zone 25 km² depuisE:\VercoraDemoTest\VercoraDemo\assets\...— preuve que la résolution de chemin ne dépend plus de l'emplacement du dépôt ;- lancement réel avec fenêtre Vulkan (
--demo --lock-input, 5 secondes puis fermeture forcée pour le test) : instance Vulkan créée, GPU détecté (Intel UHD Graphics 770 sur cette machine), les trois pipelines (cube/terrain/foliage) chargés depuisE:\...\shaders\, orthophoto 8192×8192 chargée et liée au terrain, quadtree et streaming actifs, aucune ligne d'erreur sur stderr. Le processus est resté vivant tout le temps du test (pas de crash immédiat). - Build Debug restauré dans
build\après ce test pour ne rien changer à l'environnement de développement habituel.
7. Ce que je NE peux PAS garantir à 100 % sans machine tierce réelle
Le test ci-dessus est le plus proche possible de "ça marche chez l'ami" sans y avoir accès, mais il reste sur la même machine, le même GPU (Intel UHD Graphics 770), les mêmes pilotes, la même version de Windows. Restent inconnus :
- Le GPU et les pilotes de l'ami. Vercora demande Vulkan 1.2 ; c'est supporté par toute carte NVIDIA/AMD/Intel de moins d'une dizaine d'années avec des pilotes à jour, mais je ne peux pas vérifier SA machine. → À demander à l'ami : que ses pilotes GPU soient à jour (site du fabricant, pas seulement Windows Update qui est parfois en retard).
- Windows 7/8 : non testé, non visé (l'API
GetModuleFileNameWutilisée fonctionne dès Windows XP donc ce n'est pas un obstacle technique connu, mais Vulkan et des pilotes récents sont peu probables sur ces systèmes). → À demander à l'ami : Windows 10 ou 11. - Antivirus/SmartScreen :
vercora.exen'est pas signé numériquement. Sur CETTE machine, Smart App Control bloque déjà les binaires non signés fraîchement compilés (voir le commentaire dedumpWorlddanssrc/main.cpp) — c'est probable que Windows Defender SmartScreen affiche un avertissement chez l'ami aussi au premier lancement. Documenté dansLisezMoi.txtdu package (bouton "Informations complémentaires" puis "Exécuter quand même"). - Taille du transfert (140 Mo) : trop gros pour la plupart des pièces jointes email (limite Gmail : 25 Mo). Nécessite un service de transfert de fichiers (WeTransfer, Google Drive/OneDrive avec lien de partage, etc.) plutôt qu'un email direct.
Fichiers modifiés/créés dans cette phase
src/core/Paths.hpp,src/core/Paths.cpp(nouveaux)CMakeLists.txt: ajout desrc/core/Paths.cppaux sourcessrc/renderer/Pipeline.cpp:shadersDir()au lieu deSHADERS_OUTPUT_DIRdirectsrc/main.cpp: flag--demo,kDemoTerrainFile/kDemoTerrainFallback,resolvedTerrainFile, gardes!demoModesur Needs/vélo/parapente/ escalade/abattage/ramassage/percussion, chemins viaassetsDir()NOTES-PHASE21.md(ce fichier)dist/VercoraDemo/: package distribuable (non versionné — voir.gitignoresi un dépôt git existe un jour ; ce projet n'est actuellement pas un dépôt git)