SEQUA-Engine/docs/installation/windows-x64.md

Installation sur Windows x64

Prérequis

• Visual Studio 2022 avec la charge de travail « Développement Desktop en C++ » (MSVC, CMake, Ninja fournis).
• Python 3 dans le PATH (SCons est installé dans engines/godot/.venv par build-godot.ps1).
• Node.js 24 dans le PATH.
• Sous-modules Git pour l'adaptateur Godot :

  git submodule update --init engines/godot/vendor/godot-src engines/godot/vendor/godot-cpp
  

• GPU Vulkan pour l'exécution de Godot.

Optionnel (pour l'inférence GPU, prototype gpu_interop) :

• CUDA Toolkit : .\scripts\install-cuda.ps1 (télécharge ~2,7 Go, installeur interactif, nécessite UAC).
• cuDNN : .\scripts\install-cudnn.ps1 (télécharge ~1,3 Go, accepte la licence NVIDIA, définit la variable utilisateur CUDNN_PATH, installe dans %LOCALAPPDATA%\SEQUA\sdk\cudnn\).

Compiler (mode développement)

Une seule commande construit tout (Godot, C++, interface, installation dans bin\) :

.\scripts\build-all.ps1 [-Type debug|release|asan|all] [-NoTests] [-Godot] [-SkipGodot] [-SkipUi] [-NoStop] [-Clean]

• -Type : debug (défaut), release, asan, ou all (les trois).
• -NoTests : compile sans lancer les tests.
• -Godot : force la reconstruction de Godot (après modification du fork).
• -SkipGodot : ne construit jamais Godot (échoue à la configuration s'il manque).
• -SkipUi : ne construit pas l'interface (installe studio\ui\dist s'il existe).
• -NoStop : échoue au lieu d'arrêter les processus SEQUA qui tournent depuis le dossier visé.
• -Clean : supprime build\<preset> et bin\windows-x64\<type> avant de construire.

Le script :

1. Construit Godot (LibGodot) via build-godot.ps1 (template_debug pour debug, template_release pour release, rien pour asan) — 10 à 20 min la première fois par variante.
2. Lance le preset CMake via build.ps1 (compilation et tests).
3. Construit l'interface (npm ci si node_modules manque, puis npm run build).
4. Arrête les processus SEQUA lancés depuis bin\windows-x64\<type>\ (Studio host, Core, rendu) — Windows refuse de remplacer un fichier en cours d'utilisation. Le Core, qui tourne depuis une copie fantôme, est reconnu à son option --sequa-root.
5. Copie les produits vers bin\windows-x64\<type>\ via cmake --install (adaptateurs, bibliothèque et projet Godot, interface, sequa-root.json).

Exemples :

.\scripts\build-all.ps1
.\scripts\build-all.ps1 -Type all -NoTests

Lancer

Depuis l'image de développement dans bin\ :

# Studio complet (Core + interface)
.\bin\windows-x64\debug\studio\sequa-studio.exe [--dev] [--watch]

# Core seul (trouve sa racine via sequa-root.json ; --sequa-root <dossier> pour forcer)
.\bin\windows-x64\debug\core\sequa-core.exe --render debug --render-headless --render-fps 10

Installer (par utilisateur, sans droits administrateur)

Aucun installeur n'existe encore. Copier le contenu de bin\windows-x64\release\ vers %LOCALAPPDATA%\Programs\SEQUA\ et lancer studio\sequa-studio.exe depuis là.

Sur une autre machine sans Visual Studio : le Microsoft Visual C++ Redistributable 2015-2022 x64 est requis. Les types debug et asan ne tournent que sur une machine de développement.

Désinstaller

1. Fermer Studio.
2. Supprimer le programme installé : %LOCALAPPDATA%\Programs\SEQUA\ (copie installée) ou bin\windows-x64\<type>\ (développement).
3. Données utilisateur (peuvent être supprimées) : %LOCALAPPDATA%\SEQUA\ contenant run\ (fichiers d'exécution, logs, copies fantômes du Core), downloads\, sdk\.
4. Variable d'environnement utilisateur CUDNN_PATH si cuDNN a été installé par le script :

   [Environment]::SetEnvironmentVariable("CUDNN_PATH", $null, "User")
   

5. Restes de développement seulement : build\, engines\godot\.venv\, studio\ui\node_modules\, binaires Godot dans engines\godot\vendor\godot-src\bin\.
6. CUDA Toolkit : désinstaller via « Applications installées » de Windows.