Xamarin.Forms Esercitazione sul ciclo di vita dell'app

Articolo
Developer (Principiante)
8 minuti per il completamento

Prima di provare questa esercitazione è necessario avere completato correttamente:

Creare la prima Xamarin.Forms guida introduttiva all'app .
Esercitazione su StackLayout.
Esercitazione su Entry.

In questa esercitazione apprenderai a:

Rispondere a un'applicazione in fase di avvio, sospensione o ripristino.
Rendere permanenti i dati fra le modifiche di stato del ciclo di vita.

Si userà Visual Studio 2019 o Visual Studio per Mac per creare un'applicazione semplice che dimostri come rendere persistenti i dati tra le modifiche dello stato del ciclo di vita. Gli screenshot seguenti illustrano l'applicazione finale:

Rispondere alle modifiche apportate dello stato del ciclo di vita

7 minuti rimanenti

Visual Studio
Visual Studio per Mac

Per completare questa esercitazione è necessario Visual Studio 2019 (la versione più recente) con installato il carico di lavoro Sviluppo di applicazioni per dispositivi mobili con .NET. È inoltre necessario un Mac associato per compilare l'applicazione dell'esercitazione per iOS. Per informazioni sull'installazione della piattaforma Xamarin, vedere Installazione di Xamarin. Per informazioni sulla connessione di Visual Studio 2019 a un host di compilazione Mac, vedere Associa a Mac per lo sviluppo di Xamarin.iOS.

Avviare Visual Studio e creare una nuova app vuota Xamarin.Forms denominata AppLifecycleTutorial.

Importante

I frammenti di codice C# e XAML in questa esercitazione richiedono che la soluzione sia denominata AppLifecycleTutorial. Se si usa un nome diverso, si verificheranno errori di compilazione quando si copia il codice da questa esercitazione alla soluzione.

Per altre informazioni sulla libreria .NET Standard che viene creata, vedere Anatomia di un'applicazioneXamarin.Forms nell'approfondimento della Xamarin.Forms guida introduttiva.
In Esplora soluzioni, nel progetto AppLifecycleTutorial, espandere App.xaml e fare doppio clic su App.xaml.cs per aprirlo. In App.xaml.cs aggiornare quindi gli override OnStart, OnSleep e OnResume come indicato di seguito:
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

protected override void OnSleep()
{
    Console.WriteLine("OnSleep");
}

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Questo codice aggiorna gli override dei metodi del ciclo di vita dell'applicazione, con istruzioni Console.WriteLine che indicano quando è stato richiamato ogni metodo:
- Il metodo OnStart viene richiamato all'avvio dell'applicazione.
- Il metodo OnSleep viene richiamato quando l'applicazione passa in background.
- Il metodo OnResume viene richiamato alla ripresa dell'applicazione dal background.
Nota

Non è disponibile alcun metodo per la terminazione dell'applicazione. In circostanze normali, la terminazione dell'applicazione verrà eseguita dal metodo OnSleep.
Nella barra degli strumenti di Visual Studio premere il pulsante Avvia, ovvero il pulsante a forma di triangolo simile a un pulsante di riproduzione, per avviare l'applicazione all'interno del simulatore iOS remoto o dell'emulatore Android prescelto. All'avvio dell'applicazione viene richiamato il metodo OnStart e viene restituito OnStart come output nella finestra Output di Visual Studio:
```
[Mono] Found as 'java_interop_jnienv_get_object_array_element'.
OnStart
[OpenGLRenderer] HWUI GL Pipeline
```
Quando l'applicazione passa in background (toccando il pulsante Home in iOS o Android), viene richiamato il metodo OnSleep:
```
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
OnSleep
[Mono] Image addref System.Runtime.Serialization[0x83ee19c0] -> System.Runtime.Serialization.dll[0x83f57b00]: 2
```
Alla ripresa dell'applicazione (toccare l'icona dell'applicazione in iOS, toccare il pulsante Panoramica in Android e selezionare l'applicazione AppLifecycleTutorial), viene richiamato il metodo OnResume:
```
Thread finished: <Thread Pool> #5
OnResume
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
```
Nota

