Lewati ke konten
Wails Blog

Memulai

Selamat Datang, Kontributor!

Section titled “Selamat Datang, Kontributor!”

Terima kasih atas minat Anda untuk berkontribusi ke Wails! Panduan ini akan membantu Anda membuat kontribusi pertama.

Prasyarat

Section titled “Prasyarat”

Sebelum memulai, pastikan Anda memiliki:

  • Go 1.25+ terinstal (unduh)
  • Node.js 20+ dan npm (unduh)
  • Git dikonfigurasi dengan akun GitHub Anda
  • Familiaritas dasar dengan Go dan JavaScript/TypeScript

Persyaratan Spesifik Platform

Section titled “Persyaratan Spesifik Platform”

macOS:

  • Xcode Command Line Tools: xcode-select --install

Windows:

  • MSYS2 atau lingkungan mirip Unix direkomendasikan
  • Runtime WebView2 (biasanya sudah terinstal di Windows 11)

Linux:

  • gcc, pkg-config, libgtk-4-dev, libwebkitgtk-6.0-dev (stack GTK4 default)
  • Instal via: sudo apt install build-essential pkg-config libgtk-4-dev libwebkitgtk-6.0-dev (Debian/Ubuntu)
  • Untuk jalur build legacy -tags gtk3, juga instal libgtk-3-dev dan libwebkit2gtk-4.1-dev

Ikhtisar Proses Kontribusi

Section titled “Ikhtisar Proses Kontribusi”

Alur kerja kontribusi tipikal mengikuti langkah-langkah berikut:

  1. Fork & Clone - Buat salinan repository Wails Anda sendiri
  2. Setup - Build CLI Wails dan verifikasi lingkungan Anda
  3. Branch - Buat feature branch untuk perubahan Anda
  4. Develop - Lakukan perubahan mengikuti standar coding kami
  5. Test - Jalankan tes untuk memastikan semuanya berfungsi
  6. Commit - Commit dengan pesan conventional commit yang jelas
  7. Submit - Buka pull request untuk review
  8. Iterate - Tanggapi feedback dan lakukan penyesuaian
  9. Merge - Setelah disetujui, perubahan Anda menjadi bagian dari Wails!

Panduan Langkah demi Langkah

Section titled “Panduan Langkah demi Langkah”

Pilih jenis kontribusi Anda:

  1. Temukan atau Laporkan Bug

    • Periksa apakah bug sudah dilaporkan di GitHub Issues
    • Jika belum, buat issue baru dengan langkah reproduksi
    • Tunggu konfirmasi sebelum mulai mengerjakan

  2. Fork dan Clone

    Fork repository di github.com/wailsapp/wails/fork

    Clone fork Anda:

    Terminal window
    git clone https://github.com/YOUR_USERNAME/wails.git
    cd wails
    git remote add upstream https://github.com/wailsapp/wails.git

  3. Build dan Verifikasi

    Build Wails dan verifikasi Anda dapat mereproduksi bug:

    Terminal window
    cd v3
    go build -o ../wails3 ./cmd/wails3
    

    # Reproduksi bug untuk memahaminya

  4. Buat Branch Perbaikan Bug

    Buat branch untuk perbaikan Anda:

    Terminal window
    git checkout -b fix/issue-123-window-crash

  5. Perbaiki Bug

    • Lakukan perubahan minimal yang diperlukan untuk memperbaiki bug
    • Jangan refactor kode yang tidak terkait
    • Tambah atau perbarui tes untuk mencegah regresi
    Terminal window
    # Lakukan perubahan Anda
    # Tambahkan tes di file *_test.go

  6. Tes Perbaikan Anda

    Jalankan tes untuk memastikan perbaikan berfungsi:

    Terminal window
    go test ./...
    

    # Tes paket spesifik
    go test ./pkg/application -v
    

    # Jalankan dengan race detector
    go test ./... -race

  7. Commit Perbaikan Anda

    Commit dengan pesan yang jelas:

    Terminal window
    git commit -m "fix: prevent window crash when closing during initialization
    

    Fixes #123"

  8. Submit Pull Request

    Push dan buat PR:

    Terminal window
    git push origin fix/issue-123-window-crash

    Di deskripsi PR Anda:

    • Jelaskan bug dan akar masalah
    • Deskripsikan perbaikan Anda
    • Referensikan issue: “Fixes #123”
    • Sertakan perilaku sebelum/sesudah

  9. Tanggapi Feedback

    Tangani komentar review dan perbarui PR Anda sesuai kebutuhan.

Mencari Issue untuk Dikerjakan

Section titled “Mencari Issue untuk Dikerjakan”

Mendapatkan Bantuan

Section titled “Mendapatkan Bantuan”

Kode Etik

Section titled “Kode Etik”

Bersikaplah hormat, konstruktif, dan ramah. Kami membangun komunitas yang ramah yang fokus menciptakan perangkat lunak hebat bersama-sama.

Langkah Selanjutnya

Section titled “Langkah Selanjutnya”