Просмотр логов
Просмотр логов позволяет просматривать логи трассировки Ren’Py, генерируемые при ошибке или вылете игры.
Как захватываются логи
Заголовок раздела «Как захватываются логи»Когда игра Ren’Py вылетает или сталкивается с ошибкой Python во время игры, движок записывает файл traceback.txt в каталог игры. Когда игра завершается, Spark автоматически:
- Обнаруживает файл
traceback.txt - Добавляет системную информацию Spark (версия iOS, версия Spark, версия движка, настройки игры и конфигурация устройства)
- Переименовывает файл с временной меткой (например,
traceback_20260311_143022.txt) - Перемещает его в папку
logs/внутри каталога игры
Каждый вылет генерирует отдельный файл лога, поэтому вы можете просмотреть историю ошибок игры.
Доступ к просмотру логов
Заголовок раздела «Доступ к просмотру логов»Просмотр логов доступен с экрана Game Detail. Зелёная кнопка Logs появляется, когда у игры есть один или более доступных логов трассировки.
Если трассировка обнаружена сразу после выхода из игры, Spark уведомит вас о наличии файла лога с возможностью просмотреть его немедленно.
Что содержат логи
Заголовок раздела «Что содержат логи»Логи содержат трассировки Ren’Py — сообщения об ошибках Python и стек-трейсы, описывающие, что пошло не так во время выполнения игры. Каждый лог также содержит системную информацию Spark, добавленную в конце:
- Используемая версия движка Ren’Py
- Версия iOS и версия/номер сборки Spark
- Полная конфигурация настроек приложения и игры
- Настройки перевода (если включены)
- Переопределения вариантов устройства (если установлены)
Браузер логов
Заголовок раздела «Браузер логов»Браузер логов отображает все сохранённые файлы трассировки для выбранной игры, отсортированные от новых к старым. Каждая запись показывает имя файла и дату создания. Нажмите на лог для просмотра его полного содержимого.
Отправка логов
Заголовок раздела «Отправка логов»При просмотре лога вы можете поделиться им с командой поддержки:
- Кнопка «Поделиться» — Открывает системное меню общего доступа iOS для экспорта трассировки через любое приложение (почта, облачное хранилище, мессенджеры и т.д.)
- Отправить по почте в поддержку — Отправляет лог напрямую на адрес поддержки Spark с прикреплённым файлом трассировки
Удаление логов
Заголовок раздела «Удаление логов»Вы можете удалить все логи игры из меню браузера логов. Это удаляет всю папку logs/ для этой игры.
Использование логов для устранения неполадок
Заголовок раздела «Использование логов для устранения неполадок»При сообщении о проблемах команде поддержки:
- Воспроизведите проблему, запустив игру
- После вылета откройте просмотр логов с экрана Game Detail
- Поделитесь последним логом трассировки в Discord или по электронной почте
Трассировка и добавленная системная информация дают команде поддержки детали, необходимые для диагностики проблемы.
Распространённые сообщения трассировки
Заголовок раздела «Распространённые сообщения трассировки»| Сообщение | Значение |
|---|---|
SystemExit | Игра закрылась нормально или через Spark |
ImportError | Отсутствует модуль Python — возможно, нужна другая версия движка |
IOError / FileNotFoundError | Отсутствует ресурс или файл игры |
MemoryError | На устройстве мало памяти — см. Jetsam |
pickle errors | Несовместимость файла сохранения — см. Проблемы с сохранениями |