For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /it/docs/desktop/ship-in-5-minutes.md (or send Accept: text/markdown).

Avvia l’app desktop in 5 minuti

Prepara Rust e gli strumenti di creazione del tuo sistema operativo, avvia un backend Web raggiungibile, avvia la finestra Tauri e verifica il comportamento del vassoio, del collegamento e delle attività locali.

Chiedi informazioni su questa guida

1. Installa gli strumenti generali e nativi

Completo Prima di iniziare, clona il repository Desktop o il monorepo All Platforms e aprilo nell'editor. Desktop è una finestra nativa della stessa app Web. Non include una seconda implementazione di account o chat. Il lancio di cinque minuti inizia dopo l'installazione delle dipendenze e degli strumenti nativi; la prima installazione e la compilazione di Rust spesso richiedono più tempo.

Su Windows installa Microsoft C++ Build Tools utilizzando il collegamento ai prerequisiti Tauri riportato di seguito. Nel suo programma di installazione seleziona Sviluppo desktop con C++, mantieni selezionato Windows SDK e completa l'installazione. Assicurati che Microsoft Edge WebView2 Runtime sia installato. Installa Rust da rusticup.rs usando rusticup-init.exe; mantenere la toolchain MSVC predefinita. Riapri il terminale dopo l'installazione.

Su macOS, esegui xcode-select --install nel Terminale e completa la finestra di dialogo degli strumenti da riga di comando se non sono installati. Installa Rust utilizzando il comando macOS da ruggine.rs. Su Linux, segui la pagina dei prerequisiti Tauri per i pacchetti WebKitGTK, compilatore, vassoio e libreria di sistema della tua distribuzione, quindi installa Rust. I nomi dei pacchetti Linux variano; non eseguire i comandi di un'altra distribuzione.

Apri un terminale nella root del repository ed esegui i controlli della versione di seguito. Sia rustc che cargo devono stampare versioni; cargo è lo strumento di creazione di Rust. Se uno dei due manca, termina l'installazione e riapri il terminale prima di continuare.

rustc --version
cargo --version
corepack pnpm install

2. Avvia o scegli il backend Web

Se il tuo checkout contiene apps/web, segui il tutorial Web, crea apps/web/.env.local, esegui il server Web in un terminale separato utilizzando il comando seguente e lascialo in esecuzione. Per prima cosa controlla http://localhost:3000 nel tuo browser. È possibile utilizzare la dimostrazione /dashboard senza un database; l'accesso reale a /auth deve essere migrato Postgres.

Un pagamento solo per desktop non contiene apps/web.. Utilizza il backend Web eseguito separatamente fornito per il tuo prodotto e apri il relativo URL nel browser per verificare che funzioni. La shell del desktop non può creare il backend per te. Non provare il comando Web riportato di seguito se la cartella è assente. Il passaggio 3 mostra come scegliere un indirizzo backend fornito.

# Only when this checkout contains apps/web:
corepack pnpm --filter @supastack/web dev

3. Avvia la finestra del desktop

Apri un secondo terminale nella root del repository mentre il backend rimane in esecuzione. Per il backend locale predefinito su http://localhost:3000, esegui il primo comando di seguito. Cargo può scaricare librerie e compilare la shell; attendi che si apra la finestra di Supastack. Sono previsti messaggi del compilatore durante la prima compilazione.

Per un backend fornito, sostituisci https://app.example.com nel blocco appropriato del sistema operativo di seguito con il suo effettivo URL. Esegui solo il blocco della tua piattaforma. SUPASTACK_APP_URL è un'impostazione dell'ambiente terminale, letta all'avvio del processo nativo. Mettendolo solo in root .env non configurerà la shell. Mantieni il backend URL libero da nomi utente o password incorporati.

Nel monorepo Tutte le piattaforme, corepack pnpm dev:desktop può avviare Web e Tauri insieme una volta che pnpm è su PATH, come spiegato in Prima di iniziare. Il comando filtrato di seguito funziona anche nei checkout solo desktop, con il backend in esecuzione separatamente.

# Default local backend (all operating systems):
corepack pnpm --filter @supastack/desktop dev

# Custom backend — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'https://app.example.com'
corepack pnpm --filter @supastack/desktop dev

# Custom backend — macOS / Linux only:
SUPASTACK_APP_URL=https://app.example.com corepack pnpm --filter @supastack/desktop dev

4. Controlla la finestra, il vassoio e il collegamento

Il successo significa che la finestra visualizza la stessa home page del tuo backend nel browser. La finestra del desktop non ha la barra degli indirizzi del browser. Per aprire la dimostrazione senza credenziali, esci dalla shell utilizzando l'azione Esci della barra delle applicazioni, quindi esegui il blocco del sistema operativo riportato di seguito nel terminale desktop mentre il server Web rimane in esecuzione. Questo carica direttamente /dashboard; seguire i passaggi dell'attività locale del tutorial Web qui. L'accesso all'account reale utilizza il database del backend, proprio come nel browser.

Chiudi la finestra utilizzando il pulsante di chiusura: l'app dovrebbe nascondersi nel vassoio anziché uscire. Fai clic sull'icona Supastack nella barra delle applicazioni o premi Ctrl + Maiusc + Spazio su Windows/Linux o Comando + Maiusc + Spazio su macOS per visualizzarlo di nuovo. Utilizzare l'azione Esci del vassoio per uscire. Per terminare completamente lo sviluppo, premi anche Ctrl + C nel terminale del desktop e quindi arresta il terminale di backend.

Se la finestra è vuota o mostra un problema di connessione, aprire prima lo URL configurato in un browser. Avvia il backend o correggi URL, quindi riavvia Tauri. Se Rust segnala che linker.exe non è stato trovato, installa il carico di lavoro Windows C++ e riapri il terminale. Se Linux segnala una libreria di sistema mancante, seguire i prerequisiti specifici della distribuzione. Se il tasto di scelta rapida è già utilizzato, utilizzare il vassoio e seguire il comportamento nativo per modificarlo.

Questo avvia una finestra di sviluppo locale; non produce un programma di installazione firmato né pubblica un'app. Segui la distribuzione desktop per build di installazione, firma della piattaforma e test su un altro computer. La compilazione di Windows non verifica il comportamento di macOS o Linux.

# Open the local demo — Windows PowerShell only:
$env:SUPASTACK_APP_URL = 'http://localhost:3000/dashboard'
corepack pnpm --filter @supastack/desktop dev

# Open the local demo — macOS / Linux only:
SUPASTACK_APP_URL=http://localhost:3000/dashboard corepack pnpm --filter @supastack/desktop dev

Usa l’URL locale dell’app

Senza override, Tauri carica http://localhost:3000. Imposta SUPASTACK_APP_URL solo se l’app Next.js locale usa un altro origin HTTP(S) raggiungibile. Gli URL con credenziali o non Web vengono rifiutati.

L’identificatore bundle di sviluppo e la configurazione di release non sono pronti per un prodotto. Consulta la guida di rilascio separata per il controllo preliminare e la firma di piattaforma.