imported>TechCorner-Redaktion: Neufassung von "Xamarin.iOS:Downgrade der Entwicklungsumgebung": Workload Sets, global.json, xcode-select

2026-10-14T00:00:00Z

Neufassung von "Xamarin.iOS:Downgrade der Entwicklungsumgebung": Workload Sets, global.json, xcode-select

Neue Seite

{{Steckbrief
| gilt_fuer = .NET MAUI 9/10, .NET SDK ab 8.0.400 (Workload Sets), Xcode 26/27 auf macOS
| bereich = Softwareentwicklung
| dauer = 15–60 Minuten (inkl. Xcode-Download)
| rechte = Administrator auf Windows-PC und Mac
| stand = Oktober 2026
}}
'''Workload-Version und Xcode festlegen''' ist bei .NET MAUI die moderne Form des „Downgrades“: Bringt ein Update der Entwicklungsumgebung Fehler mit oder verlangt eine neuere Xcode-Version, als auf dem Mac installiert ist, schreiben Sie per <code>global.json</code> eine bekannte, funktionierende Kombination aus .NET SDK und Workload-Set fest – für alle Entwickler und den Build-Server gleich. Das manuelle Löschen von Frameworks wie zu Xamarin-Zeiten entfällt.

[[Datei:NET-MAUI-Workload-Xcode.png|thumb|center|750px|Workload-Set und Xcode-Version gehören zusammen: per global.json festschreiben, passende Workloads installieren und Xcode mit xcode-select auswählen.]]

== Problem ==
* Nach einem Update von Visual Studio oder des .NET SDK bricht der iOS-Build ab mit: ''„This version of .NET for iOS (…) requires Xcode 27.0. The current version of Xcode is 26.6.“''
* Eine neue MAUI-Version enthält einen Fehler, der die App unbrauchbar macht.
* Entwickler und Build-Server bauen mit unterschiedlichen Workload-Versionen und erhalten unterschiedliche Ergebnisse.

== Ursache ==
Jede Version der .NET-Workloads für iOS, Mac Catalyst und macOS ist an eine bestimmte Xcode-Version gebunden. Visual Studio und <code>dotnet workload update</code> aktualisieren die Workloads automatisch auf das neueste '''Workload Set''' – Xcode auf dem Mac bleibt dabei unverändert.

== Lösung ==
=== Schritt 1: Installierte Versionen ermitteln ===
<syntaxhighlight lang="bash">
dotnet --version
dotnet workload --version # aktuelles Workload-Set, z. B. 10.0.401.1
dotnet workload list
xcodebuild -version # auf dem Mac
</syntaxhighlight>

=== Schritt 2: Workload-Set festschreiben ===
Im Stammverzeichnis der Projektmappe eine <code>global.json</code> anlegen bzw. ergänzen:
<syntaxhighlight lang="json">
{
"sdk": {
"version": "10.0.401",
"workloadVersion": "10.0.401",
"rollForward": "disable"
}
}
</syntaxhighlight>
Die passende Kombination aus Workload-Set und Xcode steht in den Release Notes von .NET for iOS bzw. .NET MAUI.

Dann die Workloads in genau dieser Version installieren:
<syntaxhighlight lang="bash">
dotnet workload install maui --version 10.0.401
</syntaxhighlight>
Auf dem Mac mit <code>sudo</code> ausführen. Bei Pair to Mac überträgt Visual Studio die passenden Komponenten automatisch.

=== Schritt 3: Passende Xcode-Version auswählen ===
Mehrere Xcode-Versionen können parallel installiert sein (z. B. <code>/Applications/Xcode_26.6.app</code> und <code>/Applications/Xcode.app</code>). Ältere Versionen gibt es im Apple-Developer-Portal unter ''More Downloads''.
<syntaxhighlight lang="bash">
sudo xcode-select -s /Applications/Xcode_26.6.app
xcodebuild -version
</syntaxhighlight>
Bei Pair to Mac verwendet Visual Studio die mit <code>xcode-select</code> ausgewählte Version; nach dem Umschalten die Verbindung zum Mac neu herstellen.

=== Schritt 4: Aufräumen und neu bauen ===
<syntaxhighlight lang="bash">
rm -rf bin obj
dotnet build -f net10.0-ios
</syntaxhighlight>

== Hinweise ==
* '''Nur vorübergehend:''' Apple akzeptiert im App Store nur Builds mit aktuellen Xcode-Versionen. Ein festgeschriebenes älteres Set überbrückt Probleme, ersetzt aber nicht das Update.
* '''Wieder aktualisieren:''' Eintrag <code>workloadVersion</code> entfernen bzw. erhöhen und <code>dotnet workload update</code> ausführen.
* '''CI/CD:''' Auf Build-Agents die <code>global.json</code> mit einchecken und die gewünschte Xcode-Version im Pipeline-Skript auswählen.
* '''Xamarin-Altprojekte:''' Für Xamarin gibt es keine neuen Versionen mehr; Downgrades lösen dort keine Store-Probleme. Siehe [[Von Xamarin zu .NET MAUI migrieren]].
* Bei Build-Pipelines und App-Veröffentlichung unterstützt Sie die [https://www.max-it.de/development/individuelle-softwareentwicklung/ individuelle Softwareentwicklung von m.a.x. it].

== Siehe auch ==
* [[.NET MAUI: Entwicklungsumgebung einrichten]]
* [[.NET MAUI: UnauthorizedAccessException beim Build beheben]]
* [[Von Xamarin zu .NET MAUI migrieren]]

== Links und Quellen ==
* [https://learn.microsoft.com/de-de/dotnet/core/tools/dotnet-workload-sets Microsoft Learn: dotnet workload sets]
* [https://www.max-it.de/development/individuelle-softwareentwicklung/ Individuelle Softwareentwicklung und App-Entwicklung von m.a.x. it]

{{Uebermax}}
[[Kategorie:Softwareentwicklung]]

.NET MAUI: Workload-Version und Xcode festlegen - Versionsgeschichte

imported>TechCorner-Redaktion: Neufassung von "Xamarin.iOS:Downgrade der Entwicklungsumgebung": Workload Sets, global.json, xcode-select