> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# Risoluzione dei problemi dell’app desktop

Risolvi toolchain mancanti, finestre vuote e errori di firma della release prima che blocchino una build.

## Installazione e configurazione

Su Windows installa i C++ Build Tools con il Windows SDK e il runtime WebView2. Su macOS installa gli strumenti da riga di comando di Xcode. Su Linux installa i pacchetti WebKitGTK, compilatore, tray e di sistema indicati per la tua distribuzione. Installa Rust con rustup, riapri il terminale ed esegui `cargo check` prima di avviare Tauri.

Una finestra vuota di solito significa che `SUPASTACK_APP_URL` non è raggiungibile o punta a un dev server fermo; il banner offline appare quando la pagina caricata perde la rete. Conferma che l’URL si apra in un browser sulla stessa macchina e che tu abbia compilato con il valore previsto.


## Flusso di implementazione

Gli errori di release derivano di solito da firma, notarizzazione o blocco dell’updater. Controlla certificato e portachiavi su macOS, certificato di firma e server di timestamp su Windows, chiave pubblica dell’updater e percorso dell’endpoint, e l’identificatore del prodotto. Riesegui il controllo della configurazione di release, poi installa l’artefatto su una macchina pulita invece che sopra la build di sviluppo.


## Verifica e risoluzione dei problemi

L’app si avvia, raggiunge il backend e si installa correttamente.


Per continuare la configurazione, leggi [Checklist di deployment](https://supastack.dev/it/docs/web/deployment.md).


## Successivo

[Checklist di deployment](https://supastack.dev/it/docs/web/deployment.md)