Quelltext der Seite Von Xamarin zu .NET MAUI migrieren

{{Steckbrief
| gilt_fuer   = Xamarin.Forms 5, Xamarin.Android/Xamarin.iOS → .NET MAUI 10 (.NET 10 LTS); Visual Studio 2026
| bereich     = Softwareentwicklung
| dauer       = je nach App wenige Tage bis mehrere Wochen
| rechte      = Entwicklungsumgebung, Apple-Developer- und Google-Play-Konto
| stand       = Oktober 2026
}}
'''Von Xamarin zu .NET MAUI migrieren''' ist für jede noch gepflegte Xamarin-App Pflicht: Microsoft hat den Support für Xamarin am '''1. Mai 2024''' beendet, und neue App-Versionen lassen sich mit der alten Toolchain nicht mehr in die Stores bringen, weil Apple und Google regelmäßig aktuelle SDKs verlangen. Nachfolger ist '''.NET MAUI''' (.NET Multi-platform App UI), das Android, iOS, macOS und Windows mit einer Codebasis abdeckt.

[[Datei:Xamarin-zu-NET-MAUI.png|thumb|center|750px|Von Xamarin zu .NET MAUI: Aus mehreren Plattformprojekten wird ein Single Project; Renderer werden zu Handlern, Xamarin.Essentials ist integriert, MvvmLight und MessagingCenter werden durch das CommunityToolkit.Mvvm ersetzt.]]

== Warum jetzt migrieren? ==
* '''Kein Support:''' Xamarin erhält seit Mai 2024 keine Fehlerbehebungen und Sicherheitsupdates mehr.
* '''Store-Vorgaben:''' Google Play verlangt jedes Jahr ein höheres Ziel-API-Level, Apple für Uploads eine aktuelle Xcode-Version. Beides unterstützt die Xamarin-Toolchain nicht mehr – Updates bestehender Apps sind damit faktisch blockiert.
* '''Entwicklungsumgebung:''' Visual Studio für Mac wurde am 31. August 2024 eingestellt; Xamarin-Projekte werden von aktuellen Visual-Studio-Versionen nicht mehr unterstützt.
* '''Leistung und Funktionen:''' .NET MAUI nutzt das aktuelle .NET mit besserer Startzeit, Trimming, Native AOT (iOS) und Hot Reload.

== Was sich ändert: Xamarin und .NET MAUI im Vergleich ==
{| class="wikitable"
! Xamarin !! .NET MAUI 10
|-
| je Plattform ein eigenes Projekt (Android, iOS, UWP) + Shared/PCL || '''ein Projekt''' (Single Project) mit Ordner <code>Platforms/</code>
|-
| Xamarin.Forms-Namensräume <code>Xamarin.Forms</code> || <code>Microsoft.Maui</code>, <code>Microsoft.Maui.Controls</code>
|-
| Custom Renderer || '''Handler''' (Renderer laufen übergangsweise über Kompatibilitäts-APIs)
|-
| Xamarin.Essentials (separates Paket) || in .NET MAUI enthalten (<code>Microsoft.Maui.ApplicationModel</code>, <code>…Devices</code>, <code>…Storage</code>)
|-
| DependencyService || Dependency Injection in <code>MauiProgram.cs</code>
|-
| MvvmLight, MessagingCenter || '''CommunityToolkit.Mvvm''' mit <code>WeakReferenceMessenger</code>
|-
| ListView, TableView || '''CollectionView''' (ListView ist ab .NET 10 als veraltet markiert)
|-
| Ressourcen je Plattform (Schriften, Bilder, Icons) || zentral in <code>Resources/</code> (<code>MauiFont</code>, <code>MauiImage</code>, <code>MauiIcon</code>, <code>MauiSplashScreen</code>)
|-
| iOS-Storyboards, Android-AXML-Layouts (Xamarin.iOS/Android ohne Forms) || weiter möglich in „.NET for iOS/Android“; für gemeinsame Oberflächen XAML in .NET MAUI
|-
| Xamarin Studio, Visual Studio für Mac || Visual Studio 2026 (Windows) oder VS Code mit .NET-MAUI-Erweiterung (macOS, Windows, Linux)
|}

