Začínáme s Xamarin.Essentials

Xamarin.Essentials poskytuje jedno multiplatformní rozhraní API, které funguje s libovolnou aplikací pro iOS, Android nebo UPW, ke kterým se dá přistupovat ze sdíleného kódu bez ohledu na to, jak se uživatelské rozhraní vytvoří. Další informace o podporovaných operačních systémech najdete v průvodci podporou platformy a funkcí.

Instalace

Xamarin.Essentials je k dispozici jako balíček NuGet a je součástí každého nového projektu v sadě Visual Studio. Můžete ho také přidat do všech existujících projektů pomocí sady Visual Studio pomocí následujícího postupu.

  1. Stáhněte a nainstalujte Sadu Visual Studio pomocí nástrojů sady Visual Studio pro Xamarin.

  2. Otevřete existující projekt nebo vytvořte nový projekt pomocí šablony Prázdná aplikace v sadě Visual Studio C# (Android, i Telefon & iPad nebo multiplatformní).

    Důležité

    Pokud přidáváte projekt UPW, ujistěte se, že je ve vlastnostech projektu nastaven build 16299 nebo vyšší.

  3. Xamarin.Essentials Přidejte balíček NuGet do každého projektu:

    Na panelu Průzkumník řešení klikněte pravým tlačítkem na název řešení a vyberte Spravovat balíčky NuGet. Xamarin.Essentials Vyhledejte a nainstalujte balíček do všech projektů, včetně knihoven Android, iOS, UPW a .NET Standard.

  4. Přidejte do libovolné třídy jazyka C# odkaz Xamarin.Essentials na rozhraní API.

    using Xamarin.Essentials;
    
  5. Xamarin.Essentials vyžaduje nastavení specifické pro platformu:

    Xamarin.Essentials podporuje minimální verzi Androidu 4.4 odpovídající úrovni rozhraní API 19, ale cílová verze Androidu pro kompilaci musí být 9.0 nebo 10.0 odpovídající úrovni rozhraní API 28 a úrovni 29. (V sadě Visual Studio jsou tyto dvě verze nastaveny v dialogovém okně Vlastnosti projektu pro Android na kartě Manifest androidu. V Visual Studio pro Mac jsou nastavené v dialogovém okně Možnosti projektu pro Android na kartě Aplikace pro Android.)

    Při kompilaci proti Androidu 9.0 Xamarin.Essentials se nainstaluje verze 28.0.0.3 knihoven Xamarin.Android.Support, které vyžaduje. Všechny ostatní knihovny Xamarin.Android.Support, které vaše aplikace vyžaduje, by se také měly aktualizovat na verzi 28.0.0.3 pomocí správce balíčků NuGet. Všechny knihovny Xamarin.Android.Support používané vaší aplikací by měly být stejné a měly by mít alespoň verzi 28.0.0.3. Pokud máte problémy s přidáním NuGetu Xamarin.Essentials nebo aktualizací nuGetů ve vašem řešení, projděte si stránku pro řešení potíží.

    Počínaje verzí 1.5.0 při kompilaci pro Android 10.0 nainstalujte knihovny podpory AndroidX, Xamarin.Essentials které vyžaduje. Pokud jste přechod ještě neprošli, přečtěte si dokumentaci k AndroidX.

    V projektu Androidu nebo v libovolném Activity spuštěného Xamarin.Essentials projektu MainLauncher musí být inicializován v OnCreate metodě:

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

    Chcete-li zpracovávat oprávnění modulu runtime v Androidu, Xamarin.Essentials musí přijmout všechny OnRequestPermissionsResult. Do všech Activity tříd přidejte následující kód:

    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. Xamarin.Essentials Postupujte podle pokynů, které umožňují kopírovat a vkládat fragmenty kódu pro každou funkci.

Xamarin.Essentials – Multiplatformní rozhraní API pro Mobile Apps (video)

Další prostředky

Doporučujeme vývojářům, kteří s Xamarinem začínají vývojem v Xamarinu.

Navštivte úložiště GitHub a Xamarin.Essentials podívejte se na aktuální zdrojový kód, co se chystá dál, spustí ukázky a naklonuje úložiště. Příspěvky komunity jsou vítány!

Projděte si dokumentaci k rozhraní API pro každou funkci Xamarin.Essentials.