Aplikasi Wails yang Memperbarui Diri Sendiri

Buat kerangka proyek baru dengan templat vanilla:

wails3 init -n updater-tutorial -t vanilla
cd updater-tutorial

Sekarang Anda seharusnya memiliki direktori yang berisi main.go, frontend/, dan sebuah Taskfile.yml. Pastikan proyek dapat dibangun dan diluncurkan:

wails3 task dev

Jendela Wails kosong seharusnya terbuka. Tutup aplikasi, lalu lanjutkan.

Buka main.go, lalu tambahkan dua paket pembaru ke daftar impor:

package main

import (
    _ "embed"

    "github.com/wailsapp/wails/v3/pkg/application"
    "github.com/wailsapp/wails/v3/pkg/updater"
    "github.com/wailsapp/wails/v3/pkg/updater/providers/github"
)

Paket-paket ini menyertakan Updater itu sendiri dan penyedia GitHub Releases.

app.Updater sudah terhubung ke setiap *application.App — Anda hanya perlu memanggil Init:

const currentVersion = "1.0.0"

gh, err := github.New(github.Config{
    Repository:    "yourorg/your-repo",   // ← change this
    ChecksumAsset: "SHA256SUMS",          // sibling file with sha256 digests
})
if err != nil {
    log.Fatalf("github.New: %v", err)
}

if err := app.Updater.Init(updater.Config{
    CurrentVersion: currentVersion,
    Providers:      []updater.Provider{gh},
}); err != nil {
    log.Fatalf("Updater.Init: %v", err)
}

Letakkan ini setelah application.New dan sebelum app.Run().

Dalam main.go yang sama, tambahkan entri menu “Periksa Pembaruan…”:

menu := app.Menu.New()
app.Menu.SetApplicationMenu(menu)
appMenu := menu.AddSubmenu("App")
appMenu.Add("Check for Updates…").OnClick(func(*application.Context) {
    go func() {
        if err := app.Updater.CheckAndInstall(context.Background()); err != nil {
            app.Logger.Error("update", "error", err)
        }
    }()
})

CheckAndInstall membuka jendela pembaruan framework, menjalankan Check, dan jika menemukan rilis, menjalankan DownloadAndInstall secara otomatis. Jika tidak ada yang baru, jendela tetap terbuka dalam status “Sudah Terbaru” — pengguna menutupnya dengan tombol Tutup.

wails3 task dev

Klik App → Periksa Pembaruan…. Jendela pembaruan seharusnya terbuka sebentar, mengakses API GitHub, tidak menemukan rilis yang lebih baru daripada 1.0.0, lalu menetap pada status Sudah Terbaru dengan tanda ✓ berwarna hijau.

Jika Anda mendapatkan galat di sini, biasanya penyebabnya adalah salah satu hal berikut:

Naikkan currentVersion dalam main.go menjadi 1.0.0 (atau biarkan tetap). Bangun untuk satu platform guna memperoleh biner yang dapat Anda lampirkan ke rilis:

wails3 task build:darwin
# produces bin/updater-tutorial.app
# zip it for the release asset:
cd bin && zip -r updater-tutorial-darwin-arm64.zip updater-tutorial.app && cd ..

wails3 task build:linux
# produces bin/updater-tutorial
mv bin/updater-tutorial bin/updater-tutorial-linux-amd64

wails3 task build:windows
# produces bin/updater-tutorial.exe
mv bin/updater-tutorial.exe bin/updater-tutorial-windows-amd64.exe

Buat file SHA256SUMS di samping biner:

cd bin
shasum -a 256 updater-tutorial-* > SHA256SUMS
cat SHA256SUMS

Anda seharusnya melihat satu atau beberapa baris seperti berikut:

abc123…  updater-tutorial-darwin-arm64.zip

Sekarang publikasikan ini sebagai v2.0.0 di repositori GitHub Anda:

gh release create v2.0.0 \
    --title "v2.0.0" \
    --notes "First update for the self-update tutorial.

