Build-Pipeline

Die 6-stufige Build-Pipeline von CS2SX — von C#-Quellcode zur fertigen NRO-Datei.

Pipeline-Übersicht

prepare

Prepare

Projektdateien einlesen, Runtime-Headers exportieren, switchforms.c schreiben.

fwd-decl

fwd-decl

Forward-Declarations (_forward.h) für alle Typen generieren — Roslyn parst alle .cs-Dateien.

semantic

Semantic

Roslyn SemanticModel für alle Projektdateien + Stubs aufbauen. Ermöglicht präzise Typ-Inferenz.

transpile

Transpile

C#-Dateien zu .h/.c transpilieren (inkrementell — nur geänderte Dateien). Header-Abhängigkeiten berücksichtigt.

compile

Compile

aarch64-none-elf-gcc kompiliert alle .c-Dateien zu einer .elf-Datei.

package

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.h und _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-sections

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

GCC-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.