Le backend Tao

Tao est la couche de fenêtrage Rust qui propulse Tauri 2. Nucleus 2.0 l'expose comme backend de premier ordre : Compose Desktop tourne dans une fenêtre native — sans AWT, sans Event-Dispatch Thread Swing, sans repli XWayland. C'est le backend par défaut des nouvelles apps Nucleus, et la seule voie vers les primitives modernes que le JetBrains Runtime ne sait pas atteindre.

TL;DR

• Aucun AWT à l'exécution — Compose dessine dans une fenêtre native via Tao + Skiko.
• Wayland natif, multi-touch, stylet et HiDPI par moniteur sur tous les OS.
• ~60 Mo résidents sur un build GraalVM native-image.
• Le même DecoratedWindow que les backends AWT — on choisit le backend dans Gradle, pas dans le UI.
• Échappatoire via nucleusWindow.unsafe.taoWindow quand on veut le handle brut.

Install

dependencies {
    implementation("dev.nucleusframework:nucleus.nucleus-application:<version>")
    implementation("dev.nucleusframework:nucleus.decorated-window-tao:<version>")
}

Le plugin Gradle détecte decorated-window-tao au runtime et sélectionne Tao. Pour le forcer :

nucleusApplication(backend = NucleusBackend.Tao) {
    // …
}

Quickstart

import dev.nucleusframework.application.*
import dev.nucleusframework.window.core.*
import androidx.compose.ui.unit.*
import androidx.compose.ui.window.rememberWindowState

fun main() = nucleusApplication(backend = NucleusBackend.Tao) {
    DecoratedWindow(
        onCloseRequest = ::exitApplication,
        state = rememberWindowState(size = DpSize(1024.dp, 720.dp)),
        title = "Hello Tao",
    ) {
        TitleBar { state -> /* barre de titre personnalisée */ }
        MyContent()
    }
}

Comment ça marche

Tao ouvre une fenêtre native directement — NSWindow sur macOS, un HWND sur Windows, une wl_surface (ou fenêtre X11) sur Linux. Compose rend dans cette surface via Skiko : Metal sur macOS, WGL sur Windows, EGL sur Linux. Rien ne passe par l'Event-Dispatch Thread de Swing.

Comme la boucle d'événements OS tourne sur le thread principal, le lanceur macOS a besoin de -XstartOnFirstThread. Le plugin Gradle Nucleus l'injecte automatiquement pour run, les distributions packagées et Compose Hot Reload. Les builds GraalVM native-image démarrent sur le main thread par défaut.

L'entrée unifiée nucleusApplication { } cache le choix du backend à le code UI. Tao expose les mêmes DecoratedWindow, DecoratedDialog et TitleBar que les backends AWT — mais en dessous on dispose d'un TaoWindow accessible via nucleusWindow.unsafe.taoWindow pour appeler directement le crate natif.

Matrice de couverture

Reference

L'API Tao vit dans dev.nucleusframework.window.tao.* :

• taoApplication { } — entrée directe (préfère nucleusApplication pour la portabilité).
• TaoWindow — handle impératif. Accessible via LocalTaoWindow ou nucleusWindow.unsafe.taoWindow.
• NativeView — embarque SwiftUI, WebView2 ou des widgets GTK dans Compose.
• MacOSStyle.Liquid — active le Liquid Glass de macOS 26.
• TaoCursorIcon, TaoTrackpadGesture, TaoTrackpadPhase, TaoMouseButton, TaoEventCode — constantes d'input.
• TaoDeepLinkBridge.setSink { uri -> … } — réception des deep links.