Questi blocchi di codice mostrano l'output di esempio quando si esegue l'applicazione in Android.

In Visual Studio arrestare l'applicazione.

Per altre informazioni sul ciclo di vita dell'app Xamarin.Forms , vedere Xamarin.Forms Ciclo di vita dell'app.

Per completare questa esercitazione è necessario Visual Studio per Mac, la versione più recente, con installato il supporto della piattaforma Android e iOS. Sarà necessario anche Xcode, la versione più recente. Per altre informazioni sull'installazione della piattaforma Xamarin, vedere Installazione di Xamarin.

Avviare Visual Studio per Mac e creare una nuova app vuota Xamarin.Forms denominata AppLifecycleTutorial.

Importante

I frammenti di codice C# e XAML in questa esercitazione richiedono che la soluzione sia denominata AppLifecycleTutorial. Se si usa un nome diverso, si verificheranno errori di compilazione quando si copia il codice da questa esercitazione alla soluzione.

Per altre informazioni sulla libreria .NET Standard che viene creata, vedere Anatomia di un'applicazioneXamarin.Forms nell'approfondimento della Xamarin.Forms guida introduttiva.
Nel riquadro della soluzione espandere App.xaml nel progetto AppLifecycleTutorial e fare doppio clic su App.xaml.cs per aprirlo. In App.xaml.cs aggiornare quindi gli override OnStart, OnSleep e OnResume come indicato di seguito:
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

protected override void OnSleep()
{
    Console.WriteLine("OnSleep");
}

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Questo codice aggiorna gli override dei metodi del ciclo di vita dell'applicazione, con istruzioni Console.WriteLine che indicano quando è stato richiamato ogni metodo:
- Il metodo OnStart viene richiamato all'avvio dell'applicazione.
- Il metodo OnSleep viene richiamato quando l'applicazione passa in background.
- Il metodo OnResume viene richiamato alla ripresa dell'applicazione dal background.
Nota

Non è disponibile alcun metodo per la terminazione dell'applicazione. In circostanze normali, la terminazione dell'applicazione verrà eseguita dal metodo OnSleep.

Nella barra degli strumenti di Visual Studio per Mac premere il pulsante Avvia, ovvero il pulsante a forma di triangolo simile a un pulsante di riproduzione, per avviare l'applicazione all'interno del simulatore iOS o dell'emulatore Android prescelto. All'avvio dell'applicazione viene richiamato il metodo OnStart e viene restituito OnStart come output nella finestra Output applicazione di Visual Studio per Mac:

2019-02-11 12:05:23.164761+0000 AppLifecycleTutorial.iOS[4089:361037] SecTaskLoadEntitlements failed error=22 cs_flags=200, pid=4089
2019-02-11 12:05:23.165297+0000 AppLifecycleTutorial.iOS[4089:361037] SecTaskCopyDebugDescription: AppLifecycleTuto[4089]/0#-1 LF=0
2019-02-11 12:05:23.685430+0000 AppLifecycleTutorial.iOS[4089:361037] OnStart

Quando l'applicazione passa in background (toccando il pulsante Home in iOS o Android), viene richiamato il metodo OnSleep:

2019-02-11 12:06:12.394301+0000 AppLifecycleTutorial.iOS[4089:361037] OnSleep
Thread started: <Thread Pool> #3
Thread started: <Thread Pool> #4
Thread started: <Thread Pool> #5
Thread started: <Thread Pool> #6
2019-02-11 12:06:13.056968+0000 AppLifecycleTutorial.iOS[4089:361037] SecTaskLoadEntitlements failed error=22 cs_flags=200, pid=4089
2019-02-11 12:06:13.057264+0000 AppLifecycleTutorial.iOS[4089:361037] SecTaskCopyDebugDescription: AppLifecycleTuto[4089]/0#-1 LF=0

