zero-native

Costruisci app desktop native con interfaccia web. Binarie piccole. Memoria minima. Ricostruzioni istantanee.

zero-native è una shell per app desktop Zig per frontend web moderni. Usa il WebView di sistema quando desideri l'app più piccola possibile, oppure bundla Chromium tramite CEF quando la coerenza di rendering è importante.

Inizio veloce

Installa il CLI:

npm install -g zero-native

Crea ed esegui un'app:

zero-native init my_app --frontend next
cd my_app
zig build run

La prima esecuzione installa le dipendenze del frontend, costruisce la shell nativa generata e apre una finestra desktop che rende la tua interfaccia web.

Leggi la guida completa su zero-native.dev/quick-start.

Perché zero-native

Piccolo e veloce

Le app WebView di sistema non bundlano un runtime del browser, quindi la shell nativa rimane piccola e si avvia rapidamente. La tua app utilizza WKWebView su macOS e WebKitGTK su Linux.

Scegli il tuo motore web

Scegli il motore che si adatta al prodotto. Il WebView di sistema offre un'impronta nativa leggera. Chromium tramite CEF offre un rendering prevedibile e una piattaforma web fissata sui target supportati.

Ricostruzioni native veloci

Lo strato nativo è Zig, quindi la logica dell'app, i comandi del bridge e le integrazioni di piattaforma si ricompilano rapidamente. Il tuo frontend può comunque utilizzare gli strumenti web che già conosci.

Potere nativo senza pesanti collegamenti

Zig chiama C direttamente, il che mantiene SDK di piattaforma, librerie native, codec e integrazioni di sistema locale a portata di mano quando lo strato WebView deve svolgere un lavoro nativo reale.

Modello di sicurezza esplicito

Il WebView è trattato come non affidabile per impostazione predefinita. I comandi nativi, le autorizzazioni, la navigazione, i link esterni e le API della finestra sono opt-in e controllati dalla policy.

Stato

zero-native è in pre-release. Il supporto desktop copre ora macOS 11+, Linux e percorsi di build per Windows, con Chromium/CEF distribuito come runtime specifici per piattaforma.

Concetti chiave

App è il piccolo oggetto Zig che descrive la tua applicazione: nome, sorgente WebView, hook del ciclo di vita e servizi nativi opzionali.

Runtime possiede il ciclo di eventi, le finestre, il dispatch del bridge, gli hook di automazione, il tracciamento e i servizi di piattaforma.

WebViewSource dice al runtime cosa caricare: HTML inline, un URL o asset frontend impacchettati serviti da un'origine app locale.

app.zon è il manifesto dell'app. Dichiara i metadati dell'app, le icone, le finestre, gli asset frontend, la selezione del motore web, la policy di sicurezza, le autorizzazioni del bridge e gli input di packaging.

window.zero.invoke() è il bridge JavaScript-to-Zig. Le chiamate sono limitate in dimensione, controllate per origine, controllate per autorizzazione e instradate solo ai gestori registrati.

Configurazione

La maggior parte del comportamento a livello di progetto vive in app.zon:

.{
    .id = "com.example.my-app",
    .name = "my-app",
    .display_name = "My App",
    .version = "0.1.0",
    .web_engine = "system",
    .permissions = .{ "window" },
    .capabilities = .{ "webview", "js_bridge" },
    .security = .{
        .navigation = .{
            .allowed_origins = .{ "zero://app", "http://127.0.0.1:5173" },
        },
    },
    .windows = .{
        .{ .label = "main", .title = "My App", .width = 960, .height = 640 },
    },
}

Usa .web_engine = "system" per il WebView di piattaforma. Su build macOS supportate, usa .web_engine = "chromium" con una configurazione .cef quando desideri bundlare Chromium.

Documentazione

La documentazione completa è su zero-native.dev.

• Inizio veloce
• Motori web
• Modello di app
• Bridge
• Sicurezza
• Packaging

Esempi

Esempi di avvio specifici per framework vivono in examples/:

• examples/next
• examples/react
• examples/svelte
• examples/vue

Ogni esempio è un'app zero-native completa con app.zon, una shell Zig e un progetto frontend minimo. Esegui uno con zig build run dalla sua directory.

Esempi di embedding mobile sono disponibili anche:

• examples/ios
• examples/android

Questi mostrano come un'app host iOS o Android collega l'ABI C di zero-native da libzero-native.a.

Per lo sviluppo locale di framework, vedi CONTRIBUTING.md...