Setup Development

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:

   # Unduh dari https://go.dev/dl/
   go version  # Verifikasi instalasi

2. Konfigurasi lingkungan Go:

   # Tambahkan ke shell profile Anda (.bashrc, .zshrc, dll.)
   export GOPATH=$HOME/go
   export PATH=$PATH:$GOPATH/bin

3. Instal alat Go yang berguna:

   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.

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

Dependensi Spesifik Platform

macOS:

# 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):

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):

# 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):

# 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

# 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

# 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:

# 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)

3. Konfigurasi workspace settings (.vscode/settings.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:

# 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

cd v3
go test ./...

Tes Paket Spesifik

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

Jalankan dengan Coverage

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

Jalankan dengan Race Detector

go test ./... -race

Bekerja dengan Dokumentasi

Dokumentasi Wails dibangun dengan Astro dan Starlight.

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:

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

Command Line:

# 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:

# 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

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

• Tinjau Standar Coding
• Jelajahi Dokumentasi Teknis
• Temukan issue untuk dikerjakan: Good First Issues