Aktualisieren vorhandener Apps auf die einheitliche API

  • Artikel

Wichtig

Die klassische Xamarin-API, die der einheitlichen API voranging, ist veraltet.

  • Die letzte Version von Xamarin.iOS zur Unterstützung der klassischen API (monotouch.dll) war Xamarin.iOS 9.10.
  • Xamarin.Mac unterstützt weiterhin die klassische API, wird aber nicht mehr aktualisiert. Da sie veraltet ist, sollten Entwickler ihre Anwendungen in die Einheitliche API verschieben.

So aktualisieren Sie Ihre Apps

Es gibt drei Schritte zum Aktualisieren Ihrer Apps:

  1. Korrigieren Sie alle Compilerwarnungen in Ihrem vorhandenen Code, insbesondere diejenigen, die sich auf veraltete APIs beziehen.

  2. Verwenden Sie das integrierte Migrationstool zum Visual Studio für Mac, um Ihre Projektdateien und Namespaces zu aktualisieren.

  3. Beheben Sie verbleibende Compilerfehler im Zusammenhang mit den neuen 64-Typen und anderen APIs , die sich geändert haben. Weitere Informationen zu manuellen Updates, die möglicherweise erforderlich sind, finden Sie in diesen Tipps .

Für jedes Produkt stehen spezifische Leitfäden zur Verfügung, die Ihnen helfen, Ihre Apps auf die einheitliche API und die 64-Bit-Unterstützung zu aktualisieren:

Xamarin.iOS-Apps

Vorhandene Xamarin.iOS-Apps können mithilfe des in Visual Studio für Mac integrierten automatisierten Migrationstools auf die einheitliche API aktualisiert werden. Möglicherweise sind dann einige zusätzliche Korrekturen erforderlich, wie in diesen Anweisungen und Tipps erläutert.

Xamarin.Mac-Apps

Vorhandene Xamarin.Mac-Apps können mithilfe des in Visual Studio für Mac integrierten automatisierten Migrationstools auf die einheitliche API aktualisiert werden. Möglicherweise sind dann einige zusätzliche Korrekturen erforderlich, wie in diesen Anweisungen und Tipps erläutert.

Xamarin.Forms-Apps

Befolgen Sie diese Anweisungen, um eine vorhandene Xamarin.Forms-Lösung mit einem iOS-Projekt zu aktualisieren, um die Einheitliche API zu verwenden. Unified API-Unterstützung ist nur in Xamarin.Forms 1.3 und höher verfügbar. Daher wird in den Anweisungen auch erläutert, wie Sie Ihre Xamarin.Forms-App auf Version 1.3 aktualisieren. Diese Tipps können helfen, nativen iOS-Code in benutzerdefinierten Renderern oder Abhängigkeitsdiensten zu aktualisieren.

Arbeiten mit nativen Typen in plattformübergreifenden Apps

In diesem Artikel wird die Verwendung der neuen iOS Unified API Native-Typen (nint, nuint, nfloat) in einer plattformübergreifenden Anwendung behandelt, bei der Code für Nicht-iOS-Geräte wie Android oder Windows Phone-Betriebssysteme freigegeben wird. Es bietet Einen Einblick, wann die nativen Typen verwendet werden sollen, und bietet mehrere mögliche Lösungen für Fälle, in denen der neue Typ mit plattformübergreifendem Code verwendet werden muss.

Aktualisieren von Bindungen an die einheitliche API

Kunden, die Bindungen zu Objective-C Bibliotheken erstellt haben, müssen das Bindungsprojekt aktualisieren, um Änderungen in der zugrunde liegenden API widerzuspiegeln (wobei einige Typen jetzt 64-Bit sind). Befolgen Sie diese Anweisungen, um ein vorhandenes Bindungsprojekt zur Unterstützung der einheitlichen API zu aktualisieren.