Alla ripresa dell'applicazione (toccare l'icona dell'applicazione in iOS, toccare il pulsante Panoramica in Android e selezionare l'applicazione AppLifecycleTutorial), viene richiamato il metodo OnResume:

2019-02-11 12:07:10.321905+0000 AppLifecycleTutorial.iOS[4130:365695] SecTaskLoadEntitlements failed error=22 cs_flags=200, pid=4130
2019-02-11 12:07:10.322557+0000 AppLifecycleTutorial.iOS[4130:365695] SecTaskCopyDebugDescription: AppLifecycleTuto[4130]/0#-1 LF=0
2019-02-11 12:07:17.110938+0000 AppLifecycleTutorial.iOS[4130:365695] OnResume

Nota

Questi blocchi di codice mostrano l'output di esempio quando si esegue l'applicazione in iOS.

In Visual Studio per Mac arrestare l'applicazione.

Per altre informazioni sul ciclo di vita dell'app Xamarin.Forms , vedere Xamarin.Forms Ciclo di vita dell'app.

Rendere persistenti i dati nelle modifiche di stato del ciclo di vita

4 minuti rimanenti

La sottoclasse Application ha un dizionario statico Properties che può essere usato per archiviare dati fra le modifiche di stato del ciclo di vita. Il dizionario usa una chiave string e archivia un valore object. Il dizionario viene salvato automaticamente sul dispositivo e non è ripopolato quando l'applicazione viene riavviata.

Importante

Il dizionario Properties può serializzare solo i tipi primitivi per l'archiviazione.

In questo esercizio si modificherà l'applicazione in modo da rendere permanente il testo da un elemento Entry durante l'elaborazione in background e ripristinare il testo nell'elemento Entry quando l'applicazione viene riavviata.

Visual Studio
Visual Studio per Mac

In Esplora soluzioni, nel progetto AppLifecycleTutorial, espandere App.xaml e fare doppio clic su App.xaml.cs per aprirlo. In App.xaml.cs rimuovere quindi tutto il codice del modello e sostituirlo con il codice seguente:
```
using System;
using Xamarin.Forms;

namespace AppLifecycleTutorial
{
    public partial class App : Application
    {
        const string displayText = "displayText";

        public string DisplayText { get; set; }

        public App()
        {
            InitializeComponent();

            MainPage = new MainPage();
        }

        protected override void OnStart()
        {
            Console.WriteLine("OnStart");

            if (Properties.ContainsKey(displayText))
            {
                DisplayText = (string)Properties[displayText];
            }
        }

        protected override void OnSleep()
        {
            Console.WriteLine("OnSleep");
            Properties[displayText] = DisplayText;
        }

        protected override void OnResume()
        {
            Console.WriteLine("OnResume");
        }
    }
}
```
Questo codice definisce una proprietà DisplayText e una costante displayText. Quando l'applicazione viene messa in background o terminata, l'override del metodo OnSleep aggiunge il valore della proprietà DisplayText al dizionario Properties, in base alla chiave displayText. Quindi, all'avvio dell'applicazione, a condizione che il dizionario Properties contenga la chiave displayText, il valore della chiave viene ripristinato alla proprietà DisplayText.

Importante

Verificare sempre la presenza della chiave nel dizionario Properties prima di accedervi, in modo da evitare errori imprevisti.

