Installation

Plates-formes Prises en charge

• Windows 10/11 AMD64/ARM64
• MacOS 10.15+ AMD64 for development, MacOS 10.13+ for release
• MacOS 11.0+ ARM64
• Linux AMD64/ARM64

Dépendances

Wails a un certain nombre de dépendances communes qui sont nécessaires avant l'installation :

• Go 1.21+ (macOS 15+ requires Go 1.23.3+)
• NPM (Node 15+)

Go

Télécharger Go à partir de la Page de téléchargement.

Assurez-vous que vous suivez les instructions officielles de l'installation de Go. Vous devrez également vous assurer que votre variable d'environnement PATH inclut également le chemin vers votre répertoire ~/go/bin. Redémarrez votre terminal et effectuez les vérifications suivantes :

• Vérifiez que Go est installé correctement : go version
• Vérifiez que "~/go/bin" est dans votre variable PATH : echo $PATH | grep go/bin

NPM

Téléchargez le NPM à partir de la page de téléchargement de Node. Il est préférable d'utiliser la dernière version car c'est avec celle-là que nous effectuons nos tests.

Exécutez npm --version pour vérifier.

Dépendances spécifiques aux plateformes

Vous devrez également installer des dépendances spécifiques liés à la plateforme que vous utilisez :

Windows

Wails a besoin que les outils de command line xocde soient installés. Cela peut être fait en exécutant xcode-select --install.

MacOS

Wails a besoin que WebView2 runtime soit installé. Certaines installations de Windows auront déjà installé cette fonctionnalité. Vous pouvez vérifier en utilisant la commande wails doctor.

Linux

Linux a besoin de gcc comme outil de compilation en plus de libgtk3 et libwebkit. Plutôt que de lister une tonne de commandes pour différentes distributions, Wails peut essayer de déterminer ce que sont les commandes d'installation pour votre distribution. Exécutez wails doctor après l'installation pour voir de quelles dépendances vous avez besoin. Si votre gestionnaire de distribution/paquet n'est pas pris en charge, veuillez consulter le guide Ajouter une distribution Linux.
Note:
If you are using latest Linux version (example: Ubuntu 24.04) and it is not supporting libwebkit2gtk-4.0-dev, then you might encounter an issue in wails doctor: libwebkit not found. To resolve this issue you can install libwebkit2gtk-4.1-dev and during your build use the tag -tags webkit2_41.

Dépendances optionnelles

• UPX pour compresser vos applications.
• NSIS pour générer des installateurs Windows.

Installer Wails

Exécutez go go install github.com/wailsapp/wails/v2/cmd/wails@latest pour installer le CLI.

Note: Si vous obtenez une erreur similaire à ceci:

....\Go\pkg\mod\github.com\wailsapp\wails\v2@v2.1.0\pkg\templates\templates.go:28:12: pattern all:ides/*: no matching files found

vérifiez que vous avez installé Go 1.18+ :

go version

Vérification du système

Exécuter wails doctor qui vérifiera si vous avez les bonnes dépendances installées. Si ce n'est pas le cas, il vous conseillera sur ce qui manque et vous aidera à corriger tout problème.

La commande wails semble manquer ?

Si votre système signale que la commande wails est manquante, assurez-vous que vous avez suivi le guide d'installation correctement. Normalement, cela signifie que le répertoire go/bin du répertoire racine de votre utilisateur n'est pas dans la variable d'environnement PATH . Vous devrez également normalement fermer et réouvrir toutes les commandes ouvertes afin que les modifications apportées à l'environnement par l'installateur soient reflétées dans l'invite de commande.