== Vorgehen in sechs Schritten ==
# '''Bestandsaufnahme:''' Projekte, NuGet-Pakete und Custom Renderer auflisten. Für jedes Paket prüfen, ob es eine .NET-MAUI-Version gibt (z. B. Syncfusion, Telerik, SQLite-net, Plugin.*-Pakete).
# '''Neues .NET-MAUI-Projekt''' anlegen (<code>dotnet new maui -n MeineApp</code>) und den gemeinsamen Code (Models, Services, ViewModels) übernehmen. Bei gewachsenen Xamarin.Forms-Apps ist das meist übersichtlicher als eine Konvertierung „an Ort und Stelle“; Microsoft Learn beschreibt beide Wege.
# '''Namensräume und APIs''' anpassen: <code>Xamarin.Forms</code> → <code>Microsoft.Maui.Controls</code>, <code>Xamarin.Essentials</code> → Maui-Namensräume, <code>Device.BeginInvokeOnMainThread</code> → <code>MainThread.BeginInvokeOnMainThread</code>, Farben/Layouts nach Migrationsleitfaden.
# '''Renderer zu Handlern''' umbauen und plattformspezifischen Code in <code>Platforms/Android</code> bzw. <code>Platforms/iOS</code> verschieben.
# '''MVVM modernisieren:''' MvvmLight bzw. MessagingCenter durch das CommunityToolkit.Mvvm ersetzen, siehe [[.NET MAUI: MVVM mit dem CommunityToolkit.Mvvm statt MvvmLight]].
# '''Testen und veröffentlichen:''' auf echten Geräten testen, Bundle-ID/Package-Name und Signierung übernehmen (sonst entsteht im Store eine neue App) und mit <code>dotnet publish</code> veröffentlichen.

{{Tipp|Visual Studio 2026 und Visual Studio 2022 (ab 17.14.16) enthalten den Agenten '''GitHub Copilot App Modernization''', der Migrationen planen und schrittweise durchführen kann. Er ersetzt den eingestellten .NET Upgrade Assistant. Das Ergebnis immer per Code-Review prüfen.}}

== Was wird aus den alten Xamarin-Problemen? ==
* '''Storyboards lassen sich nach Xcode-Update nicht öffnen:''' Den iOS-Designer gibt es nicht mehr. Oberflächen entstehen in XAML mit Hot Reload; bei reinen .NET-for-iOS-Apps werden Storyboards direkt in Xcode bearbeitet.
* '''„Disallowed Paths“ / iTunesMetadata.plist beim Upload:''' Der Upload über den Xcode Organizer aus Xamarin-Archiven entfällt. Heute wird mit <code>dotnet publish -f net10.0-ios -c Release</code> eine IPA erzeugt und mit der App ''Transporter'' oder per CI zu App Store Connect hochgeladen.
* '''Downgrade der Entwicklungsumgebung:''' Statt Frameworks von Hand zu löschen, wird die Workload-Version per <code>global.json</code> festgelegt, siehe [[.NET MAUI: Workload-Version und Xcode festlegen]].

== Hinweise ==
* '''Versionen:''' .NET 10 ist LTS bis November 2028; .NET 11 erscheint im November 2026 als STS-Version. Für Unternehmens-Apps ist .NET 10 die richtige Basis.
* '''Bundle-ID beibehalten''', damit Nutzer ein Update statt einer neuen App erhalten.
* '''Kosten realistisch planen:''' Einfache Formular-Apps sind oft in wenigen Tagen migriert; viele Custom Renderer oder veraltete Drittanbieter-Komponenten erhöhen den Aufwand deutlich.
* Bei der Migration Ihrer Xamarin-Apps nach .NET MAUI unterstützt Sie die [https://www.max-it.de/development/individuelle-softwareentwicklung/ individuelle Softwareentwicklung von m.a.x. it] – von der Bestandsaufnahme bis zur Veröffentlichung im Store.

== Siehe auch ==
* [[.NET MAUI: Entwicklungsumgebung einrichten]]
* [[.NET MAUI: Strategien und Vorteile plattformübergreifender Apps]]
* [[.NET MAUI: MVVM mit dem CommunityToolkit.Mvvm statt MvvmLight]]
* [[.NET MAUI: Workload-Version und Xcode festlegen]]
* [[.NET MAUI: Eigene Schriftarten einbinden]]

== Links und Quellen ==
* [https://learn.microsoft.com/de-de/dotnet/maui/migration/ Microsoft Learn: Von Xamarin zu .NET MAUI migrieren]
* [https://www.max-it.de/development/individuelle-softwareentwicklung/ Individuelle Softwareentwicklung und App-Entwicklung von m.a.x. it]

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