Binden von Android-Kotlin-Bibliotheken

Wichtig

Wir untersuchen derzeit die Nutzung benutzerdefinierter Bindungen auf der Xamarin-Plattform. Nehmen Sie an dieser Umfrage teil, um zukünftige Entwicklungsarbeiten zu unterstützen.

Die Android-Plattform wird zusammen mit den nativen Sprachen und Tools ständig weiterentwickelt, und es gibt eine Vielzahl von Bibliotheken von Drittanbietern, die unter Verwendung der neuesten Angebote entwickelt wurden. Die maximale Wiederverwendung von Code und Komponenten ist eines der wichtigsten Ziele der plattformübergreifenden Entwicklung. Die Möglichkeit zur Wiederverwendung von Komponenten, die mit Kotlin erstellt wurden, ist für Xamarin-Entwickler immer wichtiger geworden, da deren Beliebtheit bei Entwicklern weiterhin zunimmt. Möglicherweise sind Sie bereits mit dem Binden regulärer Java-Bibliotheken vertraut. Jetzt ist eine weitere Dokumentation verfügbar, in der das Binden einer Kotlin-Bibliothek beschrieben wird, damit die Bibliothek von einer Xamarin-Anwendung wie üblich genutzt werden kann. Der Zweck dieses Dokuments besteht darin, eine übergeordnete Vorgehensweise zum Erstellen einer Kotlin-Bindung für Xamarin zu beschreiben.

Übergeordnete Vorgehensweise

Mit Xamarin können Sie eine beliebige native Bibliothek von Drittanbietern binden, sodass sie von einer X-Anwendung verwendet werden kann. Kotlin ist die neue Sprache und zum Erstellen einer Bindung für Bibliotheken, die mit dieser Sprache erstellt wurden, sind einige zusätzliche Schritte und Tools erforderlich. Diese Vorgehensweise umfasst die folgenden vier Schritte:

  1. Erstellen der nativen Bibliothek
  2. Vorbereiten der Xamarin-Metadaten, damit die Xamarin-Tools C#-Klassen generieren können
  3. Erstellen einer Xamarin-Bindungsbibliothek unter Verwendung der nativen Bibliothek und der Metadaten
  4. Verwenden der Xamarin-Bindungsbibliothek in einer Xamarin-Anwendung

In den folgenden Abschnitten werden diese Schritte mit weiteren Details erläutert.

Erstellen der nativen Bibliothek

Der erste Schritt besteht darin, eine native Kotlin-Bibliothek (AAR-Paket, ein Android-Archiv) zu erhalten. Sie können sie direkt von einem Anbieter anfordern oder selbst erstellen.

Vorbereiten der Xamarin-Metadaten

Der zweite Schritt besteht darin, die Metadatentransformationsdatei vorzubereiten, die von den Xamarin-Tools verwendet wird, um die jeweiligen C#-Klassen zu generieren. Im besten Fall ist diese Datei leer, d. h. alle Klassen werden von den Xamarin-Tools erkannt und generiert. In einigen Fällen muss die Metadatentransformation angewendet werden, um den richtigen und/oder gewünschten C# -Code zu generieren. In vielen Fällen muss ein AAR-Disassembler, z. B. Java Decompiler (JD), verwendet werden, um verborgene Abhängigkeiten und unerwünschte Klassen zu ermitteln, die aus der endgültigen Liste der zu generierenden C#-Klassen ausgeschlossen werden sollen. Die endgültigen Metadaten müssen die öffentliche Schnittstelle darstellen, mit der die verweisende Xamarin.Android-Anwendung interagiert.

Erstellen einer Xamarin.Android-Bindungsbibliothek

Der dritte Schritt besteht darin, ein spezielles Projekt zu erstellen: eine Xamarin.Android-Bindungsbibliothek. Diese enthält die-Kotlin-Bibliotheken als native Verweise und die Metadatentransformation, die im vorherigen Schritt definiert wurde. Beim Schreiben ist für jedes referenzierte AAR-Paket ein separates Android-Bindungsbibliothekprojekt erforderlich. Die Bindungsbibliothek muss das Xamarin.Kotlin.StdLib-Paket hinzufügen, damit die Kotlin-Standardbibliothek unterstützt wird.

Verwenden der Xamarin-Bindungsbibliothek

Der vierte und letzte Schritt besteht darin, in einer Xamarin.Android-Anwendung auf die Bindungsbibliothek zu verweisen. Durch das Hinzufügen eines Verweises auf die Xamarin.Android-Bindungsbibliothek kann die Xamarin-Anwendung die verfügbar gemachten Kotlin-Klassen im betreffenden Paket verwenden.

Exemplarische Vorgehensweise

Die obige Vorgehensweise beschreibt die übergeordneten Schritte, die zum Erstellen einer Kotlin-Bindung für Xamarin erforderlich sind. Es gibt viele untergeordnete Schritte und weitere Details, die beim Vorbereiten dieser Bindungen in der Praxis berücksichtigt werden müssen, z. B. die Anpassung an Änderungen in den nativen Tools und Sprachen. Das Ziel besteht darin, Ihnen ein besseres Verständnis dieses Konzepts und der übergeordneten Schritte in diesem Prozess zu ermöglichen. Eine ausführliche Schritt-für-Schritt-Anleitung finden Sie in der Dokumentation Exemplarische Vorgehensweise: Xamarin-Kotlin-Bindung.