Non è necessario ripristinare i dati dal dizionario Properties nell'overload del metodo OnResume. Questo perché, quando un'applicazione è messa in background, l'applicazione stessa e il suo stato sono ancora in memoria.
In Esplora soluzioni, nel progetto AppLifecycleTutorial, fare doppio clic su MainPage.xaml per aprire il file. In MainPage.xaml rimuovere tutto il codice del modello e sostituirlo con il codice seguente:
```
<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="AppLifecycleTutorial.MainPage">
    <StackLayout Margin="20,35,20,20">
        <Entry x:Name="entry"
               Placeholder="Enter text here"
               Completed="OnEntryCompleted" />
    </StackLayout>
</ContentPage>
```
Questo codice definisce in modo dichiarativo l'interfaccia utente per la pagina costituita da un elemento Entry in uno StackLayout. La proprietà Entry.Placeholder specifica il testo segnaposto mostrato alla prima visualizzazione dell'elemento Entry e un gestore eventi denominato OnEntryCompleted viene registrato con l'evento Completed. Inoltre, per Entry viene specificato un nome con l'attributo x:Name. Ciò consente al file code-behind di accedere all'oggetto Entry usando il nome assegnato a esso.
In Esplora soluzioni, nel progetto AppLifecycleTutorial, espandere MainPage.xaml e fare doppio clic su MainPage.xaml.cs per aprirlo. In MainPage.xaml.cs aggiungere un override per il metodo OnAppearing e il gestore eventi OnEntryCompleted alla classe:
```
protected override void OnAppearing()
{
    base.OnAppearing();

    entry.Text = (Application.Current as App).DisplayText;
}

void OnEntryCompleted(object sender, EventArgs e)
{
    (Application.Current as App).DisplayText = entry.Text;
}
```
Il metodo OnAppearing recupera il valore della proprietà App.DisplayText e lo imposta come valore della proprietà Text dell'elemento Entry.

Nota

L'override del metodo OnAppearing viene eseguito dopo che è stato eseguito il layout dell'elemento ContentPage, ma subito prima che diventi visibile. Pertanto, questo è un buon posto per impostare il contenuto delle Xamarin.Forms visualizzazioni.

Quando il testo viene completato nell'elemento Entry, con il tasto INVIO, viene eseguito il metodo OnEntryCompleted e il testo Entry è archiviato nella proprietà App.DisplayText.
Nella barra degli strumenti di Visual Studio premere il pulsante Avvia, ovvero il pulsante a forma di triangolo simile a un pulsante di riproduzione, per avviare l'applicazione all'interno del simulatore iOS remoto o dell'emulatore Android prescelto.

Immettere testo nell'elemento Entry e premere il tasto INVIO. Quindi mettere l'applicazione in background toccando il pulsante Home per chiamare il metodo OnSleep.

In Visual Studio arrestare l'applicazione e riavviarla di nuovo. Il testo immesso in precedenza nell'elemento Entry verrà ripristinato:

In Visual Studio arrestare l'applicazione.

Per altre informazioni sulla persistenza dei dati nel dizionario delle proprietà, vedere Dizionario proprietà nella Xamarin.Forms guida alla classe app.

Nel riquadro della soluzione espandere App.xaml nel progetto AppLifecycleTutorial e fare doppio clic su App.xaml.cs per aprirlo. In App.xaml.cs rimuovere quindi tutto il codice del modello e sostituirlo con il codice seguente:
```
using System;
using Xamarin.Forms;

namespace AppLifecycleTutorial
{
    public partial class App : Application
    {
        const string displayText = "displayText";

        public string DisplayText { get; set; }

        public App()
        {
            InitializeComponent();

            MainPage = new MainPage();
        }

        protected override void OnStart()
        {
            Console.WriteLine("OnStart");

            if (Properties.ContainsKey(displayText))
            {
                DisplayText = (string)Properties[displayText];
            }
        }

        protected override void OnSleep()
        {
            Console.WriteLine("OnSleep");
            Properties[displayText] = DisplayText;
        }

        protected override void OnResume()
        {
            Console.WriteLine("OnResume");
        }
    }
}
```
Questo codice definisce una proprietà DisplayText e una costante displayText. Quando l'applicazione viene messa in background o terminata, l'override del metodo OnSleep aggiunge il valore della proprietà DisplayText al dizionario Properties, in base alla chiave displayText. Quindi, all'avvio dell'applicazione, a condizione che il dizionario Properties contenga la chiave displayText, il valore della chiave viene ripristinato alla proprietà DisplayText.

Importante

