CLI-Befehle

Alle cs2sx Kommandozeilenbefehle — new, build, check, watch und genstubs.

Übersicht

BefehlBeschreibung
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.csproj

Legt 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                  2180ms

Inkrementeller 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 unchanged

cs2sx 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)
Das 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.
ArgumentBeschreibungStandard
<include>Pfad zum libnx include-VerzeichnisC:/devkitPro/libnx/include
<out>Ausgabeverzeichnis für die generierten .cs-Dateien./LibNXStubs