Upgraden von Xamarin auf .NET

  • Artikel

Wichtig

Der Microsoft-Support für Xamarin endet am 1. Mai 2024 für alle Xamarin-SDKs einschließlich Xamarin.Forms. Helfen Sie uns, Ihre Upgradeerfahrung von Xamarin auf .NET MAUI zu verbessern, indem Sie diese kurze Umfrage durchführen.

Xamarin-Projekte können nach einem Upgrade auf .NET ausgeführt werden. In der folgenden Tabelle sind die Xamarin-Projekttypen aufgeführt, die auf .NET upgegradet werden können:

Projektart Upgrade ausführen Handbuch
Xamarin.Android ✅ Upgraden von nativen Xamarin-Projekten
Xamarin.iOS ✅ Upgraden von nativen Xamarin-Projekten
Xamarin.Mac ✅ Upgraden von nativen Xamarin-Projekten
Xamarin.tvOS ✅ Upgraden von nativen Xamarin-Projekten
Xamarin.Forms ✅ Upgraden einer Xamarin.Forms-App zu einer Multiprojekt.NET MAUI-App
Upgraden einer Xamarin.Forms-App zu einer Einzelprojekt.NET MAUI-App
Xamarin.Forms UWP ✅ Xamarin.Forms UWP-Projektmigration
iOS-App-Erweiterungen ✅ Upgraden von nativen Xamarin-Projekten
Android Wear ✅ Upgraden von nativen Xamarin-Projekten
Android-Bindungsbibliothek ✅ Migration von bindenden Projekten auf Xamarin.Android
iOS-Bindungsbibliothek ✅ Migration von bindenden Projekten auf Xamarin.iOS
SpriteKit ✅ Upgraden von nativen Xamarin-Projekten
SceneKit ✅ Upgraden von nativen Xamarin-Projekten
Metal ✅ Upgraden von nativen Xamarin-Projekten
OpenGL ❌ (iOS) Aus iOS entfernt, da OpenTK nicht verfügbar
Xamarin.watchOS ❌ Empfehlung: Bündeln von Swift-Erweiterungen mit .NET für iOS-Apps

Wichtig

Upgraden einer App von Xamarin auf .NET:

  • Alle Projekte müssen in den SDK-Stil umgewandelt werden.
  • Projekte müssen nicht umgeschrieben werden.
  • Multiprojektlösungen müssen kein Einzelprojekt mit mehreren Zielen werden.

Zum Aktualisieren Ihrer nativen Xamarin-Projekte auf .NET müssen Sie zuerst die Projekte aktualisieren, sodass die Projekte im SDK-Stil vorliegen, und dann Ihre Abhängigkeiten auf .NET 8 aktualisieren. Weitere Informationen finden Sie unter Upgrade Xamarin.Android-, Xamarin.iOS- und Xamarin.Mac-Projekten auf .NET.

Der .NET-Upgrade-Assistent ist ein Befehlszeilentool, mit dem Sie Multiprojekt-Xamarin.Forms-Apps auf Multiprojekt.NET Multi-Platform App UI (.NET MAUI)-Apps upgraden können. Nach dem Ausführen des Tools erfordert die App in den meisten Fällen weitere Schritte, um das Upgrade abzuschließen. Weitere Informationen finden Sie unter Upgraden einer Xamarin.Forms-App zu einer .NET MAUI-App mit dem .NET-Upgrade-Assistenten.

Sie können eine Xamarin.Forms-App auch manuell in einem zweistufigen Prozess zu einer Multiprojekt-.NET MAUI-App upgraden:

  1. Upgraden Sie Ihre nativen Xamarin-Projekte in Ihrer Xamarin.Forms-Lösung auf .NET. Weitere Informationen finden Sie unter Upgraden von Xamarin.Android-, Xamarin.iOS- und Xamarin.Mac-Apps auf .NET. Darüber hinaus können Sie Ihr Xamarin.Forms UWP-Projekt auf ein .NET MAUI WinUI 3-Projekt aktualisieren. Weitere Informationen finden Sie unter Xamarin.Forms UWP-Projektmigration.
  2. Upgraden Sie Ihr Xamarin.Forms-Bibliotheksprojekt auf .NET Multi-Platform App UI (.NET MAUI). Weitere Informationen finden Sie unter Manuelles Upgraden einer Xamarin.Forms-App zu einer Multiprojekt.NET MAUI-App.

Alternativ können Sie ein manuelles Upgrade einer Xamarin. Forms-App zu einer Einzelprojekt.NET MAUI-App durchführen. Weitere Informationen finden Sie unter Manuelles Upgraden einer Xamarin.Forms-App zu einer Einzelprojekt.NET MAUI-App.