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

  1. Clona el repositorio
    git clone https://github.com/JuanchoGithub/truchiemu.git
    cd truchiemu
  2. Genera el proyecto de Xcode

    Edita project.yml si es necesario, luego ejecuta:

    xcodegen generate

    Esto crea TruchiEmu.xcodeproj a partir de la especificacion del proyecto.

  3. Abre en Xcode
    open TruchiEmu.xcodeproj
  4. 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.