Binden eines Eclipse-Bibliotheksprojekts

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.

In dieser exemplarischen Vorgehensweise wird erläutert, wie Sie mit Xamarin.Android-Projektvorlagen ein Eclipse-Android-Bibliotheksprojekt binden.

Übersicht

Obwohl AAR-Dateien zunehmend zur Normalfall für die Verteilung von Android-Bibliotheken werden, ist es in einigen Fällen erforderlich, eine Bindung für ein Android-Bibliotheksprojekt zu erstellen. Android-Bibliotheksprojekte sind spezielle Android-Projekte, die freigabefähigen Code und Ressourcen enthalten, auf die von Android-Anwendungsprojekten verwiesen werden kann. In der Regel binden Sie ein Android-Bibliotheksprojekt, wenn die Bibliothek in der Eclipse-IDE erstellt wird. Diese exemplarische Vorgehensweise enthält Beispiele zum Erstellen einer ZIP-Datei für das Android-Bibliotheksprojekt aus der Verzeichnisstruktur eines Eclipse-Projekts.

Android-Bibliotheksprojekte unterscheiden sich insofern von regulären Android-Projekten, als dass sie nicht in ein APK kompiliert werden und nicht eigenständig auf einem Gerät bereitgestellt werden können. Stattdessen soll ein Android-Anwendungsprojekt auf ein Android-Bibliotheksprojekt verweisen. Wenn ein Android-Anwendungsprojekt erstellt wird, wird zuerst das Android-Bibliotheksprojekt kompiliert. Das Android-Anwendungsprojekt wird dann in das kompilierte Android-Bibliotheksprojekt aufgenommen und bezieht den Code und die Ressourcen in das APK für die Verteilung ein. Aufgrund dieses Unterschieds weicht das Erstellen einer Bindung für ein Android-Bibliotheksprojekt geringfügig vom Erstellen einer Bindung für eine JAR- oder AAR-Java-Datei ab.

Exemplarische Vorgehensweise

Wenn Sie ein Android-Bibliotheksprojekt in einem Xamarin.Android-Java-Bindungsprojekt verwenden möchten, muss zunächst das Android-Bibliotheksprojekt in Eclipse erstellt werden. Der folgende Screenshot zeigt ein Beispiel für ein Android-Bibliotheksprojekt nach der Kompilierung:

Beachten Sie, dass der Quellcode aus dem Android-Bibliotheksprojekt in eine temporäre Die JAR-Datei namens android-mapviewballoons.jar kompiliert wurde und die Ressourcen in den Ordner bin/res/crunch kopiert wurden.

Nachdem das Android-Bibliotheksprojekt in Eclipse kompiliert wurde, kann es mit einem Xamarin.Android-Java-Bindungsprojekt gebunden werden. Zuerst muss eine ZIP-Datei erstellt werden, die die Ordner bin und res des Android-Bibliotheksprojekts enthält. Sie müssen unbedingt das Unterverzeichnis crunch dazwischen entfernen, damit sich die Ressourcen in bin/res befinden. Der folgende Screenshot zeigt den Inhalt eines solchen ZIP-Datei:

Diese ZIP-Datei wird dann wie im folgenden Screenshot gezeigt zum Xamarin.Android-Java-Bindungsprojekt hinzugefügt:

Beachten Sie, dass der Buildvorgang der ZIP-Datei automatisch auf LibraryProjectZip festgelegt wurde.

Wenn JAR-Dateien für das Android-Bibliotheksprojekt erforderlich sind, müssen sie zum Ordner Jars des Java-Bindungsbibliothekprojekts hinzugefügt werden, und der Buildvorgang muss auf ReferenceJar festgelegt werden. Ein entsprechendes Beispiel finden Sie im folgenden Screenshot:

Nachdem diese Schritte ausgeführt wurden, kann das Xamarin.Android-Java-Bindungsprojekt wie weiter oben in diesem Dokument beschrieben verwendet werden.

Hinweis

Das Kompilieren von Android-Bibliotheksprojekten in anderen IDEs wird zurzeit nicht unterstützt. Andere IDEs erstellen u. U. nicht die gleiche Verzeichnisstruktur oder die gleichen Dateien im Ordner bin wie Eclipse.

Zusammenfassung

In diesem Artikel wurde die Bindung eines Android-Bibliotheksprojekts in einer exemplarischen Vorgehensweise erläutert. Das Android-Bibliotheksprojekt wurde in Eclipse erstellt. Anschließend wurde eine ZIP-Datei aus den Ordnern bin und res des Android-Bibliotheksprojekts erstellt. Als nächstes wurde diese ZIP-Datei zum Erstellen eines Xamarin.Android-Java-Bindungsprojekts verwendet.