Instalasi
Instal Wails dan siapkan untuk membangun aplikasi
Instalasi Cepat (5 Menit)
Instalasi Langkah demi Langkah
Instal Go (Wajib)
Wails memerlukan Go 1.25 atau yang lebih baru.
Unduh penginstal Windows dari go.dev/dl, lalu jalankan.
Verifikasi instalasi:
go version # Should show 1.25 or later
Periksa PATH:
$env:PATH -split ';' | Where-Object { $_ -like '*\go\bin' }
Jika kosong, tambahkan C:\Users\YourName\go\bin ke PATH Anda.
Opsi 1: Penginstal Resmi
Unduh penginstal macOS (file .pkg) dari go.dev/dl, lalu jalankan.
Opsi 2: Homebrew
brew install go
Verifikasi instalasi:
go version # Should show 1.25 or later
echo $PATH | grep go/bin # Should show ~/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: Manajer Paket
# 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 # Reload
Verifikasi:
go version
echo $PATH | grep go/bin
Instal Dependensi Platform
WebView2 Runtime (biasanya sudah terinstal)
Windows 10/11 menyertakan WebView2 secara default. Jika tidak tersedia:
- Unduh dari Microsoft
- Atau jalankan
wails3 doctornanti—perintah tersebut akan memandu Anda
Selesai! Tidak diperlukan dependensi lain.
Xcode Command Line Tools (wajib)
xcode-select --install
Klik “Instal” pada dialog yang muncul.
Verifikasi:
xcode-select -p # Should show /Library/Developer/CommandLineTools
Selesai! macOS 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—perintah tersebut akan menampilkan paket yang tepat untuk distribusi Anda.
Instal CLI Wails
go install github.com/wailsapp/wails/v3/cmd/wails3@latest
Langkah ini menginstal perintah wails3 ke ~/go/bin (atau %USERPROFILE%\go\bin di Windows).
Jalankan Wisaya Penyiapan (Disarankan)
wails3 setup
Wisaya penyiapan akan memeriksa dependensi Anda, membantu menginstal dependensi yang belum tersedia, dan mengonfigurasi default proyek.
Verifikasi Instalasi
wails3 doctor
Keluaran 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 | 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!Instal npm (Opsional tetapi Disarankan)
Sebagian besar templat Wails menggunakan npm untuk alat frontend.
Opsi 1: Penginstal 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: Manajer Paket
sudo dnf install nodejs # Fedora
sudo pacman -S nodejs npm # Arch
Verifikasi:
npm --version
Pemecahan Masalah
Perintah wails3 tidak ditemukan
Penyebab: ~/go/bin (atau %USERPROFILE%\go\bin) tidak tercantum dalam PATH Anda.
Solusi:
- Buka “Variabel Lingkungan” (cari di menu Mulai)
- Di bagian “Variabel pengguna”, cari
Path - Klik “Edit” → “Baru”
- Tambahkan:
C:\Users\YourName\go\bin(gantiYourName) - Klik “OK” pada semua dialog
- Mulai ulang 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 # or ~/.bashrc
Verifikasi:
echo $PATH | grep go/bin
wails3 version
wails3 doctor melaporkan dependensi yang belum tersedia
Linux: Output memberi tahu Anda paket mana saja yang harus diinstal. Contoh:
❌ webkit2gtk not found
Install with: sudo apt install libwebkit2gtk-4.1-devWindows: Jika WebView2 belum tersedia:
- Unduh dari Microsoft
- Atau, WebView2 akan diinstal secara otomatis saat Anda menjalankan aplikasi pertama
macOS: Jika alat Xcode belum tersedia:
xcode-select --install
Versi Go terlalu lama
Wails v3 memerlukan Go 1.25+. Jika Anda menggunakan versi yang lebih lama:
Unduh versi terbaru dari go.dev/dl, lalu 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 (Paling Mutakhir)
Ingin menggunakan kode paling mutakhir dari cabang pengembangan utama? Dengan versi ini, Anda dapat mengakses fitur dan perbaikan baru sebelum dirilis, tetapi ada risiko bug dan perubahan yang merusak kompatibilitas. Hanya disarankan bagi kontributor atau pengguna 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 Berikutnya
Instalasi Selesai! Sistem Anda siap untuk pengembangan dengan Wails.
Buat aplikasi yang berfungsi dalam 10 menit.
Lihat apa saja yang langsung tersedia.
wails3 init -l # List templates
Mengalami masalah? Tanyakan di Discord atau buat issue.