Installation
Installation rapide (5 minutes)
Installation étape par étape
Installer Go (Requis)
Wails nécessite Go 1.25 ou une version ultérieure.
Téléchargez l’installateur Windows depuis go.dev/dl et exécutez-le.
Vérifier l’installation :
go version # Doit afficher 1.25 ou une version ultérieure
Vérifier le PATH :
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Si le résultat est vide, ajoutez C:\Users\VotreNom\go\bin à votre PATH.
Option 1 : Installateur officiel
Téléchargez l’installateur macOS (fichier .pkg) depuis go.dev/dl et exécutez-le.
Option 2 : Homebrew
brew install go
Vérifier l’installation :
go version # Doit afficher 1.25 ou une version ultérieure
echo $PATH | grep go/bin # Doit afficher ~/go/bin
Si ~/go/bin n’est pas dans le PATH, ajoutez-le à ~/.zshrc ou ~/.bash_profile :
export PATH=$PATH:~/go/bin
Option 1 : Archive officielle
Téléchargez l’archive Linux depuis go.dev/dl, puis :
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Option 2 : Gestionnaire de paquets
# Ubuntu/Debian
sudo apt install golang-go
# Fedora
sudo dnf install golang
# Arch
sudo pacman -S go
Ajouter au PATH (ajoutez à ~/.bashrc ou ~/.zshrc) :
export PATH=$PATH:/usr/local/go/bin:~/go/bin
source ~/.bashrc # Recharger
Vérifier :
go version
echo $PATH | grep go/bin
Installer les dépendances de la plateforme
WebView2 Runtime (généralement préinstallé)
Windows 10/11 inclut WebView2 par défaut. Si manquant :
- Téléchargez-le depuis [Microsoft](https://developer.microsoft.com/microsoft-edge/webview2/)
- Ou exécutez `wails3 doctor` plus tard — il vous guidera
**C'est tout !** Aucune autre dépendance n'est nécessaire.
Outils en ligne de commande Xcode (requis)
xcode-select --install
Cliquez sur “Installer” dans la boîte de dialogue qui apparaît.
Vérifier :
xcode-select -p # Doit afficher /Library/Developer/CommandLineTools
C’est tout ! macOS inclut WebKit par défaut.
Outils de compilation et WebKit
Nécessite Ubuntu 22.04+ ou Debian 12+.
sudo apt update
sudo apt install build-essential pkg-config libgtk-3-dev libwebkit2gtk-4.1-dev
sudo dnf install gcc pkg-config gtk3-devel webkit2gtk4.1-devel
sudo pacman -S base-devel gtk3 webkit2gtk-4.1
sudo zypper install gcc pkg-config gtk3-devel webkit2gtk3-devel
sudo emerge --ask net-libs/webkit-gtk:4.1
Ajoutez à votre shell.nix ou devShell :
buildInputs = with pkgs; [ webkitgtk_4_1 gtk3 pkg-config gcc ];Exécutez wails3 doctor après avoir installé Wails — il affichera les paquets exacts nécessaires pour votre distribution.
Installer l'interface de ligne de commande Wails
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
Cela installe la commande wails3 dans ~/go/bin (ou %USERPROFILE%\go\bin sur Windows).
Vérifier l'installation
wails3 doctor
Sortie attendue (ou similaire) :
Wails (v3.0.0-dev) Wails Doctor
# System
┌──────────────────────────────────────────────────┐
| Name | MacOS |
| Version | 26.0 |
| ID | 25A354 |
| Branding | MacOS 26.0 |
| Platform | darwin |
| Architecture | arm64 |
| Apple Silicon | true |
| CPU | Apple M2 Pro |
| CPU 1 | Apple M2 Pro |
| CPU 2 | Apple M2 Pro |
| GPU | 16 cores, Metal Support: Metal 4 |
| Memory | 16 GB |
└──────────────────────────────────────────────────┘
# Build Environment
┌─────────────┬─────────────────┐
| Wails CLI | Votre version installée |
| Go Version | go1.24.6 |
└─────────────┴─────────────────┘
# Dependencies
┌─────────────────┬─────────────────────────────────────────────────┐
| npm | 11.6.2 |
| *NSIS | Not Installed. Install with `brew install...`. |
| Xcode cli tools | 2412 |
└─────────────────┴─────────────────────────────────────────────────┘
# Checking for issues
SUCCESS No issues found
# Diagnosis
SUCCESS Your system is ready for Wails development!Installer npm (Optionnel mais recommandé)
La plupart des modèles Wails utilisent npm pour les outils frontend.
Option 1 : Installateur officiel Téléchargez depuis nodejs.org
Option 2 : Homebrew
brew install node
Vérifier :
npm --version
Option 1 : NodeSource
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs # Ubuntu/Debian
Option 2 : Gestionnaire de paquets
sudo dnf install nodejs # Fedora
sudo pacman -S nodejs npm # Arch
Vérifier :
npm --version
Dépannage
Commande wails3 introuvable
Cause : ~/go/bin (ou %USERPROFILE%\go\bin) n’est pas dans votre PATH.
Solution :
- Ouvrez “Variables d’environnement” (recherchez dans le menu Démarrer)
- Sous “Variables utilisateur”, trouvez
Path - Cliquez sur “Modifier” → “Nouveau”
- Ajoutez :
C:\Users\VotreNom\go\bin(remplacez VotreNom) - Cliquez sur “OK” sur toutes les boîtes de dialogue
- Redémarrez votre terminal
Vérifier :
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Ajoutez à ~/.zshrc (macOS) ou ~/.bashrc (Linux) :
export PATH=$PATH:~/go/bin
Rechargez :
source ~/.zshrc # ou ~/.bashrc
Vérifier :
echo $PATH | grep go/bin
wails3 version
wails3 doctor signale des dépendances manquantes
Linux : La sortie vous indique exactement quels paquets installer. Exemple :
❌ webkit2gtk introuvable
Installez avec : sudo apt install libwebkit2gtk-4.1-devWindows : Si WebView2 est manquant :
- Téléchargez depuis Microsoft
- Ou il sera installé automatiquement lors de l’exécution de votre première application
macOS : Si les outils Xcode sont manquants :
xcode-select --install
Version de Go trop ancienne
Wails v3 nécessite Go 1.25+. Si vous avez une version plus ancienne :
Téléchargez la dernière version depuis go.dev/dl et réinstallez-la.
Téléchargez la dernière archive tarball depuis go.dev/dl, puis :
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Version de développement (Bleeding Edge)
Vous souhaitez utiliser le code le plus récent issu de la branche de développement principale ? Cela vous donne accès aux nouvelles fonctionnalités et aux correctifs avant leur publication, mais comporte le risque de bogues et de modifications incompatibles. Seulement recommandé pour les contributeurs ou ceux qui doivent tester les fonctionnalités à venir.
git clone https://github.com/wailsapp/wails.git
cd wails
git checkout v3
cd v3/cmd/wails3
go install
Prochaines étapes
Installation terminée ! Votre système est prêt pour le développement avec Wails.
Créez une application fonctionnelle en 10 minutes.
Découvrez ce qui est disponible nativement.
wails3 init -l # Lister les modèles
Vous rencontrez des problèmes ? Posez votre question sur Discord ou ouvrez un ticket.