Compilando o TruchiEmu a Partir do Código-Fonte

Compilar o TruchiEmu a partir do código-fonte permite acessar os recursos mais recentes, contribuir para o desenvolvimento ou personalizar o emulador para suas necessidades.

Pré-requisitos

macOS 14.0 (Sonoma) ou posterior
Xcode 15+ com suporte a Swift 5.9+
XcodeGen instale via Homebrew: brew install xcodegen
Xcode Command Line Tools instale via: xcode-select --install

Passos de Compilação

Clone o repositório

git clone https://github.com/JuanchoGithub/truchiemu.git
cd truchiemu

Gere o projeto Xcode
Edite o project.yml se necessário, depois execute:
```
xcodegen generate
```
Isso cria o TruchiEmu.xcodeproj a partir da especificação do projeto.
Abra no Xcode
```
open TruchiEmu.xcodeproj
```

Compile o projeto

No Xcode: Product > Build (Cmd+B), ou pelo terminal:

xcodebuild -project TruchiEmu.xcodeproj -scheme TruchiEmu -configuration Debug build

Dependências

O TruchiEmu depende das seguintes dependências:

Cores Libretro: Backends de emulação baixados e gerenciados em tempo de execução
SwiftData: Framework de dados persistentes da Apple (incluído com Swift)
Metal: Framework de GPU da Apple para renderização de shaders (incluído com macOS)

Problemas Comuns de Compilação

XcodeGen Não Encontrado

Instale via Homebrew: brew install xcodegen. Se já estiver instalado, certifique-se de que está no seu PATH.

Erros do Compilador Swift

Certifique-se de ter o Xcode 15+ instalado e selecionado: sudo xcode-select -s /Applications/Xcode.app. Verifique a versão do Swift com swift --version.

Erros de Padrão C++

Este projeto requer gnu++17 (não o padrão LLVM). Verifique se o project.yml especifica o padrão C++ correto nas configurações do alvo.

Bridging Header Ausente

Se você vir erros de importação ObjC em arquivos Swift, certifique-se de que o TruchiEmu-Bridging-Header.h está devidamente configurado nas configurações de compilação.