Verificare sempre la presenza della chiave nel dizionario Properties prima di accedervi, in modo da evitare errori imprevisti.

Non è necessario ripristinare i dati dal dizionario Properties nell'overload del metodo OnResume. Questo perché, quando un'applicazione è messa in background, l'applicazione stessa e il suo stato sono ancora in memoria.
Nel riquadro della soluzione, nel progetto AppLifecycleTutorial, fare doppio clic su MainPage.xaml per aprire il file. In MainPage.xaml rimuovere tutto il codice del modello e sostituirlo con il codice seguente:
```
<?xml version="1.0" encoding="utf-8"?>
<ContentPage xmlns="http://xamarin.com/schemas/2014/forms"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="AppLifecycleTutorial.MainPage">
    <StackLayout Margin="20,35,20,20">
        <Entry x:Name="entry"
               Placeholder="Enter text here"
               Completed="OnEntryCompleted" />
    </StackLayout>
</ContentPage>
```
Questo codice definisce in modo dichiarativo l'interfaccia utente per la pagina costituita da un elemento Entry in uno StackLayout. La proprietà Entry.Placeholder specifica il testo segnaposto mostrato alla prima visualizzazione dell'elemento Entry e un gestore eventi denominato OnEntryCompleted viene registrato con l'evento Completed. Inoltre, per Entry viene specificato un nome con l'attributo x:Name. Ciò consente al file code-behind di accedere all'oggetto Entry usando il nome assegnato a esso.
Nel riquadro della soluzione, nel progetto AppLifecycleTutorial, espandere MainPage.xaml e fare doppio clic su MainPage.xaml.cs per aprirlo. In MainPage.xaml.cs aggiungere un override per il metodo OnAppearing e il gestore eventi OnEntryCompleted alla classe:
```
protected override void OnAppearing()
{
    base.OnAppearing();

    entry.Text = (Application.Current as App).DisplayText;
}

void OnEntryCompleted(object sender, EventArgs e)
{
    (Application.Current as App).DisplayText = entry.Text;
}
```
Il metodo OnAppearing recupera il valore della proprietà App.DisplayText e lo imposta come valore della proprietà Text dell'elemento Entry.

Nota

L'override del metodo OnAppearing viene eseguito dopo che è stato eseguito il layout dell'elemento ContentPage, ma subito prima che diventi visibile. Pertanto, questo è un buon posto per impostare il contenuto delle Xamarin.Forms visualizzazioni.

Quando il testo viene completato nell'elemento Entry, con il tasto INVIO, viene eseguito il metodo OnEntryCompleted e il testo Entry è archiviato nella proprietà App.DisplayText.
Nella barra degli strumenti di Visual Studio per Mac premere il pulsante Avvia, ovvero il pulsante a forma di triangolo simile a un pulsante di riproduzione, per avviare l'applicazione all'interno del simulatore iOS o dell'emulatore Android prescelto.

Immettere testo nell'elemento Entry e premere il tasto INVIO. Quindi mettere l'applicazione in background toccando il pulsante Home per chiamare il metodo OnSleep.

In Visual Studio per Mac arrestare l'applicazione e riavviarla di nuovo. Il testo immesso in precedenza nell'elemento Entry verrà ripristinato:

In Visual Studio per Mac arrestare l'applicazione.

Per altre informazioni sulla persistenza dei dati nel dizionario delle proprietà, vedere Dizionario proprietà nella Xamarin.Forms guida alla classe app.

Xamarin.Forms Esercitazione sul ciclo di vita dell'app

Rispondere alle modifiche apportate dello stato del ciclo di vita

Rendere persistenti i dati nelle modifiche di stato del ciclo di vita

Congratulazioni!

Passaggi successivi

Xamarin.Forms Esercitazione sul ciclo di vita dell'app

Rispondere alle modifiche apportate dello stato del ciclo di vita

Rendere persistenti i dati nelle modifiche di stato del ciclo di vita

Congratulazioni!

Passaggi successivi

Collegamenti correlati