Zum Inhalt springen

Log-Viewer

Der Log-Viewer laesst dich Ren’Py-Traceback-Logs ueberpruefen, die generiert werden, wenn ein Spiel einen Fehler oder Absturz hat.

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:

  1. Erkennt die traceback.txt-Datei
  2. Fuegt Spark-Systeminformationen hinzu (iOS-Version, Spark-Version, Engine-Version, Spieleinstellungen und Geraetekonfiguration)
  3. Benennt die Datei mit einem Zeitstempel um (z.B. traceback_20260311_143022.txt)
  4. Verschiebt sie in einen logs/-Ordner im Spielverzeichnis

Jeder Absturz erzeugt eine separate Log-Datei, sodass du den Fehlerverlauf eines Spiels ueberpruefen kannst.

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.

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)

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.

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

Du kannst alle Logs fuer ein Spiel aus dem Log-Browser-Menue loeschen. Dies entfernt den gesamten logs/-Ordner fuer dieses Spiel.

Wenn du Probleme dem Support-Team meldest:

  1. Reproduziere das Problem, indem du das Spiel startest
  2. Oeffne nach dem Absturz den Log-Viewer vom Spieldetail-Bildschirm
  3. 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.

MeldungBedeutung
SystemExitSpiel wurde normal oder ueber Spark beendet
ImportErrorFehlendes Python-Modul — moeglicherweise eine andere Engine-Version noetig
IOError / FileNotFoundErrorFehlendes Spiel-Asset oder fehlende Datei
MemoryErrorGeraet hat wenig Arbeitsspeicher — siehe Jetsam
pickle-FehlerSpielstand-Inkompatibilitaet — siehe Spielstand-Probleme