Projektstruktur

Aufbau eines CS2SX-Projekts — Dateien, Verzeichnisse und generierter Output.

Ein CS2SX-Projekt besteht aus deinen .cs-Quelldateien, einer cs2sx.json Konfig und einer .csproj-Datei. Der Transpiler erzeugt alles weitere automatisch im cs2sx_out/-Verzeichnis.

Verzeichnisbaum

MeinProjekt/
├── MeinProjekt.csproj — .NET Projektdatei
├── cs2sx.json — CS2SX-Konfiguration
├── Program.cs — Haupt-App-Klasse (SwitchApp)
├── MeineKlasse.cs — Eine Klasse pro Datei
├── icon.jpg — App-Icon (optional, 256×256)
├── cs2sx_out/ — generierter C-Code (nicht bearbeiten!)
├── _forward.h — Forward-Declarations aller Typen
├── switchforms.h/.c — Runtime: UI, Collections, String, File I/O
├── switchapp.h — Runtime: SwitchApp-Loop, Grafik, Input, Audio
├── main.c — Auto-generierter Einstiegspunkt
├── MeineKlasse.h/.c — Transpilierter Code
└── MeinProjekt.elf — Intermediate ELF
└── MeinProjekt.nro — fertige Homebrew-Datei

cs2sx.json

Die Konfigurationsdatei steuert Name, Autor, Version und App-Icon der NRO.

{
    "name": "MeinProjekt",
    "author": "Dein Name",
    "version": "1.0.0",
    "mainClass": "MyApp",
    "icon": "icon.jpg"
}
FeldTypBeschreibung
namestringApp-Name (erscheint im Switch Home-Menü)
authorstringEntwicklername
versionstringVersionsnummer, z.B. "1.0.0"
mainClassstringName der SwitchApp-Subklasse
iconstring?Pfad zum App-Icon (256×256 JPEG, optional)

Wichtige Regeln

Eine Klasse pro .cs-Datei — keine verschachtelten Klassen, keine mehrfachen Top-Level-Klassen.
Genau ein SwitchApp-Subtyp pro Projekt — das ist der Einstiegspunkt.
cs2sx_out/ wird bei jedem Build inkrementell aktualisiert — nur geänderte Dateien werden neu transpiliert.

Render-Modi

CS2SX unterstützt zwei Render-Modi die sich gegenseitig ausschließen:

🖥 Console-Modus

Standard, wenn Graphics.Init() nicht aufgerufen wird.

  • ANSI-Terminal-Ausgabe
  • Label, Button, ProgressBar Controls
  • D-Pad Navigation zwischen Buttons

🎨 Framebuffer-Modus

Aktiviert durch Graphics.Init(1280, 720) in OnInit().

  • Direktes Pixel-Rendering
  • 1280×720 RGBA8888
  • Alle Graphics.X Methoden

Referenz