Переглядач логів
Переглядач логів дозволяє переглядати логи трасування Ren’Py, згенеровані при виникненні помилки або вильоту гри.
Як записуються логи
Section titled “Як записуються логи”Коли гра Ren’Py вилітає або стикається з помилкою Python під час гри, рушій записує файл traceback.txt у каталог гри. Коли гра завершується, Spark автоматично:
- Виявляє файл
traceback.txt - Додає системну інформацію Spark (версію iOS, версію Spark, версію рушія, налаштування гри та конфігурацію пристрою)
- Перейменовує файл з міткою часу (наприклад,
traceback_20260311_143022.txt) - Переміщує його до папки
logs/усередині каталогу гри
Кожний виліт генерує окремий файл логу, тому ви можете переглядати історію помилок гри.
Доступ до переглядача логів
Section titled “Доступ до переглядача логів”Переглядач логів доступний з екрана Game Detail. Зелена кнопка Logs з’являється, коли гра має один або більше доступних логів трасування.
Якщо трасування виявлено одразу після виходу з гри, Spark повідомить вас, що доступний файл логу для перегляду, з можливістю переглянути його одразу.
Що показують логи
Section titled “Що показують логи”Логи містять трасування Ren’Py — повідомлення про помилки Python та стеки викликів, що описують, що пішло не так під час виконання гри. Кожен лог також містить системну інформацію Spark, додану в кінці:
- Використана версія рушія Ren’Py
- Версія iOS та версія/номер збірки Spark
- Повна конфігурація налаштувань додатку та гри
- Налаштування перекладу (якщо увімкнено)
- Перевизначення варіанта пристрою (якщо встановлено)
Браузер логів
Section titled “Браузер логів”Браузер логів відображає всі збережені файли трасування для вибраної гри, відсортовані від найновіших. Кожен запис показує назву файлу та дату створення. Натисніть на лог, щоб переглянути повний вміст.
Поширення логів
Section titled “Поширення логів”При перегляді логу ви можете поширити його з командою підтримки:
- Кнопка поширення — Відкриває панель поширення iOS для експорту трасування через будь-який додаток (електронна пошта, хмарне сховище, месенджери тощо)
- Email to Support — Надсилає лог безпосередньо на електронну пошту підтримки Spark з доданим файлом трасування
Видалення логів
Section titled “Видалення логів”Ви можете видалити всі логи гри з меню браузера логів. Це видаляє всю папку logs/ для цієї гри.
Використання логів для усунення неполадок
Section titled “Використання логів для усунення неполадок”При повідомленні про проблеми команді підтримки:
- Відтворіть проблему, запустивши гру
- Після вильоту відкрийте переглядач логів з екрана Game Detail
- Поширте найновіший лог трасування на Discord або через електронну пошту
Трасування та додана системна інформація дають команді підтримки деталі, необхідні для діагностики проблеми.
Поширені повідомлення трасування
Section titled “Поширені повідомлення трасування”| Повідомлення | Значення |
|---|---|
SystemExit | Гра закрита нормально або через Spark |
ImportError | Відсутній модуль Python — може знадобитися інша версія рушія |
IOError / FileNotFoundError | Відсутній ігровий ресурс або файл |
MemoryError | На пристрої закінчується пам’ять — дивіться Jetsam |
Помилки pickle | Несумісність файлу збереження — дивіться Проблеми зі збереженнями |