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 /de/docs/desktop/troubleshooting.md (or send Accept: text/markdown).
Fehlerbehebung für die Desktop-App
Behebe fehlende Toolchains, leere Fenster und Release-Signaturfehler, bevor sie einen Build blockieren.
Einrichtung und Konfiguration
Installiere unter Windows die C++-Build-Tools mit dem Windows SDK und die WebView2-Runtime. Installiere unter macOS die Xcode-Kommandozeilentools. Installiere unter Linux die WebKitGTK-, Compiler-, Tray- und Systempakete deiner Distribution. Installiere Rust mit rustup, öffne das Terminal neu und führe cargo check vor dem Start von Tauri aus.
Ein leeres Fenster bedeutet meist, dass SUPASTACK_APP_URL nicht erreichbar ist oder auf einen gestoppten Dev-Server zeigt; das Offline-Banner erscheint, wenn die geladene Seite das Netzwerk verliert. Bestätige, dass die URL in einem Browser auf derselben Maschine öffnet und dass du mit dem beabsichtigten Wert gebaut hast.
Implementierungsablauf
Release-Fehler kommen meist von Signierung, Notarisierung oder dem Updater-Block. Prüfe das Zertifikat und den Schlüsselbund unter macOS, das Signaturzertifikat und den Zeitstempelserver unter Windows, den öffentlichen Updater-Schlüssel und den Endpunktpfad sowie die Produktkennung. Führe die Release-Config-Prüfung erneut aus und installiere das Artefakt dann auf einem sauberen Rechner statt über den Entwicklungs-Build.
Überprüfung und Fehlerbehebung
Die App startet, erreicht das Backend und lässt sich sauber installieren.