Перейти до вмісту

Переглядач логів

Переглядач логів дозволяє переглядати логи трасування Ren’Py, згенеровані при виникненні помилки або вильоту гри.

Коли гра Ren’Py вилітає або стикається з помилкою Python під час гри, рушій записує файл traceback.txt у каталог гри. Коли гра завершується, Spark автоматично:

  1. Виявляє файл traceback.txt
  2. Додає системну інформацію Spark (версію iOS, версію Spark, версію рушія, налаштування гри та конфігурацію пристрою)
  3. Перейменовує файл з міткою часу (наприклад, traceback_20260311_143022.txt)
  4. Переміщує його до папки logs/ усередині каталогу гри

Кожний виліт генерує окремий файл логу, тому ви можете переглядати історію помилок гри.

Доступ до переглядача логів

Section titled “Доступ до переглядача логів”

Переглядач логів доступний з екрана Game Detail. Зелена кнопка Logs з’являється, коли гра має один або більше доступних логів трасування.

Якщо трасування виявлено одразу після виходу з гри, Spark повідомить вас, що доступний файл логу для перегляду, з можливістю переглянути його одразу.

Логи містять трасування Ren’Py — повідомлення про помилки Python та стеки викликів, що описують, що пішло не так під час виконання гри. Кожен лог також містить системну інформацію Spark, додану в кінці:

  • Використана версія рушія Ren’Py
  • Версія iOS та версія/номер збірки Spark
  • Повна конфігурація налаштувань додатку та гри
  • Налаштування перекладу (якщо увімкнено)
  • Перевизначення варіанта пристрою (якщо встановлено)

Браузер логів відображає всі збережені файли трасування для вибраної гри, відсортовані від найновіших. Кожен запис показує назву файлу та дату створення. Натисніть на лог, щоб переглянути повний вміст.

При перегляді логу ви можете поширити його з командою підтримки:

  • Кнопка поширення — Відкриває панель поширення iOS для експорту трасування через будь-який додаток (електронна пошта, хмарне сховище, месенджери тощо)
  • Email to Support — Надсилає лог безпосередньо на електронну пошту підтримки Spark з доданим файлом трасування

Ви можете видалити всі логи гри з меню браузера логів. Це видаляє всю папку logs/ для цієї гри.

Використання логів для усунення неполадок

Section titled “Використання логів для усунення неполадок”

При повідомленні про проблеми команді підтримки:

  1. Відтворіть проблему, запустивши гру
  2. Після вильоту відкрийте переглядач логів з екрана Game Detail
  3. Поширте найновіший лог трасування на Discord або через електронну пошту

Трасування та додана системна інформація дають команді підтримки деталі, необхідні для діагностики проблеми.

Поширені повідомлення трасування

Section titled “Поширені повідомлення трасування”
ПовідомленняЗначення
SystemExitГра закрита нормально або через Spark
ImportErrorВідсутній модуль Python — може знадобитися інша версія рушія
IOError / FileNotFoundErrorВідсутній ігровий ресурс або файл
MemoryErrorНа пристрої закінчується пам’ять — дивіться Jetsam
Помилки pickleНесумісність файлу збереження — дивіться Проблеми зі збереженнями