Trình Xem Log

Trình Xem Log cho phép bạn xem lại các log traceback Ren’Py được tạo khi trò chơi gặp lỗi hoặc sự cố.

Khi trò chơi Ren’Py bị sập hoặc gặp lỗi Python trong quá trình chơi, engine ghi file traceback.txt vào thư mục trò chơi. Khi trò chơi tắt, Spark tự động:

1. Phát hiện file traceback.txt
2. Thêm thông tin hệ thống Spark (phiên bản iOS, phiên bản Spark, phiên bản engine, cài đặt trò chơi, và cấu hình thiết bị)
3. Đổi tên file với dấu thời gian (ví dụ: traceback_20260311_143022.txt)
4. Di chuyển vào thư mục logs/ bên trong thư mục trò chơi

Mỗi sự cố tạo ra một file log riêng, để bạn có thể xem lại lịch sử lỗi cho trò chơi.

Trình Xem Log có thể truy cập từ màn hình Game Detail. Nút Logs màu xanh lá xuất hiện khi trò chơi có một hoặc nhiều log traceback.

Nếu traceback được phát hiện ngay sau khi trò chơi thoát, Spark sẽ thông báo rằng có file log để xem với tùy chọn xem ngay.

Log chứa traceback Ren’Py — thông báo lỗi Python và stack trace mô tả điều gì đã sai trong quá trình thực thi trò chơi. Mỗi log cũng bao gồm thông tin hệ thống Spark được thêm ở cuối:

• Phiên bản engine Ren’Py được sử dụng
• Phiên bản iOS và phiên bản/số build Spark
• Cấu hình cài đặt ứng dụng và trò chơi đầy đủ
• Cài đặt dịch (nếu được bật)
• Ghi đè biến thể thiết bị (nếu được đặt)

Trình duyệt log hiển thị tất cả file traceback đã lưu cho trò chơi được chọn, sắp xếp từ mới nhất. Mỗi mục hiển thị tên file và ngày tạo. Nhấn vào log để xem nội dung đầy đủ.

Khi xem log, bạn có thể chia sẻ với đội hỗ trợ:

• Nút chia sẻ — Mở bảng chia sẻ iOS để xuất traceback qua bất kỳ ứng dụng nào (email, lưu trữ đám mây, tin nhắn, v.v.)
• Email tới Hỗ trợ — Gửi log trực tiếp đến email hỗ trợ Spark với file traceback đính kèm

Bạn có thể xóa tất cả log cho trò chơi từ menu trình duyệt log. Thao tác này xóa toàn bộ thư mục logs/ cho trò chơi đó.

Khi báo cáo vấn đề cho đội hỗ trợ:

1. Tái hiện vấn đề bằng cách khởi chạy trò chơi
2. Sau khi sập, mở Trình Xem Log từ màn hình Game Detail
3. Chia sẻ log traceback mới nhất trên Discord hoặc qua email

Traceback và thông tin hệ thống đính kèm cung cấp cho đội hỗ trợ các chi tiết cần thiết để chẩn đoán vấn đề.