Log-Viewer
Der Log-Viewer laesst dich Ren’Py-Traceback-Logs ueberpruefen, die generiert werden, wenn ein Spiel einen Fehler oder Absturz hat.
Wie Logs erfasst werden
Abschnitt betitelt „Wie Logs erfasst werden“Wenn ein Ren’Py-Spiel abstuerzt oder waehrend des Spielens einen Python-Fehler hat, schreibt die Engine eine traceback.txt-Datei in das Spielverzeichnis. Wenn das Spiel beendet wird, macht Spark automatisch Folgendes:
- Erkennt die
traceback.txt-Datei - Fuegt Spark-Systeminformationen hinzu (iOS-Version, Spark-Version, Engine-Version, Spieleinstellungen und Geraetekonfiguration)
- Benennt die Datei mit einem Zeitstempel um (z.B.
traceback_20260311_143022.txt) - Verschiebt sie in einen
logs/-Ordner im Spielverzeichnis
Jeder Absturz erzeugt eine separate Log-Datei, sodass du den Fehlerverlauf eines Spiels ueberpruefen kannst.
Zugriff auf den Log-Viewer
Abschnitt betitelt „Zugriff auf den Log-Viewer“Der Log-Viewer ist ueber den Spieldetail-Bildschirm zugaenglich. Ein gruener Logs-Button erscheint, wenn ein Spiel einen oder mehrere Traceback-Logs verfuegbar hat.
Wenn ein Traceback unmittelbar nach dem Beenden eines Spiels erkannt wird, benachrichtigt dich Spark, dass eine Log-Datei zur Ueberpruefung verfuegbar ist, mit der Option, sie sofort anzusehen.
Was Logs zeigen
Abschnitt betitelt „Was Logs zeigen“Logs enthalten Ren’Py-Tracebacks — Python-Fehlermeldungen und Stack-Traces, die beschreiben, was waehrend der Spielausfuehrung schiefgelaufen ist. Jeder Log enthaelt auch Spark-Systeminformationen am Ende:
- Verwendete Ren’Py-Engine-Version
- iOS-Version und Spark-Version/Build-Nummer
- Vollstaendige App- und Spieleinstellungskonfiguration
- Uebersetzungseinstellungen (falls aktiviert)
- Geraetevarianten-Ueberschreibungen (falls gesetzt)
Log-Browser
Abschnitt betitelt „Log-Browser“Der Log-Browser zeigt alle gespeicherten Traceback-Dateien fuer das ausgewaehlte Spiel an, sortiert nach neuesten zuerst. Jeder Eintrag zeigt den Dateinamen und das Erstellungsdatum. Tippe auf einen Log, um seinen vollstaendigen Inhalt anzuzeigen.
Logs teilen
Abschnitt betitelt „Logs teilen“Beim Anzeigen eines Logs kannst du ihn mit dem Support-Team teilen:
- Teilen-Schaltflaeche — Oeffnet das iOS-Teilen-Menue, um den Traceback ueber jede App zu exportieren (E-Mail, Cloud-Speicher, Nachrichten usw.)
- Per E-Mail an Support — Sendet den Log direkt an die Spark-Support-E-Mail mit der angehaengten Traceback-Datei
Logs loeschen
Abschnitt betitelt „Logs loeschen“Du kannst alle Logs fuer ein Spiel aus dem Log-Browser-Menue loeschen. Dies entfernt den gesamten logs/-Ordner fuer dieses Spiel.
Logs zur Fehlerbehebung verwenden
Abschnitt betitelt „Logs zur Fehlerbehebung verwenden“Wenn du Probleme dem Support-Team meldest:
- Reproduziere das Problem, indem du das Spiel startest
- Oeffne nach dem Absturz den Log-Viewer vom Spieldetail-Bildschirm
- Teile den neuesten Traceback-Log auf Discord oder per E-Mail
Der Traceback und die angehaengten Systeminformationen geben dem Support-Team die Details, die zur Diagnose des Problems benoetigt werden.
Haeufige Traceback-Meldungen
Abschnitt betitelt „Haeufige Traceback-Meldungen“| Meldung | Bedeutung |
|---|---|
SystemExit | Spiel wurde normal oder ueber Spark beendet |
ImportError | Fehlendes Python-Modul — moeglicherweise eine andere Engine-Version noetig |
IOError / FileNotFoundError | Fehlendes Spiel-Asset oder fehlende Datei |
MemoryError | Geraet hat wenig Arbeitsspeicher — siehe Jetsam |
pickle-Fehler | Spielstand-Inkompatibilitaet — siehe Spielstand-Probleme |