Autostart

Autostart

app.Autostart mendaftarkan aplikasi Anda agar diluncurkan secara otomatis saat pengguna login. API ini memilih mekanisme native yang tepat per platform dan menyelesaikan path instalasi yang disymlink (Homebrew, Scoop) sehingga pendaftaran tidak rusak saat binary di-upgrade.

Pendaftaran berlaku pada login berikutnya, bukan segera.

Memulai 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 login dengan opsi default.

func (m *AutostartManager) Enable() error

Memanggil Enable berulang kali aman — pendaftaran ditimpa setiap kali, jadi benar untuk dipanggil pada setiap startup jika Anda telah menyimpan preferensi pengguna.

EnableWithOptions

Mendaftarkan dengan opsi kustom.

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

AutostartOptions:

Disable

Menghapus pendaftaran autostart. Mengembalikan nil jika aplikasi belum terdaftar — disable bersifat idempotent.

func (m *AutostartManager) Disable() error

IsEnabled

Melaporkan apakah pendaftaran ada. Cepat — tidak memvalidasi path 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
}

Identifier

If Options.Identifier is empty, a default is derived from your app’s name:

Identifiers must match ^[A-Za-z0-9._-]+$ and be no longer than 200 characters. Reverse-DNS form is recommended for macOS (it matches how launchd Labels are conventionally written).

When AutostartOptions.Identifier is overridden, the same identifier is reused as the registry value name on Windows and the .desktop filename on Linux, so a single string identifies the registration cross-platform.

Stale Detection

Disable() and Status() locate the registration by matching the registered executable path against os.Executable() (resolved through any symlinks), not by looking up the identifier. This means:

• Changing the identifier between releases is safe. The old registration is still discoverable by Status() and cleaned up by Disable() — as long as the executable path is the same.
• A second copy of the app at a different path won’t clobber the first’s registration. Each binary location is tracked independently.
• Symlinked installs (Homebrew, Scoop) are stable. filepath.EvalSymlinks is applied to os.Executable() before matching, so a Homebrew upgrade that swaps the target doesn’t strand the entry.

What this does not cover: if the user moves or renames the binary to an unrelated path, the old registration becomes orphaned (it points at the now-missing file). Apps that ship from a stable install path don’t need to worry about this; apps shipped as portable single-file binaries should call Disable() before moving themselves, or always launch through a stable symlink.

Example

package main

import (
    "errors"

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

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

    // Pulihkan preferensi pengguna saat 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 / enable / disable ada di examples/autostart/.