Search

Setup Development

Siapkan lingkungan development Anda untuk pengembangan Wails v3

Setup Lingkungan Development

Panduan ini memandu Anda menyiapkan lingkungan development lengkap untuk bekerja pada Wails v3.

Alat yang Diperlukan

Development Go

  1. Instal Go 1.25 atau lebih baru:
bash
# Unduh dari https://go.dev/dl/
go version  # Verifikasi instalasi
  1. Konfigurasi lingkungan Go:
bash
# Tambahkan ke shell profile Anda (.bashrc, .zshrc, dll.)
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin
  1. Instal alat Go yang berguna:
bash
go install golang.org/x/tools/cmd/goimports@latest
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

Node.js dan npm

Diperlukan untuk membangun dokumentasi dan menguji integrasi frontend.

bash
# Instal Node.js 20+ dan npm
node --version  # Harus 20+
npm --version

Dependensi Spesifik Platform

macOS:

bash
# Instal Xcode Command Line Tools
xcode-select --install

# Verifikasi instalasi
xcode-select -p  # Harus menampilkan path

Windows:

  1. Instal MSYS2 untuk lingkungan mirip Unix
  2. WebView2 Runtime (sudah terinstal di Windows 11, unduh untuk Windows 10)
  3. Opsional: Instal Git for Windows

Linux (Debian/Ubuntu):

bash
sudo apt update
# Stack default GTK4 + WebKitGTK 6.0 (Ubuntu 24.04+ / Debian 13+)
sudo apt install build-essential pkg-config libgtk-4-dev libwebkitgtk-6.0-dev
# Untuk jalur legacy -tags gtk3:
sudo apt install libgtk-3-dev libwebkit2gtk-4.1-dev

Linux (Fedora/RHEL):

bash
# Stack GTK4 default
sudo dnf install gcc pkg-config gtk4-devel webkitgtk6.0-devel
# Jalur GTK3 legacy:
sudo dnf install gtk3-devel webkit2gtk4.1-devel

Linux (Arch):

bash
# Stack GTK4 default
sudo pacman -S base-devel gtk4 webkitgtk-6.0
# Jalur GTK3 legacy:
sudo pacman -S gtk3 webkit2gtk-4.1

Setup Repository

Clone dan Konfigurasi

bash
# Clone fork Anda
git clone https://github.com/YOUR_USERNAME/wails.git
cd wails

# Tambahkan remote upstream
git remote add upstream https://github.com/wailsapp/wails.git

# Verifikasi remote
git remote -v

Build CLI Wails

bash
# Navigasi ke direktori v3
cd v3

# Build CLI
go build -o ../wails3 ./cmd/wails3

# Tes build
cd ..
./wails3 version

Tambahkan ke PATH (Opsional)

Linux/macOS:

bash
# Tambahkan ke ~/.bashrc atau ~/.zshrc
export PATH=$PATH:/path/to/wails

Windows:

Tambahkan direktori Wails ke variabel lingkungan PATH melalui System Properties.

Setup IDE

VS Code (Direkomendasikan)

  1. Instal VS Code: Unduh

  2. Instal ekstensi:

  • Go (by Go Team at Google)
  • ESLint
  • Prettier
  • MDX (untuk dokumentasi)
  1. Konfigurasi workspace settings (.vscode/settings.json):
json
{
  "go.useLanguageServer": true,
  "go.lintTool": "golangci-lint",
  "go.lintOnSave": "workspace",
  "editor.formatOnSave": true,
  "go.formatTool": "goimports"
}

GoLand

  1. Instal GoLand: Unduh

  2. Konfigurasi:

  • Aktifkan dukungan Go modules
  • Siapkan file watchers untuk goimports
  • Konfigurasi code style agar sesuai konvensi proyek

Verifikasi Setup Anda

Jalankan perintah berikut untuk memverifikasi semuanya berfungsi:

bash
# Cek versi Go
go version

# Build Wails
cd v3
go build ./cmd/wails3

# Jalankan tes
go test ./pkg/...

# Buat aplikasi tes
cd ..
./wails3 init -n mytest -t vanilla
cd mytest
../wails3 dev

Jika aplikasi tes berhasil di-build dan berjalan, lingkungan Anda siap!

Menjalankan Tes

Unit Test

bash
cd v3
go test ./...

Tes Paket Spesifik

bash
go test ./pkg/application
go test ./pkg/events -v  # Output verbose

Jalankan dengan Coverage

bash
go test ./... -coverprofile=coverage.out
go tool cover -html=coverage.out

Jalankan dengan Race Detector

bash
go test ./... -race

Bekerja dengan Dokumentasi

Dokumentasi Wails dibangun dengan Astro dan Starlight.

bash
cd docs

# Instal dependensi
npm install

# Mulai dev server
npm run dev

# Build untuk production
npm run build

Dokumentasi akan tersedia di http://localhost:4321/

Debugging

Debugging Kode Go

VS Code:

Buat .vscode/launch.json:

json
{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Debug Wails CLI",
      "type": "go",
      "request": "launch",
      "mode": "debug",
      "program": "${workspaceFolder}/v3/cmd/wails3",
      "args": ["dev"]
    }
  ]
}

Command Line:

bash
# Gunakan debugger Delve
go install github.com/go-delve/delve/cmd/dlv@latest
dlv debug ./cmd/wails3 -- dev

Debugging Kode Platform

Debugging spesifik platform memerlukan alat platform:

  • macOS: Xcode Instruments
  • Windows: Visual Studio Debugger
  • Linux: GDB

Masalah Umum

“command not found: wails3”

Tambahkan direktori Wails ke PATH Anda atau gunakan ./wails3 dari root proyek.

“webkitgtk-6.0 not found” atau “webkit2gtk not found” (Linux)

Instal paket development untuk stack yang Anda build:

bash
# Stack GTK4 default (Debian/Ubuntu):
sudo apt install libwebkitgtk-6.0-dev

# Jalur GTK3 legacy:
sudo apt install libwebkit2gtk-4.1-dev

Build gagal dengan error Go module

bash
cd v3
go mod tidy
go mod download

Error “CGO_ENABLED” di Windows

Pastikan Anda memiliki kompiler C (MinGW-w64 via MSYS2) di PATH Anda.

Langkah Selanjutnya

Edit page

Last updated: