Introduzione Xamarin.Essentials

  • Articolo

Xamarin.Essentials fornisce una singola API multipiattaforma che funziona con qualsiasi applicazione iOS, Android o UWP accessibile da codice condiviso indipendentemente dalla modalità di creazione dell'interfaccia utente. Per altre informazioni sui sistemi operativi supportati, vedere la guida al supporto delle piattaforme e delle funzionalità.

Installazione

Xamarin.Essentials è disponibile come pacchetto NuGet ed è incluso in ogni nuovo progetto in Visual Studio. Può anche essere aggiunto a qualsiasi progetto esistente usando Visual Studio con la procedura seguente.

  1. Scaricare e installare Visual Studio con Visual Studio Tools per Xamarin.

  2. Aprire un progetto esistente o creare un nuovo progetto usando il modello Applicazione vuota in Visual Studio C# (Android, iPhone e iPad o multipiattaforma).

    Importante

    in caso di aggiunta a un progetto della piattaforma UWP assicurarsi che nelle proprietà del progetto sia impostata la build 16299 o versione successiva.

  3. Aggiungere il Xamarin.Essentials pacchetto NuGet a ogni progetto:

    Nel pannello Esplora soluzioni fare clic con il pulsante destro del mouse sul nome della soluzione e scegliere Gestisci pacchetti NuGet. Xamarin.Essentials Cercare e installare il pacchetto in tutti i progetti, tra cui librerie Android, iOS, UWP e .NET Standard.

  4. Aggiungere un riferimento a Xamarin.Essentials in qualsiasi classe C# per fare riferimento alle API.

    using Xamarin.Essentials;

  5. Xamarin.Essentials richiede la configurazione specifica della piattaforma:

    Xamarin.Essentials supporta una versione minima di Android 4.4, corrispondente al livello API 19, ma la versione android di destinazione per la compilazione deve essere 9.0 o 10.0, corrispondente al livello API 28 e livello 29. In Visual Studio queste due versioni vengono impostate nella finestra di dialogo Proprietà progetto per il progetto Android, nella scheda Manifesto Android. In Visual Studio per Mac vengono impostati nella finestra di dialogo Opzioni progetto per il progetto Android, nella scheda Applicazione Android.

    Durante la compilazione in Android 9.0, Xamarin.Essentials installa la versione 28.0.0.3 delle librerie Xamarin.Android.Support necessarie. Anche qualsiasi altra libreria Xamarin.Android.Support richiesta dall'applicazione deve essere aggiornata alla versione 28.0.0.3 usando Gestione pacchetti NuGet. Tutte le librerie Xamarin.Android.Support usate dall'applicazione devono essere uguali e con la versione 28.0.0.3 o successive. Fare riferimento alla pagina di risoluzione dei problemi se si verificano problemi durante l'aggiunta di NuGet o l'aggiornamento Xamarin.Essentials di NuGet nella soluzione.

    A partire dalla versione 1.5.0 durante la compilazione in Android 10.0, Xamarin.Essentials installare le librerie di supporto AndroidX necessarie. Leggere la documentazione di AndroidX se non è ancora stata eseguita la transizione.

    Nel progetto MainLauncher Android o in quello Activity avviato deve Xamarin.Essentials essere inizializzato nel OnCreate metodo :

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

    Per gestire le autorizzazioni di runtime in Android, Xamarin.Essentials deve ricevere qualsiasi OnRequestPermissionsResult. Aggiungere il codice seguente a tutte le classi Activity:

    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. Seguire le Xamarin.Essentials guide che consentono di copiare e incollare frammenti di codice per ogni funzionalità.

Xamarin.Essentials - API multipiattaforma per le app per dispositivi mobili (video)

Risorse aggiuntive

Si consiglia agli sviluppatori che non hanno familiarità con Xamarin di leggere l'introduzione allo sviluppo con Xamarin.

Visitare il Xamarin.Essentials repository GitHub per visualizzare il codice sorgente corrente, i prossimi esempi, eseguire esempi e clonare il repository. I contributi della community sono benvenuti.

Esplorare la documentazione dell'API per ogni funzionalità di Xamarin.Essentials.