Checkliste für die Migration von Xamarin zu .NET MAUI: 9 Punkte, die vor der Schätzung geprüft werden sollten
Microsoft hat den Support für Xamarin einschließlich Xamarin.Forms am 1. Mai 2024 beendet. Apps auf dieser Basis laufen weiter, erhalten aber keine Updates und Sicherheitskorrekturen mehr und können neue Versionen der iOS- und Android-SDKs nicht nutzen. Für die meisten Teams lautet die Frage daher nicht mehr, ob sie zu .NET MAUI wechseln, sondern was der Wechsel kostet.
Ohne einen Blick in den Code lässt sich diese Zahl kaum nennen. Zwei Xamarin-Apps gleicher Größe können sich im Migrationsaufwand um ein Mehrfaches unterscheiden, je nachdem, wie viel davon reines C# ist und wie viel am Framework hängt. Diese Checkliste beschreibt die neun Bereiche, die wir prüfen, bevor wir eine Migration von Xamarin zu .NET MAUI schätzen. Die Gründe für eine Migration behandelt unser früherer Beitrag Warum Sie Ihre Xamarin-App auf .NET migrieren sollten.
Warum Schätzungen für Xamarin-Migrationen danebenliegen
Eine Xamarin.Forms-Anwendung wird für .NET MAUI nicht einfach neu kompiliert. Werkzeuge konvertieren Projektdateien und benennen viele Namespaces um, übrig bleibt Handarbeit: Custom Renderer, Plattformdienste, Navigation und Bibliotheken, die nie portiert wurden. Vom Anteil dieser Handarbeit hängt die Schätzung ab, und von außen ist er nicht zu erkennen. Eine App mit vierzig Bildschirmen ohne Custom Renderer kann günstiger zu migrieren sein als eine App mit zehn Bildschirmen und einer eigenen Kameraansicht.
Das Audit macht aus dieser Unbekannten eine Liste. Jeder Punkt unten endet mit der Frage, die die Schätzung beantworten muss.
Die Checkliste
1. Projektstruktur und Zielplattformen
Eine klassische Xamarin.Forms-Lösung besteht aus einem Shared Project oder einer .NET-Standard-Bibliothek und einem Projekt pro Plattform. .NET MAUI verwendet ein einziges App-Projekt mit Plattformordnern. Prüfen Sie, wie viel Code in den Plattformprojekten liegt und für welche Plattformen die App tatsächlich ausgeliefert wird: nur iOS und Android oder auch Windows und macOS.
Frage für die Schätzung: Wie viele Plattformprojekte müssen zusammengeführt werden, und ändert sich die Liste der Zielplattformen?
2. NuGet-Pakete und Drittanbieter-SDKs
Listen Sie jedes Paket auf und ordnen Sie es einer von drei Gruppen zu: Es gibt eine Version für .NET MAUI, es gibt einen Ersatz, oder es gibt keines von beiden. Analytics, Karten, Zahlungen, Push-Benachrichtigungen, Barcode-Scanning und Bluetooth-Bibliotheken sind die üblichen Kandidaten für die dritte Gruppe. Ein Paket ohne Nachfolger bedeutet entweder eine andere Bibliothek oder ein Binding, das Sie selbst pflegen.
Frage für die Schätzung: Wie viele Pakete brauchen einen Ersatz, und welche davon betreffen Kernfunktionen?
3. Custom Renderer und Effects
Custom Renderer sind die größte einzelne Quelle für Handarbeit. In Xamarin.Forms hat jedes angepasste Steuerelement eine Renderer-Klasse pro Plattform. .NET MAUI ersetzt sie durch Handler, und eine einfache Anpassung wird zu wenigen Zeilen Handler-Mapping. Komplexe Renderer, etwa eigenes Zeichnen, Kameravorschau oder Karten-Overlays, müssen neu geschrieben werden.
Frage für die Schätzung: Wie viele Renderer gibt es, und wie viele davon sind mehr als eine optische Anpassung?
4. Plattformdienste und DependencyService
Xamarin-Apps greifen auf Plattformfunktionen über Interfaces zu, die einmal pro Plattform implementiert und über DependencyService aufgelöst werden. .NET MAUI bringt für viele davon eigene APIs mit (Konnektivität, Einstellungen, sicherer Speicher, Geolokalisierung) und setzt auf Konstruktorinjektion statt auf einen Service Locator. Dienste mit eingebautem Gegenstück schrumpfen auf eine Implementierung, der Rest wird Plattform für Plattform portiert.
Frage für die Schätzung: Welche Plattformdienste entfallen, und welche müssen übernommen werden?
5. Navigation und Messaging
Prüfen Sie, wie Seiten geöffnet werden. Wenn ViewModels Seiten erzeugen und auf den Navigationsstapel legen, ist die Navigation mit der Oberfläche verflochten und muss getrennt werden, in der Regel in Shell-Routen hinter einem Interface. Suchen Sie außerdem nach MessagingCenter: Es existiert in .NET MAUI noch, gilt aber als veraltet, und Nachrichten mit String-Schlüsseln sind eine häufige Quelle für Fehler, die erst zur Laufzeit auffallen.
Frage für die Schätzung: Ist die Navigation zentral organisiert oder über die ViewModels verstreut?
6. ViewModels und ihre Abhängigkeit vom UI-Framework
Öffnen Sie einige ViewModels und sehen Sie sich die using-Direktiven an. Wenn sie Typen aus Xamarin.Forms wie Command, Device oder Color verwenden, lassen sie sich ohne das Framework nicht testen, und jedes einzelne muss angepasst werden. ViewModels, die nur von reinem .NET abhängen, ziehen nahezu unverändert um.
Frage für die Schätzung: Welcher Anteil der ViewModels verweist auf das UI-Framework?
7. Lokale Daten, Einstellungen und die App-Kennung
Dieser Punkt entscheidet, ob die Nutzer das Update bemerken. Bleiben App-Kennung und Signaturschlüssel gleich, liefern die Stores den .NET-MAUI-Build als gewöhnliches Update aus. Andernfalls ist es eine neue App, und jeder Nutzer muss sie neu installieren. Einstellungen und lokale Datenbanken der alten App müssen für die neue lesbar bleiben; Speicherorte und Formate sind daher zu prüfen.
Frage für die Schätzung: Was speichert die App auf dem Gerät, und kann die neue Version es lesen?
8. Build, Signierung und CI/CD
Die Xamarin-Toolchain steht auf aktuellen gehosteten Build-Agents nicht mehr zur Verfügung. Pipelines müssen auf das .NET SDK mit den .NET-MAUI-Workloads umgestellt werden, und der iOS-Build braucht einen macOS-Agent mit passender Xcode-Version. Provisioning-Profile, Keystores und die Schritte für den Store-Upload werden übernommen.
Frage für die Schätzung: Gibt es heute eine Pipeline, und wer verwaltet das Signaturmaterial?
9. Vorhandene Tests
Prüfen Sie zuletzt, was heute belegt, dass die App funktioniert. Unit-Tests für ViewModels und Geschäftslogik sind das Sicherheitsnetz der Migration. Gibt es keine, sollte der Plan vorsehen, zuerst Szenariotests gegen die alte App zu schreiben, damit dieselben Szenarien anschließend gegen die neue laufen können.
Frage für die Schätzung: Wie zeigen wir, dass sich die migrierte App wie die alte verhält?
Was die Ergebnisse für den Aufwand bedeuten
| Ergebnis | Auswirkung auf die Migration |
| Wenige Plattformprojekte, keine Custom Renderer | Überwiegend mechanische Konvertierung |
| Pakete ohne Version für .NET MAUI | Ersatzarbeit, die pro Paket bemessen wird |
| Viele komplexe Renderer | Neuentwicklung einzelner Steuerelemente; der größte Kostentreiber |
| ViewModels mit Bindung an Xamarin.Forms | Änderungen in jedem ViewModel, bevor es testbar ist |
| Keine automatisierten Tests | Szenariotests müssen zuerst geschrieben werden |
| Geänderte App-Kennung | Nutzer müssen neu installieren; nur mit gutem Grund |
Die Checkliste an einer echten Codebasis
In unserem GitHub-Repository pflegen wir ein kleines öffentliches Beispiel für diese Migration: eine App zur Sendungsverfolgung auf Xamarin.Forms 5 und dieselbe App auf .NET MAUI mit .NET 10. Es enthält die meisten der genannten Punkte im Kleinen: ein Shared Project mit einem Projekt pro Plattform, DependencyService als Service Locator, MessagingCenter mit String-Schlüsseln, einen Custom Renderer pro Plattform und ViewModels, die Seiten erzeugen.
Dieselben 11 Szenarien auf Bildschirmebene werden gegen die ViewModels beider Versionen kompiliert und laufen über HTTP gegen einen echten Dienst. Beide Versionen bestehen 11 von 11. Beim Schreiben der Szenarien für die alte App fiel zudem ein Fehler auf, der mit der Migration nichts zu tun hatte: Die Liste wurde bei jedem Erscheinen der Seite mehrfach geladen, weil zwei Bindings den Ladebefehl erneut auslösten. Auf einem Gerät ist das nur überflüssiger Netzwerkverkehr; im Testlauf verdoppelte es die Listeneinträge.
Das Beispiel sagt auch, was es nicht belegt. Die .NET-MAUI-App wird in der CI für Android und Windows gebaut, während der iOS-Build und das Verhalten auf einem physischen Gerät dort nicht geprüft sind. Ein echtes Projekt braucht zusätzlich zu den Szenarien Tests auf Geräten. Eine ausführliche Beschreibung finden Sie auf legacy-modernisierung.de.
Nach dem Audit: drei mögliche Ergebnisse
- Direkte Migration zu .NET MAUI. Wenige Renderer, Pakete mit Nachfolgern, ViewModels auf überwiegend reinem .NET. Das ist der kürzeste Weg.
- Migration mit Ersatz einzelner Teile. Die App wechselt zu .NET MAUI, einige Bibliotheken oder Steuerelemente werden jedoch ersetzt oder neu geschrieben. Das Audit führt sie einzeln auf.
- Ein anderes Ziel. Wenn das Mobile-Team mit JavaScript oder Dart arbeitet oder die Oberfläche ohnehin neu entstehen muss, kann eine Neuentwicklung in einem anderen plattformübergreifenden Framework die bessere Investition sein.
Zusammenfassung
Eine Schätzung für eine Xamarin-Migration ist nur so gut wie das Audit dahinter. Neun Bereiche bestimmen den Aufwand: Projektstruktur, Pakete, Custom Renderer, Plattformdienste, Navigation, ViewModels, lokale Daten und App-Kennung, die Build-Pipeline und Tests. Gehen Sie sie durch, bevor Sie ein Angebot einholen, oder bitten Sie den Dienstleister, es zu tun und Ihnen die Liste zu zeigen.
Chudovo führt dieses Audit als ersten Schritt jeder Zusammenarbeit durch. Umfang, Zeitrahmen und Preisspannen finden Sie auf unserer Seite zur Migration von Xamarin zu .NET MAUI.