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/troubleshooting.md (or send Accept: text/markdown).
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.