Corrección de Error en Ejecutable Modo Windowed

Resumen

Se corrigió un error crítico en el ejecutable generado con PyInstaller en modo windowed (--noconsole). El error `'NoneType' object has no attribute 'buffer'` ocurría porque el código intentaba acceder a `sys.stdout.buffer` y `sys.stderr.buffer` sin verificar si estos objetos existían. En modo windowed, PyInstaller establece `sys.stdout` y `sys.stderr` como `None` porque no hay consola disponible. Se implementó detección de consola y manejo de errores con diálogos de Windows cuando no hay consola.

Concepto de Hardware

Este paso no está relacionado con la emulación de hardware del Game Boy, sino con la compatibilidad de ejecutables generados por PyInstaller en diferentes modos de ejecución.

Modo Windowed vs Console en PyInstaller:

• Modo Console (--console): Crea un ejecutable que muestra una ventana de consola (terminal negra) junto con la aplicación GUI. En este modo, `sys.stdout` y `sys.stderr` apuntan a objetos válidos que tienen un atributo `buffer` para acceso binario.
• Modo Windowed (--noconsole): Crea un ejecutable sin ventana de consola, solo la aplicación GUI. En este modo, `sys.stdout` y `sys.stderr` son `None` porque no hay consola disponible. Esto es el comportamiento esperado para aplicaciones GUI profesionales.

El problema ocurrió porque el código asumía que siempre habría consola disponible, intentando configurar el encoding UTF-8 accediendo directamente a `sys.stdout.buffer` sin verificar primero si `sys.stdout` era `None`.

Implementación

Se implementaron tres correcciones principales en `main.py`:

1. Verificación segura de sys.stdout/stderr

Se añadió verificación antes de acceder al atributo `buffer`:

# Antes (causaba error):
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8', errors='replace')

# Después (seguro):
if sys.stdout is not None and hasattr(sys.stdout, 'buffer'):
    sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8', errors='replace')

2. Detección de consola disponible

Se añadió una variable `has_console` que detecta si hay consola disponible:

has_console = sys.stdout is not None

Esta variable se usa para decidir si mostrar mensajes con `print()` o usar diálogos de Windows.

3. Manejo de errores con diálogos de Windows

Cuando no hay consola disponible, los errores se muestran usando diálogos nativos de Windows mediante `ctypes.windll.user32.MessageBoxW`:

if not has_console:
    try:
        import ctypes
        ctypes.windll.user32.MessageBoxW(
            0,
            "Error: Se requiere especificar una ROM\n\nUso: ViboyColor.exe ",
            "Viboy Color - Error",
            0x10  # MB_ICONERROR
        )
    except Exception:
        logging.error("Error: Se requiere especificar una ROM")

4. Prints condicionales

Todos los `print()` ahora solo se ejecutan si hay consola disponible:

if has_console:
    print("Viboy Color - Sistema Iniciado")
    print("=" * 50)

Decisiones de diseño

• Fallback a logging: Si el diálogo de Windows falla, se usa `logging.error()` como respaldo. Aunque en modo windowed no se verá, al menos no causará un crash.
• Compatibilidad hacia atrás: El código sigue funcionando en modo consola (cuando se ejecuta con `python main.py` directamente), manteniendo todos los `print()`.
• Experiencia de usuario: En modo windowed, los errores se muestran en diálogos nativos de Windows, que son más profesionales que una ventana de consola.

Archivos Afectados

• main.py (modificado) - Corrección de manejo de sys.stdout/stderr en modo windowed
• release/ViboyColor.exe (regenerado) - Ejecutable corregido (27.81 MB)

Tests y Verificación

La verificación se realizó mediante la regeneración del ejecutable y la corrección del error.

Error Original

• Error: AttributeError: 'NoneType' object has no attribute 'buffer'
• Ubicación: Línea 16 de `main.py` (antes de la corrección)
• Causa: Acceso a `sys.stdout.buffer` cuando `sys.stdout` era `None` en modo windowed

Corrección Aplicada

• Comando de build: python tools/build_release.py
• Entorno: Windows 11, Python 3.13.5
• Resultado: ✅ Build completado exitosamente sin errores
• Ejecutable regenerado: release/ViboyColor.exe (27.81 MB)

Validaciones Realizadas

• ✅ El código ahora verifica que `sys.stdout` no sea `None` antes de acceder a `.buffer`
• ✅ El código detecta correctamente si hay consola disponible
• ✅ Los `print()` solo se ejecutan si hay consola
• ✅ Los errores se muestran con diálogos de Windows cuando no hay consola
• ✅ El ejecutable se regeneró exitosamente con las correcciones

Nota: El ejecutable corregido debería funcionar correctamente ahora. La prueba funcional completa (ejecutar una ROM) se realizará en un paso posterior para verificar que todo el flujo funciona end-to-end.

Fuentes Consultadas

• PyInstaller Documentation - Windowed vs Console Mode: https://pyinstaller.org/en/stable/usage.html#windowed-mode
• Python sys.stdout documentation: https://docs.python.org/3/library/sys.html#sys.stdout
• Windows MessageBox API (ctypes): Documentación estándar de Windows API

Integridad Educativa

Próximos Pasos

• [ ] Probar el ejecutable corregido ejecutando una ROM de test
• [ ] Verificar que los diálogos de error se muestran correctamente cuando no hay consola
• [ ] Verificar que el ejecutable funciona correctamente con ROMs reales
• [ ] Considerar añadir un selector de archivos GUI para elegir ROMs (en lugar de argumentos de línea de comandos)
• [ ] Documentar el uso del ejecutable en el README