Installation
Wails installieren und für die Anwendungsentwicklung vorbereiten
Schnellinstallation (5 Minuten)
Schrittweise Installation
Go installieren (erforderlich)
Wails erfordert Go 1.25 oder neuer.
Laden Sie das Windows-Installationsprogramm von go.dev/dl herunter und führen Sie es aus.
Installation überprüfen:
go version # Should show 1.25 or later
PATH überprüfen:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Falls die Ausgabe leer ist, fügen Sie C:\Users\YourName\go\bin zu PATH hinzu.
Option 1: Offizielles Installationsprogramm
Laden Sie das macOS-Installationsprogramm (.pkg-Datei) von go.dev/dl herunter und führen Sie es aus.
Option 2: Homebrew
brew install go
Installation überprüfen:
go version # Should show 1.25 or later
echo $PATH | grep go/bin # Should show ~/go/bin
Falls ~/go/bin nicht in PATH enthalten ist, fügen Sie es zu ~/.zshrc oder ~/.bash_profile hinzu:
export PATH=$PATH:~/go/bin
Option 1: Offizielles Tarball
Laden Sie das Linux-Tarball von go.dev/dl herunter und führen Sie dann Folgendes aus:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Option 2: Paketverwaltung
# Ubuntu/Debian
sudo apt install golang-go
# Fedora
sudo dnf install golang
# Arch
sudo pacman -S go
Zu PATH hinzufügen (zu ~/.bashrc oder ~/.zshrc hinzufügen):
export PATH=$PATH:/usr/local/go/bin:~/go/bin
source ~/.bashrc # Reload
Überprüfen:
go version
echo $PATH | grep go/bin
Plattformabhängige Abhängigkeiten installieren
WebView2 Runtime (normalerweise vorinstalliert)
Windows 10/11 enthält WebView2 standardmäßig. Falls es fehlt:
- Von Microsoft herunterladen
- Oder führen Sie später
wails3 doctoraus – der Befehl führt Sie durch die Einrichtung.
Das war alles! Es sind keine weiteren Abhängigkeiten erforderlich.
Xcode Command Line Tools (erforderlich)
xcode-select --install
Klicken Sie im angezeigten Dialog auf „Installieren“.
Überprüfen:
xcode-select -p # Should show /Library/Developer/CommandLineTools
Das war alles! macOS enthält WebKit standardmäßig.
Build-Werkzeuge und WebKit
Für den standardmäßigen GTK4-Stack ist Ubuntu 24.04+ oder Debian 13+ erforderlich.
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
Fügen Sie Folgendes zu Ihrer shell.nix oder devShell hinzu:
buildInputs = with pkgs; [ webkitgtk_6_0 gtk4 pkg-config gcc ];Führen Sie nach der Installation von Wails wails3 doctor aus – der Befehl zeigt die für Ihre Distribution erforderlichen Pakete genau an.
Wails CLI installieren
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
Dadurch wird der Befehl wails3 unter ~/go/bin installiert (bzw. unter %USERPROFILE%\go\bin unter Windows).
Einrichtungsassistenten ausführen (empfohlen)
wails3 setup
Der Einrichtungsassistent überprüft Ihre Abhängigkeiten, hilft bei der Installation fehlender Abhängigkeiten und konfiguriert die Projektstandards.
Installation überprüfen
wails3 doctor
Erwartete Ausgabe (oder ähnlich):
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!npm installieren (optional, aber empfohlen)
Die meisten Wails-Vorlagen verwenden npm für die Frontend-Werkzeuge.
Laden Sie das Installationsprogramm von nodejs.org herunter und führen Sie es aus.
Überprüfen:
npm --version
Option 1: Offizielles Installationsprogramm Von nodejs.org herunterladen
Option 2: Homebrew
brew install node
Überprüfen:
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: Paketmanager
sudo dnf install nodejs # Fedora
sudo pacman -S nodejs npm # Arch
Überprüfen:
npm --version
Fehlerbehebung
Befehl wails3 nicht gefunden
Ursache: ~/go/bin (oder %USERPROFILE%\go\bin) ist nicht in Ihrem PATH enthalten.
Lösung:
- Öffnen Sie „Umgebungsvariablen“ (über die Suche im Startmenü).
- Suchen Sie unter „Benutzervariablen“ nach
Path. - Klicken Sie auf „Bearbeiten“ → „Neu“.
- Fügen Sie Folgendes hinzu:
C:\Users\YourName\go\bin(ersetzen SieYourName). - Klicken Sie in allen Dialogfeldern auf „OK“.
- Starten Sie Ihr Terminal neu
Überprüfen:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Fügen Sie Folgendes zu ~/.zshrc (macOS) oder ~/.bashrc (Linux) hinzu:
export PATH=$PATH:~/go/bin
Neu laden:
source ~/.zshrc # or ~/.bashrc
Überprüfen:
echo $PATH | grep go/bin
wails3 version
wails3 doctor meldet fehlende Abhängigkeiten
Linux: Die Ausgabe gibt genau an, welche Pakete Sie installieren müssen. Beispiel:
❌ webkit2gtk not found
Install with: sudo apt install libwebkit2gtk-4.1-devWindows: Falls WebView2 fehlt:
- Von Microsoft herunterladen
- Alternativ wird es beim ersten Ausführen Ihrer App automatisch installiert.
macOS: Falls die Xcode-Werkzeuge fehlen:
xcode-select --install
Go-Version zu alt
Wails v3 erfordert Go 1.25+. Falls Sie eine ältere Version verwenden:
Laden Sie die neueste Version von go.dev/dl herunter und installieren Sie sie erneut.
Laden Sie das neueste Tarball von go.dev/dl herunter und führen Sie anschließend Folgendes aus:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Entwicklungsversion (Bleeding Edge)
Möchten Sie den allerneuesten Code aus dem Hauptentwicklungszweig verwenden? Damit erhalten Sie Zugriff auf neue Funktionen und Fehlerbehebungen, bevor sie veröffentlicht werden. Es besteht jedoch das Risiko von Fehlern und inkompatiblen Änderungen. Nur für Mitwirkende oder zum Testen kommender Funktionen empfohlen.
git clone https://github.com/wailsapp/wails.git
cd wails
git checkout v3
cd v3/cmd/wails3
go install
Nächste Schritte
Installation abgeschlossen! Ihr System ist für die Entwicklung mit Wails bereit.
Erstellen Sie in 10 Minuten eine funktionsfähige Anwendung.
Sehen Sie, was direkt verfügbar ist.
wails3 init -l # List templates
Haben Sie Probleme? Fragen Sie auf Discord nach oder eröffnen Sie ein Issue.