- **Bold** Markdown renders in the update window
- \`Code spans\` too
- Lists work
- GFM tables work" \
    bin/SHA256SUMS bin/updater-tutorial-*

Dengan currentVersion yang masih bernilai 1.0.0, jalankan kembali aplikasi:

wails3 task dev

Klik App → Periksa Pembaruan…. Kali ini Anda seharusnya melihat sesuatu seperti berikut:

• Ikon utama berubah dari ↓ biru (“Pembaruan Tersedia”) menjadi ✓ hijau (“Pembaruan Siap”).
• Subjudul menampilkan v1.0.0 → v2.0.0 · <size>.
• Panel catatan rilis merender Markdown Anda beserta teks tebal, rentang kode, dan tabel.
• Bilah progres terisi selama pengunduhan (prosesnya akan cepat — ukuran binernya kecil).

Updater menyiapkan biner baru dalam direktori sementara. Untuk menyelesaikan pembaruan:

• Klik Mulai Ulang & Terapkan.
• Aplikasi Anda berhenti, pembantu mengganti biner, lalu biner baru diluncurkan kembali.
• Aplikasi yang diluncurkan kembali melaporkan currentVersion = "1.0.0" (karena kita menetapkan nilainya secara hardcode), tetapi byte pada disk cocok dengan build v2.0.0.

Dalam aplikasi sungguhan, currentVersion akan ditetapkan saat build melalui -ldflags agar biner baru mengetahui bahwa versinya kini v2.0.0 dan pemeriksaan berikutnya tidak menemukan pembaruan.

Ganti konstanta dengan variabel waktu build:

var (
    currentVersion = "dev" // overridden by -ldflags at release time
)

Kemudian, dalam perintah build Anda:

wails3 task build:darwin -- -ldflags "-X main.currentVersion=2.0.0"

Atau tambahkan -ldflags ke Taskfile.yml agar nilainya diambil dari git describe --tags.

Jalur SHA256SUMS memverifikasi integritas (byte cocok dengan yang disimpan GitHub), tetapi tidak memverifikasi keaslian (bahwa byte tersebut dihasilkan oleh pipeline rilis Anda, bukan oleh akun pengelola yang telah disusupi). Agar tahan terhadap manipulasi, tandatangani setiap rilis dengan kunci Ed25519:

# One-time: generate the keypair
ssh-keygen -t ed25519 -f updater-key -N "" -C "wails-updater"
#   updater-key      — keep secret (build server, HSM, password manager)
#   updater-key.pub  — bundle in your app

Untuk setiap rilis, tanda tangani digest SHA-256 setiap aset dengan kunci privat Anda. Berikut pembantu Go sederhana:

package main

import (
    "crypto/ed25519"
    "crypto/sha256"
    "encoding/base64"
    "fmt"
    "io"
    "os"
)

func main() {
    priv, _ := os.ReadFile("updater-key")
    key := ed25519.PrivateKey(priv) // raw 64-byte private key

    f, _ := os.Open(os.Args[1])
    defer f.Close()
    h := sha256.New()
    _, _ = io.Copy(h, f)
    sig := ed25519.Sign(key, h.Sum(nil))
    fmt.Println(base64.StdEncoding.EncodeToString(sig))
}

Penyedia GitHub bawaan saat ini tidak mengambil berkas tanda tangan terpisah — Anda dapat menulis penyedia khusus yang melakukannya, atau beralih ke keygen.sh, yang menandatangani setiap artefak di sisi server dan menyediakan digest serta tanda tangannya melalui API.

Sematkan kunci publik dalam aplikasi Anda:

//go:embed updater-key.pub
var updaterPublicKey []byte

app.Updater.Init(updater.Config{
    CurrentVersion: currentVersion,
    PublicKey:      updaterPublicKey,
    Providers:      []updater.Provider{gh},
})

Jika PublicKey ditetapkan, setiap rilis yang menyertakan Signature harus berhasil diverifikasi dengan kunci ini. Sumber rilis tidak dapat menggantinya dengan kuncinya sendiri — itulah tujuan utama penyematan di luar saluran saat build.

Jendela bawaan mencakup kasus penggunaan umum. Tersedia tiga opsi jika Anda memerlukan kontrol lebih besar — pilih salah satu berdasarkan tingkat penyesuaian yang Anda inginkan:

app.Updater.Init(updater.Config{
    // …
    Window: &updater.BuiltinWindow{
        CSS: `:root { --accent: #ff6f00; --radius: 16px; }`,
    },
})

//go:embed updater-window.html
var updaterHTML string

app.Updater.Init(updater.Config{
    // …
    Window: &updater.BuiltinWindow{HTML: updaterHTML},
})

myWin := app.Window.NewWithOptions(application.WebviewWindowOptions{
    Title:                "My App Updater",
    Width:                520, Height: 460,
    HTML:                 updaterHTML,
    AllowSimpleEventEmit: true,  // required — see security note
})
app.Updater.Init(updater.Config{
    // …
    Window: updater.BYOWindow(myWin.AsUpdaterWindow()),
})

Untuk melakukan pemeriksaan menggunakan pewaktu sebagai pengganti (atau selain) klik menu:

app.Updater.Init(updater.Config{
    CurrentVersion: currentVersion,
    Providers:      []updater.Provider{gh},
    PublicKey:      updaterPublicKey,
    CheckInterval:  6 * time.Hour,
})

Setiap interval menjalankan alur CheckAndInstall yang sama seperti klik manual. Tetapkan Window: updater.WindowNone jika Anda ingin pemeriksaan berkala tetap senyap hingga sesuatu benar-benar ditemukan — lalu berlanggananlah sendiri ke EventUpdateAvailable untuk menentukan UX yang akan ditampilkan.