59 lines
2.6 KiB
Markdown
59 lines
2.6 KiB
Markdown
# 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`.
|
||
|
||
- Télécharger : [Microsoft Visual C++ Redistributable (dernière version)](https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist)
|
||
- Installer la version **x64** (et éventuellement x86 si vous utilisez du 32 bits).
|
||
- Redémarrer le terminal, puis dans `client/` : `npm run build`.
|
||
|
||
Pas besoin de réinstaller les 2 Go de « Windows Development » pour faire tourner le build.
|
||
|
||
### 2. Réinstaller les dépendances du client
|
||
|
||
```powershell
|
||
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
|
||
|
||
```powershell
|
||
node -v # 18+ recommandé
|
||
npm -v
|
||
```
|
||
|
||
Si besoin, réinstaller Node depuis [nodejs.org](https://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.
|