Wprowadzenie do usługi Xamarin.Essentials

  • Artykuł

Xamarin.Essentials Udostępnia jeden międzyplatformowy interfejs API, który współdziała z dowolną aplikacją systemu iOS, Android lub platformy UNIWERSALNEJ systemu Windows, do której można uzyskać dostęp z kodu udostępnionego niezależnie od sposobu tworzenia interfejsu użytkownika. Aby uzyskać więcej informacji na temat obsługiwanych systemów operacyjnych, zobacz przewodnik obsługi platformy i funkcji.

Instalacja

Xamarin.Essentials jest dostępny jako pakiet NuGet i jest dołączany do każdego nowego projektu w programie Visual Studio. Można go również dodać do dowolnych istniejących projektów przy użyciu programu Visual Studio, wykonując następujące kroki.

  1. Pobierz i zainstaluj program Visual Studio przy użyciu narzędzi Visual Studio dla platformy Xamarin.

  2. Otwórz istniejący projekt lub utwórz nowy projekt przy użyciu szablonu Pusta aplikacja w programie Visual Studio C# (Android, i Telefon iPad lub międzyplatformowym).

    Ważne

    W przypadku dodawania do projektu platformy UWP upewnij się, że kompilacja 16299 lub nowsza jest ustawiona we właściwościach projektu.

  3. Xamarin.Essentials Dodaj pakiet NuGet do każdego projektu:

    Na panelu Eksplorator rozwiązań kliknij prawym przyciskiem myszy nazwę rozwiązania i wybierz pozycję Zarządzaj pakietami NuGet. Xamarin.Essentials Wyszukaj i zainstaluj pakiet we wszystkich projektach, w tym w bibliotekach Android, iOS, UWP i .NET Standard.

  4. Dodaj odwołanie do Xamarin.Essentials w dowolnej klasie języka C#, aby odwołać się do interfejsów API.

    using Xamarin.Essentials;

  5. Xamarin.Essentials wymaga konfiguracji specyficznej dla platformy:

    Xamarin.Essentials obsługuje minimalną wersję systemu Android 4.4 odpowiadającą poziomowi interfejsu API 19, ale docelowa wersja systemu Android do kompilowania musi być 9.0 lub 10.0, co odpowiada poziomowi interfejsu API 28 i poziomowi 29. (W programie Visual Studio te dwie wersje są ustawiane w oknie dialogowym Właściwości projektu dla systemu Android na karcie Manifest systemu Android. W Visual Studio dla komputerów Mac są one ustawiane w oknie dialogowym Opcje projektu dla systemu Android na karcie Aplikacja systemu Android).

    Podczas kompilowania dla systemu Android 9.0 Xamarin.Essentials instalowana jest wersja 28.0.0.3 bibliotek Xamarin.Android.Support, których wymaga. Wszystkie inne biblioteki platformy Xamarin.Android.Support wymagane przez aplikację powinny być również aktualizowane do wersji 28.0.0.3 przy użyciu menedżera pakietów NuGet. Wszystkie biblioteki Xamarin.Android.Support używane przez aplikację powinny być takie same i powinny mieć co najmniej wersję 28.0.0.3. Zapoznaj się ze stroną rozwiązywania problemów, jeśli masz problemy z dodawaniem Xamarin.Essentials pakietu NuGet lub aktualizowaniem pakietów NuGet w rozwiązaniu.

    Począwszy od wersji 1.5.0 podczas kompilowania w systemie Android 10.0, Xamarin.Essentials zainstaluj wymagane biblioteki obsługi androidX. Zapoznaj się z dokumentacją systemu AndroidX, jeśli nie dokonano jeszcze przejścia.

    W projekcie MainLauncher systemu Android lub dowolnym Activity , który został uruchomiony, Xamarin.Essentials musi zostać zainicjowany w metodzie OnCreate :

    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
    //...

    Aby obsłużyć uprawnienia środowiska uruchomieniowego w systemie Android, Xamarin.Essentials musi otrzymać dowolny OnRequestPermissionsResult. Dodaj następujący kod do wszystkich Activity klas:

    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. Postępuj zgodnie z Xamarin.Essentials przewodnikami, które umożliwiają kopiowanie i wklejanie fragmentów kodu dla każdej funkcji.

Xamarin.Essentials — Międzyplatformowe interfejsy API dla aplikacji mobilnych (wideo)

Inne zasoby

Zalecamy deweloperom nowość w środowisku Xamarin podczas rozpoczynania pracy z programowaniem na platformie Xamarin.

Odwiedź repozytorium Xamarin.Essentials GitHub, aby zobaczyć bieżący kod źródłowy, co będzie dalej, uruchomić przykłady i sklonować repozytorium. Wkład społeczności jest mile widziany!

Przejrzyj dokumentację interfejsu API dla każdej funkcji programu Xamarin.Essentials.