프로젝트 소개

EmuCoreX는 Android 및 데스크톱용 PlayStation 2 라이브러리, 런처 및 에뮬레이터 프런트엔드입니다. 목적에 맞게 제작된 인터페이스와 오픈소스 PCSX2 프로젝트에서 파생되어 EmuCoreX가 지원 아키텍처별로 각색한 에뮬레이션 코어를 결합합니다. README에 설명된 주요 기능: - Android용으로 각색된 PCSX2 기반 에뮬레이션 코어 - 커버 아트, 게임 메타데이터, 최근 게임 및 검색이 있는 홈 화면 - BIOS 및 게임 폴더 설정, 폴더가 유효하지 않게 될 때의 복구 포함 - 렌더러, 화면 비율, 해상도, 스피드핵, 치트, FPS 및 빠른 작업을 위한 인게임 오버레이 - 세이브 스테이트 관리자, BIOS 부팅 및 사이드 드로어에서의 라이브러리 탐색 - 전용 업적 화면이 있는 RetroAchievements 통합 - .pnach 가져오기, 편집 및 게임별 활성화가 있는 치트 관리 - MediaTek용 기기 안전 기본값을 포함한 고급 그래픽 및 GS 핵 제어 - 물리 게임패드 리매핑 및 게임패드 인식 UI 흐름 - 네이티브 Qt Quick 인터페이스를 갖춘 Windows, Linux 및 macOS용 공유 데스크톱 애플리케이션 상태 및 요구 사항: 이 프로젝트는 명시적으로 초기 개발 단계이며 불안정하다고 표시되어 있으며, 게임, 기기, 렌더러 및 드라이버에 따라 충돌, 속도 저하 및 시각적 문제가 발생할 수 있습니다. 현재 Android 초점은 중급 및 고급형 휴대폰이며, 보급형 기기는 최적화되지 않았습니다. 최적화 작업은 주로 Snapdragon 기기에 집중되어 있으며 MediaTek 최적화는 불완전합니다. README는 MediaTek 기기에서 먼저 OpenGL 렌더러를 시도하고 Software 렌더링을 대체 수단으로 사용할 것을 권장합니다. 2026년 7월 기준으로 나열된 최소 권장 사양은 Snapdragon 855 또는 Dimensity 900이나 1080과 같은 이에 상응하는 MediaTek 칩셋이며, 최소 4GB RAM, 권장 6GB입니다. 이는 보장이 아닌 실용적인 시작점으로 설명됩니다. 데스크톱 빌드는 Windows-MacOS-Linux/ 디렉터리에서 활발히 개발 중이며, x64 및 ARM64의 Windows, Linux 및 macOS를 대상으로 합니다. 첫 공개 데스크톱 사전 릴리스 알파는 2026년 말로 계획되어 있으며, 보장된 날짜가 아닌 개발 목표로 설명됩니다. 공개 데스크톱 바이너리는 아직 제공되지 않습니다. 기술 스택: Android 측에서는 Kotlin과 Jetpack Compose 및 Android DataStore, 네이티브 C++로의 JNI 브리지, PCSX2에서 파생된 에뮬레이션 코어, Firebase 서비스, 데스크톱 애플리케이션용 C++20과 Qt 6, Qt Quick 및 QML입니다. Android 앱 버전 0.3.8은 패키지 ID com.sbro.emucorex에서 minSdk 29 및 targetSdk 37을 대상으로 합니다. 로컬 빌드에는 Android SDK 및 NDK가 구성된 Android Studio, 호환되는 JDK, 그리고 기기 또는 에뮬레이터가 필요합니다. 디버그 및 릴리스 빌드는 Gradle 래퍼 작업 :app:assembleDebug 및 :app:assembleRelease를 사용합니다. 저장소에는 Android 앱 모듈, Kotlin 앱 코드, 네이티브 브리지 및 코어 소스, Android 리소스 및 번역, 그리고 공유 데스크톱 애플리케이션, 네이티브 코어 어댑터, 패키징 스크립트 및 데스크톱 번역이 포함되어 있습니다. 중요 사항: BIOS 파일 및 게임 이미지는 프로젝트와 함께 배포되지 않습니다. 사용자는 합법적으로 획득한 자신의 BIOS 파일과 게임 덤프를 제공해야 합니다. 호환성, 성능 및 그래픽 동작은 기기와 렌더러에 따라 다릅니다. "parallel"로 표시된 릴리스는 기본 빌드와 동일하지만 나란히 설치할 수 있도록 대체 패키지 ID를 사용합니다. 이 프로젝트는 GPL 라이선스가 있는 PCSX2 코드를 포함하고 그에서 파생되었기 때문에 GNU General Public License v3.0 이상에 따라 배포됩니다.