Erste Schritte mit Xamarin.Essentials

Xamarin.Essentials stellt eine einzelne plattformübergreifende API bereit, die mit jeder iOS-, Android- und UWP-Anwendung kompatibel ist, auf die über freigegebenen Code zugegriffen werden kann, unabhängig davon, wie die Benutzeroberfläche erstellt wird. Weitere Informationen zu unterstützten Betriebssystemen finden Sie im Leitfaden zur Plattform- und Featureunterstützung.

Installation

Xamarin.Essentials ist als NuGet-Paket verfügbar und in jedem neuen Projekt in Visual Studio enthalten. Es kann auch jedem vorhandenen Projekt mittels Visual Studio und den folgenden Schritten hinzugefügt werden.

  1. Laden Sie Visual Studio mit den Visual Studio-Tools für Xamarin herunter, und installieren Sie die Suite.

  2. Öffnen Sie ein vorhandenes Projekt, oder erstellen Sie ein neues Projekt mit der Vorlage „Leere App“ unter Visual Studio C# (Android, iPhone & iPad oder plattformübergreifend).

    Wichtig

    Überprüfen Sie beim Hinzufügen zu einem UWP-Projekt, ob Build 16299 oder höher in den Projekteigenschaften festgelegt ist.

  3. Fügen Sie jedem Projekt das NuGet-Paket Xamarin.Essentials hinzu:

    Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen der Projektmappe, und wählen Sie NuGet-Pakete aus. Suchen Sie nach Xamarin.Essentials, und installieren Sie das Paket in ALLEN Projekten, einschließlich der Android-, iOS-, UWP- und .NET Standard-Bibliotheken.

  4. Fügen Sie in jeder C#-Klasse einen Verweis auf Xamarin.Essentials als Referenz auf die APIs hinzu.

    using Xamarin.Essentials;
    
  5. Xamarin.Essentials erfordert ein plattformspezifisches Setup:

    Xamarin.Essentials unterstützt die Android-Mindestversion 4.4, d. h. API-Ebene 19, doch die Android-Zielversion für die Kompilierung muss 9.0 oder 10.0 entsprechen, d. h. API-Ebene 28 und 29. In Visual Studio werden diese beiden Versionen auf der Registerkarte „Android-Manifest“ im Dialogfeld „Projekteigenschaften“ für das Android-Projekt festgelegt. In Visual Studio für Mac werden sie auf der Registerkarte „Android-Anwendung“ im Dialogfeld „Projektoptionen“ für das Android-Projekt eingerichtet.

    Während der Kompilierung für Android 9.0 installiert Xamarin.Essentials Version 28.0.0.3 der erforderlichen Xamarin.Android.Support-Bibliotheken. Alle anderen Xamarin.Android.Support-Bibliotheken, die Ihre Anwendung benötigt, sollten ebenfalls mit dem NuGet-Paket-Manager auf Version 28.0.0.3 aktualisiert werden. Alle von Ihrer Anwendung verwendeten Xamarin.Android.Support-Bibliotheken sollten gleich sein und mindestens die Version 28.0.0.3 haben. Wenn Sie Probleme beim Hinzufügen des Xamarin.Essentials-NuGet-Pakets oder beim Aktualisieren von NuGet-Paketen in Ihrer Projektmappe haben, lesen Sie die Informationen zur Problembehandlung.

    Ab Version 1.5.0 installiert Xamarin.Essentials bei der Kompilierung für Android 10.0 die erforderlichen AndroidX-Unterstützungsbibliotheken. Lesen Sie die AndroidX-Dokumentation, wenn Sie den Übergang noch nicht durchgeführt haben.

    Im MainLauncher-Element oder in einem beliebigen Activity-Element des Android-Projekts, das gestartet wird, muss Xamarin.Essentials in der OnCreate-Methode initialisiert werden:

    protected override void OnCreate(Bundle savedInstanceState) {
        //...
        base.OnCreate(savedInstanceState);
        Xamarin.Essentials.Platform.Init(this, savedInstanceState); // add this line to your code, it may also be called: bundle
        //...
    

    Um Laufzeitberechtigungen unter Android zu verwalten, muss Xamarin.Essentials ein beliebiges OnRequestPermissionsResult-Element erhalten. Fügen Sie allen Activity-Klassen den folgenden Code hinzu:

    public override void OnRequestPermissionsResult(int requestCode, string[] permissions, Android.Content.PM.Permission[] grantResults)
    {
        Xamarin.Essentials.Platform.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    
        base.OnRequestPermissionsResult(requestCode, permissions, grantResults);
    }
    
  6. Befolgen Sie die Xamarin.Essentials-Anleitungen, mit denen Sie Codeausschnitte für jedes Feature kopieren und einfügen können.

Xamarin.Essentials: Plattformübergreifende APIs für Mobile Apps (Video)

Weitere Ressourcen

Noch nicht mit Xamarin vertrauten Entwicklern wird empfohlen, Erste Schritte mit der Xamarin-Entwicklung zu besuchen.

Im GitHub-Repository für Xamarin.Essentials finden Sie den aktuellen Quellcode sowie Ankündigungen und erfahren, wie Sie Beispiele ausführen und das Repository klonen. Wir freuen uns über Beiträge aus der Community.

In der API-Dokumentation finden Sie weitere Informationen zu allen Funktionen von Xamarin.Essentials.