Začínáme sXamarin.Essentials

  • Článek
  • 2 min ke čtení

Xamarin.Essentials poskytuje jedno rozhraní API pro více platforem, které funguje s libovolnou aplikací pro iOS, Android nebo UPW, ke které je možné 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 funkcí platformy.

Instalace

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

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

  2. Otevřete existující projekt nebo vytvořte nový projekt pomocí šablony Prázdná aplikace v části Visual Studio C# (Android, iPhone iPad nebo pro více platforem).

    Důležité

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

  3. Do každého projektu přidejte balíček /" data-linktype="external">NuGet Xamarin.Essentials Xamarin.Essentials /":

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

  4. Přidejte odkaz na v Xamarin.Essentials jakékoli třídě jazyka C# pro odkaz na rozhraní API.

    using Xamarin.Essentials;

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

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

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

    Počínaje verzí 1.5.0 při kompilaci v androidu 10.0 nainstalujte knihovny podpory Xamarin.Essentials AndroidX, které vyžaduje. Pokud jste ještě převod nepoučili, přečtěte si dokumentaci k AndroidX.

    V projektu Pro Android nebo v MainLauncherActivity projektu, který je spuštěn, Xamarin.Essentials 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
    //...

    Pokud chcete v Androidu zpracovávat oprávnění modulu runtime, Xamarin.Essentials musí přijmout všechny OnRequestPermissionsResult . Do všech tříd přidejte následující Activity 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. Postupujte podle Xamarin.Essentials guides , které vám umožní kopírovat a vkládat fragmenty kódu pro jednotlivé funkce.

Xamarin.Essentials – Rozhraní API pro více platforem pro Mobile Apps (video)

Další prostředky

Doporučujeme vývojářům, kteří s Xamarinem začíná, navštívit stránku Začínáme s vývojem pro Xamarin.

Přejděte na Xamarin.Essentials GitHub Repository a podívejte se na aktuální zdrojový kód, co se bude chykat dál, spusťte ukázky a naklonování úložiště. Community příspěvky jsou vítané!

Projděte si dokumentaci k rozhraní API pro všechny funkce .