Mulai Otomatis

Mulai Otomatis

app.Autostart mendaftarkan aplikasi Anda agar diluncurkan secara otomatis saat pengguna masuk. API ini memilih mekanisme native yang tepat untuk setiap platform dan menyelesaikan jalur instalasi yang menggunakan symlink (Homebrew, Scoop), sehingga pendaftaran tidak rusak ketika biner ditingkatkan versinya.

Pendaftaran mulai berlaku pada proses masuk berikutnya, bukan saat itu juga.

Mulai Cepat

import "github.com/wailsapp/wails/v3/pkg/application"

// Register to launch at login
if err := app.Autostart.Enable(); err != nil {
    app.Logger.Error("autostart enable failed", "error", err)
}

// Stop launching at login
if err := app.Autostart.Disable(); err != nil {
    app.Logger.Error("autostart disable failed", "error", err)
}

// Check status
enabled, err := app.Autostart.IsEnabled()

API

Enable

Mendaftarkan aplikasi agar diluncurkan saat pengguna masuk dengan opsi default.

func (m *AutostartManager) Enable() error

Memanggil Enable berulang kali aman — pendaftaran ditimpa setiap kali, sehingga Anda dapat memanggilnya pada setiap proses awal jika preferensi pengguna telah disimpan secara persisten.

EnableWithOptions

Mendaftarkan aplikasi dengan opsi khusus.

func (m *AutostartManager) EnableWithOptions(opts AutostartOptions) error

AutostartOptions:

Disable

Menghapus pendaftaran mulai otomatis. Mengembalikan nil jika aplikasi belum didaftarkan — operasi penonaktifan bersifat idempoten.

func (m *AutostartManager) Disable() error

IsEnabled

Melaporkan apakah pendaftaran tersedia. Cepat — tidak memvalidasi jalur yang terdaftar.

func (m *AutostartManager) IsEnabled() (bool, error)

Status

Mengembalikan status pendaftaran lengkap.

func (m *AutostartManager) Status() (AutostartStatus, error)

AutostartStatus:

Perilaku Platform

Type=Application
Hidden=false
X-GNOME-Autostart-enabled=true
Exec=<executable> <arguments>

if err := app.Autostart.Enable(); err != nil {
    if errors.Is(err, application.ErrAutostartNotSupported) {
        // hide the toggle in the UI
        return
    }
    // real failure — surface it
}

Pengidentifikasi

Jika Options.Identifier kosong, nilai default diturunkan dari nama aplikasi Anda:

Pengidentifikasi harus cocok dengan ^[A-Za-z0-9._-]+$ dan panjangnya tidak boleh melebihi 200 karakter. Format DNS terbalik direkomendasikan untuk macOS (format ini sesuai dengan cara Label launchd ditulis secara konvensional).

Ketika AutostartOptions.Identifier ditimpa, pengenal yang sama digunakan kembali sebagai nama nilai registri di Windows dan nama file .desktop di Linux, sehingga satu string dapat mengidentifikasi pendaftaran di berbagai platform.

Deteksi Entri Usang

Disable() dan Status() menemukan pendaftaran dengan mencocokkan jalur berkas yang dapat dieksekusi yang terdaftar dengan os.Executable() (setelah semua symlink diurai), bukan dengan mencari pengenal. Artinya:

• Mengubah pengenal di antara rilis tidak menimbulkan masalah. Pendaftaran lama masih dapat ditemukan oleh Status() dan dibersihkan oleh Disable() — selama jalur berkas yang dapat dieksekusi tetap sama.
• Salinan kedua aplikasi di jalur yang berbeda tidak akan menimpa pendaftaran salinan pertama. Setiap lokasi biner dilacak secara independen.
• Instalasi melalui symlink (Homebrew, Scoop) tetap stabil. filepath.EvalSymlinks diterapkan pada os.Executable() sebelum pencocokan, sehingga pemutakhiran Homebrew yang mengganti target tidak meninggalkan entri tanpa rujukan.

Hal yang tidak ditangani oleh mekanisme ini: jika pengguna memindahkan atau mengganti nama biner ke jalur lain yang tidak terkait, pendaftaran lama menjadi yatim (pendaftaran tersebut menunjuk ke berkas yang kini tidak ada). Aplikasi yang didistribusikan dari jalur instalasi tetap tidak perlu mengkhawatirkan hal ini; aplikasi yang didistribusikan sebagai biner portabel satu berkas sebaiknya memanggil Disable() sebelum memindahkan dirinya sendiri, atau selalu diluncurkan melalui symlink yang stabil.

Contoh

package main

import (
    "errors"

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

func main() {
    app := application.New(application.Options{
        Name: "My App",
    })

    // Restore the user's preference on startup
    if userPrefersAutostart() {
        if err := app.Autostart.Enable(); err != nil {
            if !errors.Is(err, application.ErrAutostartNotSupported) {
                app.Logger.Error("autostart", "error", err)
            }
        }
    }

    app.Run()
}

Contoh lengkap yang dapat dijalankan dengan tombol status / aktifkan / nonaktifkan tersedia di examples/autostart/.