Erste Schritte mit Xamarin.EssentialsGet Started with 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.Xamarin.Essentials provides a single cross-platform API that works with any iOS, Android, or UWP application that can be accessed from shared code no matter how the user interface is created. Weitere Informationen zu unterstützten Betriebssystemen finden Sie im Leitfaden zur Plattform- und Featureunterstützung.See the platform & feature support guide for more information on supported operating systems.

InstallationInstallation

Xamarin.Essentials ist als NuGet-Paket verfügbar und in jedem neuen Projekt in Visual Studio enthalten.Xamarin.Essentials is available as a NuGet package and is included in every new project in Visual Studio. Es kann auch jedem vorhandenen Projekt mittels Visual Studio und den folgenden Schritten hinzugefügt werden.It can also be added to any existing using Visual Studio with the follow steps.

  1. Laden Sie Visual Studio mit den Visual Studio-Tools für Xamarin herunter, und installieren Sie die Suite.Download and install Visual Studio with the Visual Studio tools for Xamarin.

  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).Open an existing project, or create a new project using the Blank App template under Visual Studio C# (Android, iPhone & iPad, or Cross-Platform).

    Wichtig

    Überprüfen Sie beim Hinzufügen zu einem UWP-Projekt, ob Build 16299 oder höher in den Projekteigenschaften festgelegt ist.If adding to a UWP project ensure Build 16299 or higher is set in the project properties.

  3. Fügen Sie das NuGet-Paket Xamarin.Essentials jedem Projekt hinzu:Add the Xamarin.Essentials NuGet package to each project:

    Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Namen der Projektmappe, und wählen Sie NuGet-Pakete aus.In the Solution Explorer panel, right click on the solution name and select Manage NuGet Packages. Suchen Sie nach Xamarin.Essentials, und installieren Sie das Paket in ALLEN Projekten, einschließlich der Android-, iOS-, UWP- und .NET-Standardbibliotheken.Search for Xamarin.Essentials and install the package into ALL projects including Android, iOS, UWP, and .NET Standard libraries.

  4. Fügen Sie in jeder C#-Klasse einen Verweis auf Xamarin.Essentials als Referenz auf die APIs hinzu.Add a reference to Xamarin.Essentials in any C# class to reference the APIs.

    using Xamarin.Essentials;
    
  5. Xamarin.Essentials erfordert ein plattformspezifisches Setup:Xamarin.Essentials requires platform-specific 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.Xamarin.Essentials supports a minimum Android version of 4.4, corresponding to API level 19, but the target Android version for compiling must be 9.0 or 10.0, corresponding to API level 28 and level 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.(In Visual Studio, these two versions are set in the Project Properties dialog for the Android project, in the Android Manifest tab. In Visual Studio for Mac, they're set in the Project Options dialog for the Android project, in the Android Application tab.)

    Während der Kompilierung für Android 9.0 installiert Xamarin.Essentials die benötigte Version 28.0.0.3 der Xamarin.Android.Support-Bibliotheken.When compiling against Android 9.0, Xamarin.Essentials installs version 28.0.0.3 of the Xamarin.Android.Support libraries that it requires. 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.Any other Xamarin.Android.Support libraries that your application requires should also be updated to version 28.0.0.3 using the NuGet package manager. Alle von Ihrer Anwendung verwendeten Xamarin.Android.Support-Bibliotheken sollten gleich sein und mindestens die Version 28.0.0.3 haben.All Xamarin.Android.Support libraries used by your application should be the same, and should be at least version 28.0.0.3. Wenn Sie Probleme beim Hinzufügen des Xamarin.Essentials-NuGets oder beim Aktualisieren von NuGet-Paketen in Ihrer Projektmappe haben, lesen Sie Problembehandlung.Refer to the troubleshooting page if you have issues adding the Xamarin.Essentials NuGet or updating NuGets in your solution.

    Ab Version 1.5.0 installiert Xamarin.Essentials bei der Kompilierung für Android 10.0 die erforderlichen AndroidX-Unterstützungsbibliotheken.Starting with version 1.5.0 when compiling against Android 10.0, Xamarin.Essentials install AndroidX support libraries that it requires. Lesen Sie die AndroidX-Dokumentation, wenn Sie den Übergang noch nicht durchgeführt haben.Read through the AndroidX documentation if you have not made the transition yet.

    Im MainLauncher-Element oder in einem beliebigen Activity-Element des Android-Projekts, das gestartet wird, muss Xamarin.Essentials in der OnCreate-Methode initialisiert werden:In the Android project's MainLauncher or any Activity that is launched, Xamarin.Essentials must be initialized in the OnCreate method:

    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 auf Android zu verwalten, muss Xamarin.Essentials OnRequestPermissionsResult erhalten.To handle runtime permissions on Android, Xamarin.Essentials must receive any OnRequestPermissionsResult. Fügen Sie allen Activity-Klassen den folgenden Code hinzu:Add the following code to all Activity classes:

    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.Follow the Xamarin.Essentials guides that enable you to copy and paste code snippets for each feature.

Xamarin.Essentials – plattformübergreifende APIs für Mobile Apps (Video)Xamarin.Essentials - Cross-Platform APIs for Mobile Apps (video)

Weitere RessourcenOther Resources

Noch nicht mit Xamarin vertrauten Entwicklern wird empfohlen, Erste Schritte mit der Xamarin-Entwicklung zu besuchen.We recommend developers new to Xamarin visit getting started with Xamarin development.

Im Xamarin.Essentials-GitHub-Repository finden Sie den aktuellen Quellcode sowie Ankündigungen und erfahren, wie Sie Beispiele ausführen und das Repository klonen.Visit the Xamarin.Essentials GitHub Repository to see the current source code, what is coming next, run samples, and clone the repository. Wir freuen uns über Beiträge aus der Community.Community contributions are welcome!

In der API-Dokumentation finden Sie weitere Informationen zu allen Funktionen von Xamarin.Essentials.Browse through the API documentation for every feature of Xamarin.Essentials.