Installation
Installez Wails et préparez votre environnement pour créer des applications
Installation rapide (5 minutes)
Installation pas à pas
Installer Go (obligatoire)
Wails nécessite Go 1.25 ou une version ultérieure.
Téléchargez le programme d’installation pour Windows depuis go.dev/dl, puis exécutez-le.
Vérifiez l’installation :
go version # Should show 1.25 or later
Vérifiez le PATH :
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
S’il est vide, ajoutez C:\Users\YourName\go\bin à votre PATH.
Option 1 : programme d’installation officiel
Téléchargez le programme d’installation pour macOS (fichier .pkg) depuis go.dev/dl, puis exécutez-le.
Option 2 : Homebrew
brew install go
Vérifiez l’installation :
go version # Should show 1.25 or later
echo $PATH | grep go/bin # Should show ~/go/bin
Si ~/go/bin ne figure pas dans le PATH, ajoutez-le à ~/.zshrc ou à ~/.bash_profile :
export PATH=$PATH:~/go/bin
Option 1 : archive tar officielle
Téléchargez l’archive tar pour 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
Ajoutez au PATH (ajoutez à ~/.bashrc ou à ~/.zshrc) :
export PATH=$PATH:/usr/local/go/bin:~/go/bin
source ~/.bashrc # Reload
Vérifiez :
go version
echo $PATH | grep go/bin
Installer les dépendances de la plateforme
Runtime WebView2 (généralement préinstallé)
Windows 10/11 inclut WebView2 par défaut. S’il est absent :
- Téléchargez-le depuis Microsoft
- Vous pouvez aussi exécuter
wails3 doctorultérieurement : il vous guidera
C’est tout ! Aucune autre dépendance n’est nécessaire.
Outils de ligne de commande Xcode (obligatoires)
xcode-select --install
Cliquez sur « Installer » dans la boîte de dialogue qui s’affiche.
Vérifiez :
xcode-select -p # Should show /Library/Developer/CommandLineTools
C’est tout ! macOS inclut WebKit par défaut.
Outils de compilation et WebKit
La pile GTK4 par défaut nécessite Ubuntu 24.04 ou version ultérieure, ou Debian 13 ou version ultérieure.
sudo apt update
sudo apt install build-essential pkg-config libgtk-4-dev libwebkitgtk-6.0-dev
sudo dnf install gcc pkg-config gtk4-devel webkitgtk6.0-devel
sudo pacman -S base-devel gtk4 webkitgtk-6.0
sudo zypper install gcc pkg-config gtk4-devel webkitgtk-6_0-devel
sudo emerge --ask net-libs/webkit-gtk:6
Ajoutez ceci à votre shell.nix ou à votre devShell :
buildInputs = with pkgs; [ webkitgtk_6_0 gtk4 pkg-config gcc ];Exécutez wails3 doctor après avoir installé Wails : cette commande indiquera précisément les paquets requis pour votre distribution.
Installer l’interface en ligne de commande de Wails
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
Cette opération installe la commande wails3 dans ~/go/bin (ou dans %USERPROFILE%\go\bin sous Windows).
Exécuter l’assistant de configuration (recommandé)
wails3 setup
L’assistant de configuration vérifiera vos dépendances, vous aidera à installer celles qui manquent et configurera les valeurs par défaut des projets.
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 | Your installed version |
| Go Version | go1.25.0 |
└─────────────┴─────────────────┘
# 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 (facultatif, mais recommandé)
La plupart des modèles Wails utilisent npm pour les outils de développement frontend.
Téléchargez-le depuis nodejs.org, puis exécutez le programme d’installation.
Vérifiez :
npm --version
Option 1 : programme d’installation officiel Téléchargez-le depuis nodejs.org
Option 2 : Homebrew
brew install node
Vérifiez :
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érifiez :
npm --version
Dépannage
Commande wails3 introuvable
Cause : ~/go/bin (ou %USERPROFILE%\go\bin) ne figure pas dans votre PATH.
Solution :
- Ouvrez « Variables d’environnement » (recherchez ce terme dans le menu Démarrer).
- Sous « Variables utilisateur », recherchez
Path. - Cliquez sur « Modifier » → « Nouveau ».
- Ajoutez :
C:\Users\YourName\go\bin(remplacezYourName). - Cliquez sur « OK » dans toutes les boîtes de dialogue.
- Redémarrez votre terminal
Vérifiez :
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Ajoutez ceci à ~/.zshrc (macOS) ou à ~/.bashrc (Linux) :
export PATH=$PATH:~/go/bin
Rechargez :
source ~/.zshrc # or ~/.bashrc
Vérifiez :
echo $PATH | grep go/bin
wails3 version
wails3 doctor signale des dépendances manquantes
Linux : la sortie indique précisément les paquets à installer. Exemple :
❌ webkit2gtk not found
Install with: sudo apt install libwebkit2gtk-4.1-devWindows : si WebView2 est manquant :
- Téléchargez-le depuis Microsoft.
- Sinon, il sera installé automatiquement lors de la première exécution de votre application.
macOS : si les outils Xcode sont manquants :
xcode-select --install
Version de Go trop ancienne
Wails v3 nécessite Go 1.25 ou version ultérieure. Si vous disposez d’une version plus ancienne :
Téléchargez la dernière version depuis go.dev/dl, puis réinstallez-la.
Téléchargez la dernière archive tar depuis go.dev/dl, puis procédez comme suit :
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Version de développement (à la pointe)
Vous souhaitez utiliser le code le plus récent de la branche principale de développement ? Vous accéderez ainsi aux nouvelles fonctionnalités et aux correctifs avant leur publication, mais vous vous exposez à des bogues et à des modifications incompatibles. Cette version est recommandée uniquement aux contributeurs et aux personnes 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
Étapes suivantes
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 immédiatement.
wails3 init -l # List templates
Vous rencontrez des problèmes ? Posez votre question sur Discord ou ouvrez un ticket.