Sobre el proyecto

EmuCoreX es una biblioteca, lanzador y frontend de emulador de PlayStation 2 para Android y escritorio. Combina una interfaz diseñada específicamente con núcleos de emulación derivados del proyecto de código abierto PCSX2 y adaptados por EmuCoreX para cada arquitectura compatible. Características clave descritas en el README: - Núcleo de emulación basado en PCSX2 adaptado para Android - Pantalla de inicio con carátulas, metadatos de juegos, juegos recientes y búsqueda - Configuración de BIOS y carpetas de juegos, incluida la recuperación cuando las carpetas se vuelven inválidas - Superposición en el juego para renderizador, relación de aspecto, resolución, trucos de velocidad, trampas, FPS y acciones rápidas - Gestor de estados de guardado, arranque de BIOS y navegación de biblioteca desde un panel lateral - Integración con RetroAchievements con una pantalla dedicada de logros - Gestión de trampas con importación .pnach, edición y activación por juego - Controles avanzados de gráficos y GS hack, incluidos valores predeterminados seguros para dispositivos MediaTek - Reasignación de gamepad físico y flujos de interfaz conscientes del gamepad - Una aplicación de escritorio compartida para Windows, Linux y macOS con una interfaz nativa Qt Quick Estado y requisitos: el proyecto está marcado explícitamente como desarrollo temprano e inestable, con posibles bloqueos, ralentizaciones y problemas visuales según el juego, dispositivo, renderizador y controladores. El enfoque actual de Android son teléfonos de gama media y alta; los dispositivos económicos no están optimizados. El trabajo de optimización se centra principalmente en dispositivos Snapdragon, mientras que la optimización de MediaTek está incompleta. El README sugiere probar primero el renderizador OpenGL en dispositivos MediaTek, con renderizado por software como respaldo. Las especificaciones mínimas recomendadas a partir de julio de 2026 son un Snapdragon 855 o un chipset MediaTek comparable como Dimensity 900 o 1080, con al menos 4 GB de RAM y 6 GB recomendados. Se describen como puntos de partida prácticos más que garantías. Las compilaciones de escritorio están en desarrollo activo en el directorio Windows-MacOS-Linux/, dirigidas a Windows, Linux y macOS en x64 y ARM64. La primera versión preliminar alfa pública de escritorio está planificada para finales de 2026, descrita como un objetivo de desarrollo más que una fecha garantizada. Los binarios públicos de escritorio aún no están disponibles. Pila tecnológica: Kotlin con Jetpack Compose y Android DataStore en el lado de Android, un puente JNI a C++ nativo, el núcleo de emulación derivado de PCSX2, servicios de Firebase, y C++20 con Qt 6, Qt Quick y QML para la aplicación de escritorio. La versión 0.3.8 de la aplicación Android apunta a minSdk 29 y targetSdk 37 bajo el id de paquete com.sbro.emucorex. Para compilar localmente se requiere Android Studio con Android SDK y NDK configurados, un JDK compatible y un dispositivo o emulador. Las compilaciones de depuración y lanzamiento usan las tareas de Gradle wrapper :app:assembleDebug y :app:assembleRelease. El repositorio contiene el módulo de la aplicación Android, código Kotlin de la app, puente nativo y fuentes del núcleo, recursos y traducciones de Android, además de la aplicación de escritorio compartida, adaptadores de núcleo nativo, scripts de empaquetado y traducciones de escritorio. Notas importantes: los archivos BIOS y las imágenes de juegos no se distribuyen con el proyecto; los usuarios deben proporcionar sus propios archivos BIOS obtenidos legalmente y copias de juegos. La compatibilidad, el rendimiento y el comportamiento gráfico varían según el dispositivo y el renderizador. Las versiones marcadas como "paralelas" son idénticas a la compilación principal pero usan un id de paquete alternativo para instalación lado a lado. El proyecto se distribuye bajo la Licencia Pública General GNU v3.0 o posterior porque incluye y deriva del código PCSX2 con licencia GPL.