Installation

Installation rapide (5 minutes)

TL;DR - Développeurs expérimentés

# Installez Go 1.25+, puis :
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
wails3 doctor  # Vérifiez l'installation

Si wails3 doctor réussit, vous avez terminé. Passer à la première application →

Installation étape par étape

1. Installer Go (Requis)

   Wails nécessite Go 1.25 ou une version ultérieure.

   Windows

   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.

   macOS

   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

   Linux

   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

2. Installer les dépendances de la plateforme

   Windows

   WebView2 Runtime (généralement préinstallé)

   Windows 10/11 inclut WebView2 par défaut. Si manquant :

   • Téléchargez-le depuis Microsoft
   • Ou exécutez wails3 doctor plus tard — il vous guidera

   C’est tout ! Aucune autre dépendance n’est nécessaire.

   Astuce de performance pour Windows 11

   Envisagez d’utiliser Dev Drive pour stocker vos projets. Les Dev Drives sont optimisés pour les charges de travail des développeurs et peuvent améliorer considérablement les temps de build et les vitesses d’accès au disque jusqu’à 30 %.

   macOS

   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.

   Linux

   Outils de compilation et WebKit

   Versions minimales des distributions

   Wails v3 nécessite WebKitGTK 4.1 (utilise libsoup3). Les versions antérieures qui ne livrent que la 4.0 — Ubuntu 20.04, Debian 11, RHEL 8/9 et leurs dérivés — ne sont pas prises en charge.

   Ubuntu/Debian

   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

   Fedora

   sudo dnf install gcc pkg-config gtk3-devel webkit2gtk4.1-devel

   Arch

   sudo pacman -S base-devel gtk3 webkit2gtk-4.1

   openSUSE

   sudo zypper install gcc pkg-config gtk3-devel webkit2gtk3-devel

   Gentoo

   sudo emerge --ask net-libs/webkit-gtk:4.1

   NixOS

   Ajoutez à votre shell.nix ou devShell :

   buildInputs = with pkgs; [ webkitgtk_4_1 gtk3 pkg-config gcc ];

   Autre

   Exécutez wails3 doctor après avoir installé Wails — il affichera les paquets exacts nécessaires pour votre distribution.

   Optionnel : Prise en charge de GTK4

   Wails prend également en charge expérimentalement GTK4 / WebKitGTK 6.0. Si vous souhaitez construire avec GTK4, installez les dépendances supplémentaires pour votre distribution et construisez avec wails3 build -tags gtk4. Voir Packaging Linux - GTK4 pour plus de détails.

3. 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).

4. 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   | v3.0.0-alpha.40 |
   | 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!

   Si la commande wails3 est introuvable

   Votre ~/go/bin n’est pas dans le PATH. Voir l’étape 1 ci-dessus pour corriger cela, puis redémarrez votre terminal.

5. Installer npm (Optionnel mais recommandé)

   La plupart des modèles Wails utilisent npm pour les outils frontend.

   Windows

   Téléchargez depuis nodejs.org et exécutez l’installateur.

   Vérifier :

   npm --version

   macOS

   Option 1 : Installateur officiel Téléchargez depuis nodejs.org

   Option 2 : Homebrew

   brew install node

   Vérifier :

   npm --version

   Linux

   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

   Gestionnaires de paquets alternatifs

   Vous préférez pnpm, yarn ou bun ? Pas de problème ! Mettez simplement à jour le Taskfile.yml de votre projet pour utiliser votre outil préféré.

Dépannage

Commande wails3 introuvable

Cause : ~/go/bin (ou %USERPROFILE%\go\bin) n’est pas dans votre PATH.

Solution :

Windows

1. Ouvrez “Variables d’environnement” (recherchez dans le menu Démarrer)
2. Sous “Variables utilisateur”, trouvez Path
3. Cliquez sur “Modifier” → “Nouveau”
4. Ajoutez : C:\Users\VotreNom\go\bin (remplacez VotreNom)
5. Cliquez sur “OK” sur toutes les boîtes de dialogue
6. Redémarrez votre terminal

Vérifier :

$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }

macOS/Linux

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-dev

Windows : 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 :

Windows/macOS

Téléchargez la dernière version depuis go.dev/dl et réinstallez-la.

Linux

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

Version de développement

• Peut contenir des bogues ou des modifications incompatibles
• Les projets créés utiliseront la directive replace pour pointer vers Wails local
• Seulement recommandé pour les contributeurs ou pour tester de nouvelles fonctionnalités

Prochaines étapes

Installation terminée ! Votre système est prêt pour le développement avec Wails.

Créez votre première application

Créez une application fonctionnelle en 10 minutes.

Tutoriel première application →

Explorez les modèles

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.