Compilar TruchiEmu desde el Codigo Fuente
Compilar TruchiEmu desde el codigo fuente te permite acceder a las ultimas funcionalidades, contribuir al desarrollo o personalizar el emulador segun tus necesidades.
Prerequisitos
- macOS 14.0 (Sonoma) o posterior
- Xcode 15+ con soporte para Swift 5.9+
- XcodeGen instala via Homebrew:
brew install xcodegen - Xcode Command Line Tools instala via:
xcode-select --install
Pasos de Compilacion
-
Clona el repositorio
git clone https://github.com/JuanchoGithub/truchiemu.git cd truchiemu -
Genera el proyecto de Xcode
Edita
project.ymlsi es necesario, luego ejecuta:xcodegen generateEsto crea
TruchiEmu.xcodeproja partir de la especificacion del proyecto. -
Abre en Xcode
open TruchiEmu.xcodeproj -
Compila el proyecto
En Xcode: Product > Build (Cmd+B), o desde la terminal:
xcodebuild -project TruchiEmu.xcodeproj -scheme TruchiEmu -configuration Debug build
Dependencias
TruchiEmu depende de las siguientes dependencias:
- Cores de Libretro: Backends de emulacion descargados y gestionados en tiempo de ejecucion
- SwiftData: Framework de datos persistentes de Apple (incluido con Swift)
- Metal: Framework de GPU de Apple para renderizado de shaders (incluido con macOS)
Problemas Comunes de Compilacion
XcodeGen No Encontrado
Instala via Homebrew: brew install xcodegen. Si ya esta instalado, asegurate de que este en tu PATH.
Errores del Compilador de Swift
Asegurate de tener Xcode 15+ instalado y seleccionado: sudo xcode-select -s /Applications/Xcode.app. Verifica la version de Swift con swift --version.
Errores del Estandar de C++
Este proyecto requiere gnu++17 (no el predeterminado de LLVM). Verifica que project.yml especifique el estandar de C++ correcto en los ajustes del target.
Bridging Header Faltante
Si ves errores de importacion de ObjC en archivos Swift, asegurate de que TruchiEmu-Bridging-Header.h este correctamente configurado en los ajustes de compilacion.