Introduzione a Xamarin.Essentials

Xamarin.Essentials fornisce una singola API multipiattaforma che funziona con qualsiasi applicazione iOS, Android o UWP a cui è possibile accedere dal codice condiviso indipendentemente dal modo in cui viene creata l'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 i passaggi seguenti.

  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. Cercare Xamarin.Essentials e installare il pacchetto in tutti i progetti, incluse le 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 una configurazione specifica della piattaforma:

    Xamarin.Essentials supporta una versione minima di Android di 4,4, corrispondente al livello API 19, ma la versione di Android di destinazione per la compilazione deve essere 9,0 o 10,0, corrispondente al livello API 28 e a livello 29. In Visual Studio queste due versioni sono impostate nella finestra di dialogo delle proprietà del progetto per il progetto Android, nella scheda Manifesto Android. In Visual Studio per Mac sono impostati nella finestra di dialogo Opzioni progetto per il progetto Android, nella scheda applicazione Android.

    Quando si esegue la compilazione in Android 9,0, Xamarin.Essentials installa la versione 28.0.0.3 delle librerie Novell. Android. Support necessarie. Tutte le altre librerie di Novell. Android. support richieste dall'applicazione devono essere aggiornate anche alla versione 28.0.0.3 usando Gestione pacchetti NuGet. Tutte le librerie Novell. Android. support utilizzate dall'applicazione devono essere uguali e devono essere almeno la versione 28.0.0.3. Se si verificano problemi durante l'aggiunta di NuGet o l'aggiornamento di NuGet nella soluzione, vedere la pagina relativa alla risoluzione dei problemi Xamarin.Essentials .

    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 la transizione non è ancora stata eseguita.

    Nel progetto Android o in MainLauncher qualsiasi Activity che viene avviato, Xamarin.Essentials deve 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 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 ciascuna funzionalità.

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

Risorse aggiuntive

Si consiglia agli sviluppatori nuovi di Novell di visitare la Guida introduttiva allo sviluppo di Novell.

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

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