Files
apex/docs/WINDOWS.md
T
2026-02-13 00:21:53 +01:00

2.6 KiB
Raw Blame History

Build sur Windows — Dépannage

Le client utilise Vite, qui s’appuie sur esbuild (binaire natif fourni pour Windows : @esbuild/win32-x64/esbuild.exe). Aucune compilation C++ n’est nécessaire : ce sont des exécutables précompilés.

Vous avez désinstallé « Windows Development » / « Windows Developer » (~2 Go)

Le logiciel d’environ 2 Go dont le nom contient Windows Development ou Windows Developer est en général :

  • Visual Studio Build Tools (outils de génération Visual Studio), ou
  • Windows SDK (Software Development Kit), ou
  • un composant « Développement Windows » de Visual Studio.

Pour ce projet (Vite + esbuild), vous n’avez pas besoin de réinstaller tout ça. Il suffit d’installer le runtime qui va avec, beaucoup plus léger.

1. Réinstaller uniquement le Visual C++ Redistributable (souvent suffisant)

Après la désinstallation du gros paquet « Windows Development », il peut manquer le Visual C++ Redistributable (quelques dizaines de Mo). C’est lui qui permet d’exécuter des .exe natifs comme esbuild.exe.

Pas besoin de réinstaller les 2 Go de « Windows Development » pour faire tourner le build.

2. Réinstaller les dépendances du client

cd client
Remove-Item -Recurse -Force node_modules
Remove-Item -Force package-lock.json
npm install
npm run build

3. Antivirus / Windows Defender

Parfois l’antivirus ou Windows Defender bloque l’exécution de esbuild.exe.

  • Ajouter une exclusion pour le dossier du projet (ou au minimum client\node_modules) dans Windows Defender / antivirus.
  • Relancer npm run build.

4. Droits / exécution

  • Lancer PowerShell ou CMD en tant qu’administrateur une fois, aller dans client/ et lancer npm run build pour vérifier si le problème vient des droits.
  • Vérifier que le disque n’est pas en lecture seule et que le dossier n’est pas synchronisé par OneDrive/Dropbox au moment du build.

5. Node et npm à jour

node -v   # 18+ recommandé
npm -v

Si besoin, réinstaller Node depuis nodejs.org (version LTS).


En résumé : après avoir désinstallé des outils de dev Windows, réinstaller le Visual C++ Redistributable et refaire un npm install dans client/ règle souvent le problème.