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"
}| Feld | Typ | Beschreibung |
|---|---|---|
| name | string | App-Name (erscheint im Switch Home-Menü) |
| author | string | Entwicklername |
| version | string | Versionsnummer, z.B. "1.0.0" |
| mainClass | string | Name der SwitchApp-Subklasse |
| icon | string? | 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
- devkitPro Getting Started: https://devkitpro.org/wiki/Getting_Started