Build-Pipeline
Die 6-stufige Build-Pipeline von CS2SX — von C#-Quellcode zur fertigen NRO-Datei.
Pipeline-Übersicht
Prepare
Projektdateien einlesen, Runtime-Headers exportieren, switchforms.c schreiben.
fwd-decl
Forward-Declarations (_forward.h) für alle Typen generieren — Roslyn parst alle .cs-Dateien.
Semantic
Roslyn SemanticModel für alle Projektdateien + Stubs aufbauen. Ermöglicht präzise Typ-Inferenz.
Transpile
C#-Dateien zu .h/.c transpilieren (inkrementell — nur geänderte Dateien). Header-Abhängigkeiten berücksichtigt.
Compile
aarch64-none-elf-gcc kompiliert alle .c-Dateien zu einer .elf-Datei.
Package
nacptool erzeugt .nacp, elf2nro konvertiert .elf → .nro. Fertig!
Inkrementeller Build
CS2SX vergleicht Timestamps von .cs-Dateien mit den generierten .h/.c-Dateien.
Unveränderte Dateien werden übersprungen. Der Check berücksichtigt auch:
- Timestamp der
switchforms.hund_forward.h - Neueste Änderung irgendeines transpilierten Headers (Vererbungs-Szenarien)
GCC-Flags
aarch64-none-elf-gcc
-march=armv8-a+crc+crypto
-mtune=cortex-a57
-mtp=soft -fPIE
-ffunction-sections -fdata-sections
-std=c11
-O2 -Wall -Wextra
-specs=switch.specs
-lnx -lm
-Wl,--gc-sectionsWatch-Modus
cs2sx watch überwacht alle .cs und .h-Dateien und löst bei Änderungen
automatisch einen Build aus — mit 500ms Debounce um mehrere gleichzeitige Änderungen zu bündeln.
cs2sx watch MeinProjekt/MeinProjekt.csprojGCC-Fehler → C#-Quellzeilen
Der DiagnosticReporter verwaltet eine Source-Map von generierten C-Zeilen auf Original-C#-Zeilen.
GCC-Fehlermeldungen werden automatisch mit dem zugehörigen C#-Snippet angereichert — du siehst direkt welche
Zeile im C#-Code das Problem verursacht hat.