Visor de Registros
El Visor de Registros te permite revisar los registros de traceback de Ren’Py generados cuando un juego encuentra un error o cierre inesperado.
Cómo se Capturan los Registros
Sección titulada «Cómo se Capturan los Registros»Cuando un juego Ren’Py se cierra inesperadamente o encuentra un error de Python durante el juego, el motor escribe un archivo traceback.txt en el directorio del juego. Cuando el juego se cierra, Spark automáticamente:
- Detecta el archivo
traceback.txt - Añade información del sistema de Spark (versión de iOS, versión de Spark, versión del motor, ajustes del juego y configuración del dispositivo)
- Renombra el archivo con una marca de tiempo (ej.
traceback_20260311_143022.txt) - Lo mueve a una carpeta
logs/dentro del directorio del juego
Cada cierre inesperado genera un archivo de registro separado, por lo que puedes revisar el historial de errores de un juego.
Acceder al Visor de Registros
Sección titulada «Acceder al Visor de Registros»El Visor de Registros es accesible desde la pantalla de Detalle del Juego. Un botón verde Logs aparece cuando un juego tiene uno o más registros de traceback disponibles.
Si se detecta un traceback inmediatamente después de que un juego se cierra, Spark te alertará que hay un archivo de registro disponible para revisión con una opción para verlo de inmediato.
Qué Muestran los Registros
Sección titulada «Qué Muestran los Registros»Los registros contienen tracebacks de Ren’Py — mensajes de error de Python y trazas de pila que describen qué salió mal durante la ejecución del juego. Cada registro también incluye información del sistema de Spark añadida al final:
- Versión del motor Ren’Py utilizada
- Versión de iOS y versión/número de compilación de Spark
- Configuración completa de la app y ajustes del juego
- Ajustes de traducción (si están activados)
- Variantes del dispositivo sobreescritas (si están establecidas)
Navegador de Registros
Sección titulada «Navegador de Registros»El navegador de registros muestra todos los archivos de traceback guardados para el juego seleccionado, ordenados del más reciente al más antiguo. Cada entrada muestra el nombre del archivo y la fecha de creación. Toca un registro para ver su contenido completo.
Compartir Registros
Sección titulada «Compartir Registros»Al ver un registro, puedes compartirlo con el equipo de soporte:
- Botón de compartir — Abre la hoja de compartir de iOS para exportar el traceback a través de cualquier app (correo, almacenamiento en la nube, mensajería, etc.)
- Enviar por correo al Soporte — Envía el registro directamente al correo de soporte de Spark con el archivo de traceback adjunto
Eliminar Registros
Sección titulada «Eliminar Registros»Puedes eliminar todos los registros de un juego desde el menú del navegador de registros. Esto elimina toda la carpeta logs/ de ese juego.
Usar Registros para Solución de Problemas
Sección titulada «Usar Registros para Solución de Problemas»Al reportar problemas al equipo de soporte:
- Reproduce el problema iniciando el juego
- Después del cierre inesperado, abre el Visor de Registros desde la pantalla de Detalle del Juego
- Comparte el registro de traceback más reciente en Discord o por correo electrónico
El traceback y la información del sistema añadida proporcionan al equipo de soporte los detalles necesarios para diagnosticar el problema.
Mensajes Comunes de Traceback
Sección titulada «Mensajes Comunes de Traceback»| Mensaje | Significado |
|---|---|
SystemExit | El juego se cerró normalmente o vía Spark |
ImportError | Módulo de Python faltante — puede necesitar una versión diferente del motor |
IOError / FileNotFoundError | Recurso o archivo del juego faltante |
MemoryError | Dispositivo con poca memoria — ver Jetsam |
Errores de pickle | Incompatibilidad de archivo de guardado — ver Problemas de Guardado |