CLI-Befehle
Alle cs2sx Kommandozeilenbefehle — new, build, check, watch und genstubs.
Übersicht
| Befehl | Beschreibung |
|---|---|
| cs2sx new <AppName> | Neues Projekt mit Vorlage erstellen |
| cs2sx build <csproj|folder> | Vollständiger Build → .nro |
| cs2sx check <csproj> | Transpile-only, kein GCC — schnelle Fehlerprüfung |
| cs2sx watch <csproj|folder> | Datei-Watcher mit automatischem Rebuild |
| cs2sx genstubs <include> <out> | C#-Stubs aus libnx-Headern generieren |
cs2sx new
Erstellt ein neues Projekt mit .csproj, cs2sx.json,
einer Vorlage-Program.cs und exportierten Stubs im Projektverzeichnis.
cs2sx new MeinProjekt Creating project 'MeinProjekt'... Done! Project created at: ./MeinProjekt Build with: cs2sx build MeinProjekt/MeinProjekt.csprojLegt an: MeinProjekt.csproj, cs2sx.json, Program.cs
cs2sx build
Führt die vollständige 6-stufige Build-Pipeline aus: prepare → fwd-decl → semantic → transpile → compile → package.
Das Ergebnis ist eine fertige .nro-Datei im Projektverzeichnis.
cs2sx build MeinProjekt/MeinProjekt.csproj prepare ✓ 3 source file(s) found 12ms fwd-decl ✓ 18ms semantic ✓ 3 file(s) 95ms transpile ✓ 3 transpiled, 0 unchanged 210ms compile ✓ 4 translation unit(s) 1840ms package ✓ MeinProjekt.nro 2180msInkrementeller Build
Nur geänderte .cs-Dateien werden neu transpiliert. Unveränderte Dateien werden übersprungen.
Header-Abhängigkeiten (z.B. Vererbung) werden ebenfalls berücksichtigt.
cs2sx build MeinProjekt/MeinProjekt.csproj transpile ✓ 1 transpiled, 2 unchangedcs2sx check
Transpiliert alle Dateien und prüft auf Fehler — ohne GCC aufzurufen. Deutlich schneller als ein vollständiger Build, ideal für schnelles Feedback während der Entwicklung.
cs2sx check MeinProjekt/MeinProjekt.csproj CS2SX check: MeinProjekt ──────────────────────────────────────────────────────────── ✓ Program.cs 0 issues ✓ Enemy.cs 0 issues ⚠ UI.cs 1 warning(s) ✓ Keine Issues in 3 Datei(en) [transpile-only, kein GCC]Exit-Code: 0 = keine Issues, 1 = Fehler, 2 = nur Warnings
cs2sx watch
Überwacht alle .cs- und .h-Dateien im Projektverzeichnis
und löst bei Änderungen automatisch einen vollständigen Build aus.
Verwendet einen 500ms Debounce um mehrere gleichzeitige Änderungen zu bündeln.
cs2sx watch MeinProjekt/MeinProjekt.csproj Watching: ./MeinProjekt Press Ctrl+C to stop. Changed: Program.cs Building MeinProjekt... package ✓ MeinProjekt.nro Watching for changes... (14:32:07)cs2sx_out/-Verzeichnis wird automatisch vom Watcher ignoriert — generierte Dateien lösen keinen erneuten Build aus.cs2sx genstubs
Generiert C#-Stub-Dateien aus libnx-Header-Dateien. Die Stubs dienen als Typ-Referenz für den Transpiler — sie sind keine echten P/Invoke-Bindings, sondern helfen dem C#-Compiler beim Validieren von CS2SX-Projekten.
cs2sx genstubs C:/devkitPro/libnx/include ./LibNXStubs 248 Header-Dateien gefunden. Generiert: switch/nro.cs Generiert: switch/hid.cs ... 183 Stub-Dateien generiert.| Argument | Beschreibung | Standard |
|---|---|---|
| <include> | Pfad zum libnx include-Verzeichnis | C:/devkitPro/libnx/include |
| <out> | Ausgabeverzeichnis für die generierten .cs-Dateien | ./LibNXStubs |