Instalasi
Instalasi Cepat (5 Menit)
Instalasi Langkah demi Langkah
Instal Go (Wajib)
Wails memerlukan Go 1.25 atau lebih baru.
Unduh installer Windows dari go.dev/dl dan jalankan.
Verifikasi instalasi:
go version # Harus menampilkan 1.25 atau lebih baru
Periksa PATH:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Jika kosong, tambahkan C:\Users\YourName\go\bin ke PATH Anda.
Opsi 1: Installer Resmi
Unduh installer macOS (file .pkg) dari go.dev/dl dan jalankan.
Opsi 2: Homebrew
brew install go
Verifikasi instalasi:
go version # Harus menampilkan 1.25 atau lebih baru
echo $PATH | grep go/bin # Harus menampilkan ~/go/bin
Jika ~/go/bin tidak ada di PATH, tambahkan ke ~/.zshrc atau ~/.bash_profile:
export PATH=$PATH:~/go/bin
Opsi 1: Tarball Resmi
Unduh tarball Linux dari go.dev/dl, lalu:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Opsi 2: Package Manager
# Ubuntu/Debian
sudo apt install golang-go
# Fedora
sudo dnf install golang
# Arch
sudo pacman -S go
Tambahkan ke PATH (tambahkan ke ~/.bashrc atau ~/.zshrc):
export PATH=$PATH:/usr/local/go/bin:~/go/bin
source ~/.bashrc # Muat ulang
Verifikasi:
go version
echo $PATH | grep go/bin
Instal Dependensi Platform
WebView2 Runtime (biasanya sudah terinstal)
Windows 10/11 sudah menyertakan WebView2 secara default. Jika tidak ada:
- Unduh dari [Microsoft](https://developer.microsoft.com/microsoft-edge/webview2/)
- Atau jalankan `wails3 doctor` nanti — akan memandu Anda
**Itu saja!** Tidak ada dependensi lain yang diperlukan.
Xcode Command Line Tools (wajib)
xcode-select --install
Klik “Install” pada dialog yang muncul.
Verifikasi:
xcode-select -p # Harus menampilkan /Library/Developer/CommandLineTools
Itu saja! macOS sudah menyertakan WebKit secara default.
Alat build dan WebKit
Memerlukan Ubuntu 24.04+ atau Debian 13+ untuk stack GTK4 default.
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
Tambahkan ke shell.nix atau devShell Anda:
buildInputs = with pkgs; [ webkitgtk_6_0 gtk4 pkg-config gcc ];Jalankan wails3 doctor setelah menginstal Wails — akan menampilkan paket yang tepat untuk distribusi Anda.
Instal Wails CLI
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
Perintah ini menginstal perintah wails3 ke ~/go/bin (atau %USERPROFILE%\go\bin di Windows).
Jalankan Wizard Setup (Disarankan)
wails3 setup
Wizard setup akan memeriksa dependensi Anda, membantu menginstal yang hilang, dan mengonfigurasi default proyek.
Verifikasi Instalasi
wails3 doctor
Output yang diharapkan (atau serupa):
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 | Versi yang Anda instal |
| 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!Instal npm (Opsional tetapi Disarankan)
Sebagian besar template Wails menggunakan npm untuk tooling frontend.
Opsi 1: Installer Resmi Unduh dari nodejs.org
Opsi 2: Homebrew
brew install node
Verifikasi:
npm --version
Opsi 1: NodeSource
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs # Ubuntu/Debian
Opsi 2: Package Manager
sudo dnf install nodejs # Fedora
sudo pacman -S nodejs npm # Arch
Verifikasi:
npm --version
Troubleshooting
Perintah wails3 tidak ditemukan
Penyebab: ~/go/bin (atau %USERPROFILE%\go\bin) tidak ada di PATH Anda.
Solusi:
- Buka “Environment Variables” (cari di menu Start)
- Di bawah “User variables”, temukan
Path - Klik “Edit” → “New”
- Tambahkan:
C:\Users\YourName\go\bin(gantiYourName) - Klik “OK” pada semua dialog
- Restart terminal Anda
Verifikasi:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Tambahkan ke ~/.zshrc (macOS) atau ~/.bashrc (Linux):
export PATH=$PATH:~/go/bin
Muat ulang:
source ~/.zshrc # atau ~/.bashrc
Verifikasi:
echo $PATH | grep go/bin
wails3 version
wails3 doctor melaporkan dependensi yang hilang
Linux: Output memberi tahu paket mana yang perlu diinstal. Contoh:
❌ webkit2gtk not found
Install with: sudo apt install libwebkit2gtk-4.1-devWindows: Jika WebView2 tidak ada:
- Unduh dari Microsoft
- Atau akan terinstal otomatis saat Anda menjalankan aplikasi pertama
macOS: Jika Xcode tools tidak ada:
xcode-select --install
Versi Go terlalu lama
Wails v3 memerlukan Go 1.25+. Jika Anda memiliki versi lama:
Unduh versi terbaru dari go.dev/dl dan instal ulang.
Unduh tarball terbaru dari go.dev/dl, lalu:
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.25.linux-amd64.tar.gz
Versi Pengembangan (Bleeding Edge)
Ingin menggunakan kode terbaru dari branch pengembangan utama? Ini memberi Anda akses ke fitur dan perbaikan baru sebelum dirilis, tetapi disertai risiko bug dan breaking change. Hanya disarankan untuk kontributor atau mereka yang perlu menguji fitur mendatang.
git clone https://github.com/wailsapp/wails.git
cd wails
git checkout v3
cd v3/cmd/wails3
go install
Langkah Selanjutnya
Instalasi Selesai! Sistem Anda siap untuk pengembangan Wails.
Buat aplikasi yang berfungsi dalam 10 menit.
Lihat apa yang tersedia out of the box.
wails3 init -l # Daftar template
Mengalami masalah? Tanyakan di Discord atau buka issue.