Démarrage au login

Le module autolaunch vous permet d'activer, de désactiver et d'interroger le démarrage au login depuis Kotlin, sans écrire de code spécifique à chaque OS. Il choisit le backend selon le format de packaging courant au runtime — startup tasks MSIX, registre Win32, SMAppService macOS, service utilisateur systemd Linux et portail Flatpak — et respecte les états que l'utilisateur a réglés en dehors de votre app.

Ajouter la dépendance

dependencies {
    implementation("dev.nucleusframework:nucleus.autolaunch:2.0.7")
}

Sur macOS, le bridge JNI de nucleus.service-management-macos est tiré transitivement : vous n'avez rien à déclarer en plus.

Vérifier et basculer le démarrage au login

Lisez l'état courant avec AutoLaunch.state() et branchez-vous dessus. Appelez enable() ou disable() pour le changer, et openSystemSettings() quand l'utilisateur doit agir dans l'interface système :

import dev.nucleusframework.autolaunch.AutoLaunch
import dev.nucleusframework.autolaunch.AutoLaunchState

when (AutoLaunch.state()) {
    AutoLaunchState.ENABLED          -> {}
    AutoLaunchState.DISABLED         -> AutoLaunch.enable()
    AutoLaunchState.DISABLED_BY_USER -> AutoLaunch.openSystemSettings()
    AutoLaunchState.UNSUPPORTED      -> { /* macOS < 13, environnement Linux non supporté */ }
    else -> {}
}

Pour câbler un interrupteur en Compose, pilotez-le depuis state() :

Switch(
    checked = AutoLaunch.state() == AutoLaunchState.ENABLED,
    enabled = AutoLaunch.state() != AutoLaunchState.DISABLED_BY_USER,
    onCheckedChange = { on ->
        if (on) AutoLaunch.enable() else AutoLaunch.disable()
    },
)

Détecter un lancement au login

wasStartedAtLogin(args) indique si le process courant a été lancé par le mécanisme de login plutôt que démarré à la main. Testez-le au point d'entrée de votre main() pour sauter un splash screen ou démarrer en fenêtre réduite :

fun main(args: Array<String>) {
    if (AutoLaunch.wasStartedAtLogin(args)) {
        startMinimized = true
    }
    // ...
}

Fonctionnement

Le runtime choisit un backend à partir du système d'exploitation et du type d'exécutable détecté — aucun code conditionnel par OS de votre côté :

Trois invariants imposés par le module, que vous ne devez pas contourner :

1. Les choix de l'utilisateur sont définitifs. Dès qu'il désactive le démarrage au login via l'interface système, l'état passe à DISABLED_BY_USER et enable() renvoie BLOCKED_BY_USER jusqu'à ce qu'il réactive lui-même.
2. Les mises à jour silencieuses ne réinitialisent pas l'état. Le backend Win32 n'écrit dans Run qu'à un enable() et ne touche à StartupApproved qu'à un disable().
3. MSIX exige l'extension du manifeste. Sans <uap5:StartupTask> dans Package.appxmanifest, l'API renvoie UNSUPPORTED. Mettez addAutoLaunchExtension = true dans le bloc plugin et il s'en occupe.

Référence de l'API

AutoLaunch

AutoLaunch est un object ; toutes les méthodes sont statiques.

AutoLaunchState

ENABLED, DISABLED, DISABLED_BY_USER, DISABLED_BY_POLICY, ENABLED_BY_POLICY, UNSUPPORTED.

DISABLED_BY_POLICY et ENABLED_BY_POLICY sont des états en lecture seule imposés par la Group Policy (MSIX uniquement).

AutoLaunchResult

OK, UNCHANGED, BLOCKED_BY_USER, BLOCKED_BY_POLICY, UNSUPPORTED, ERROR.

AutoLaunchConfig

Surcharge les valeurs par défaut avant le premier appel à AutoLaunch :

Notes

• Sur MSIX, changer le démarrage au login via l'API ne rafraîchit pas en direct l'onglet « Apps au démarrage » du Task Manager : Windows met cette vue à jour au prochain login. L'état stocké est correct ; seul l'affichage est en retard.
• La détection du login sur macOS lit le marqueur keyAELaunchedAsLogInItem dans l'AppleEvent que loginwindow envoie au login. Apple ne fournit aucune API publique pour ça.
• wasStartedAtLogin() renvoie false en dev (ExecutableRuntime.isDev()) pour éviter les faux positifs liés aux variables d'environnement héritées du shell parent. Les builds de production doivent définir la propriété système nucleus.executable.type ou fournir le fichier marqueur .nucleus-executable-type, sinon ExecutableRuntime retombe sur DEV et la méthode renvoie toujours false.

Et ensuite

• Type d'exécutable — comment le runtime détecte le format de packaging qui pilote le choix du backend.
• Gestion des services — enregistrer login items, agents et daemons sur macOS.
• Instance unique — router un lancement au login vers un process déjà en cours.
• Scheduler — exécuter du travail en arrière-plan après un lancement au login.