Перейти к содержимому

Просмотр логов

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

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

  1. Обнаруживает файл traceback.txt
  2. Добавляет системную информацию Spark (версия iOS, версия Spark, версия движка, настройки игры и конфигурация устройства)
  3. Переименовывает файл с временной меткой (например, traceback_20260311_143022.txt)
  4. Перемещает его в папку logs/ внутри каталога игры

Каждый вылет генерирует отдельный файл лога, поэтому вы можете просмотреть историю ошибок игры.

Просмотр логов доступен с экрана Game Detail. Зелёная кнопка Logs появляется, когда у игры есть один или более доступных логов трассировки.

Если трассировка обнаружена сразу после выхода из игры, Spark уведомит вас о наличии файла лога с возможностью просмотреть его немедленно.

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

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

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

При просмотре лога вы можете поделиться им с командой поддержки:

  • Кнопка «Поделиться» — Открывает системное меню общего доступа iOS для экспорта трассировки через любое приложение (почта, облачное хранилище, мессенджеры и т.д.)
  • Отправить по почте в поддержку — Отправляет лог напрямую на адрес поддержки Spark с прикреплённым файлом трассировки

Вы можете удалить все логи игры из меню браузера логов. Это удаляет всю папку logs/ для этой игры.

Использование логов для устранения неполадок

Заголовок раздела «Использование логов для устранения неполадок»

При сообщении о проблемах команде поддержки:

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

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

СообщениеЗначение
SystemExitИгра закрылась нормально или через Spark
ImportErrorОтсутствует модуль Python — возможно, нужна другая версия движка
IOError / FileNotFoundErrorОтсутствует ресурс или файл игры
MemoryErrorНа устройстве мало памяти — см. Jetsam
pickle errorsНесовместимость файла сохранения — см. Проблемы с сохранениями