Xamarin.Forms Tutoriel sur le cycle de vie des applications

Article
Developer (Débutant)
8 minutes avant achèvement

Avant de tenter ce didacticiel, vous devez avoir suivi les guides et didacticiels suivants :

Créer votre premier Xamarin.Forms démarrage rapide d’application .
Didacticiel StackLayout.
Didacticiel Entry.

Dans ce tutoriel, vous allez apprendre à :

Répondre au démarrage, à la mise en veille ou à la sortie de veille d’une application.
Conserver les données quelle que soit l’évolution de leur état pendant leur cycle de vie.

Vous allez utiliser Visual Studio 2019 ou Visual Studio pour Mac pour créer une application simple qui montre comment conserver les données à travers les changements d’état du cycle de vie. Les captures d’écran suivantes montrent l’application finale :

Répondre aux changements d’état du cycle de vie

7 minutes restantes

Visual Studio
Visual Studio pour Mac

Pour suivre ce didacticiel, vous devez disposer de Visual Studio 2019 (dernière version) sur lequel est installée la charge de travail Développement mobile en .NET. Vous aurez également besoin d’un Mac couplé pour générer l’application du didacticiel sur iOS. Pour plus d’informations sur l’installation de la plateforme Xamarin, consultez Installation de Xamarin. Pour plus d’informations sur la connexion de Visual Studio 2019 à un hôte de build Mac, consultez l’article Appairer avec un Mac pour le développement Xamarin.iOS.

Lancez Visual Studio et créez une application vide Xamarin.Forms nommée AppLifecycleTutorial.

Important

Pour les extraits C# et XAML de ce didacticiel, la solution doit se nommer AppLifecycleTutorial. L’utilisation d’un autre nom entraîne des erreurs de build quand vous copiez le code à partir de ce didacticiel dans la solution.

Pour plus d’informations sur la bibliothèque .NET Standard créée, consultez Anatomie d’une Xamarin.Forms application dans le Xamarin.Forms guide de démarrage rapide Approfondi.
Dans l’Explorateur de solutions, dans le projet AppLifecycleTutorial, développez MainPage.xaml, puis double-cliquez sur MainPage.xaml.cs pour l’ouvrir. Ensuite, dans App.xaml.cs, mettez à jour les substitutions OnStart, OnSleep et OnResume comme suit :
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

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

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Ce code met à jour les substitutions de méthodes de cycle de vie des applications, avec des instructions Console.WriteLine qui indiquent le moment où chaque méthode a été appelée :
- La méthode OnStart est appelée au démarrage de l’application.
- La méthode OnSleep est appelée lorsque l’application passe en arrière-plan.
- La méthode OnResume est appelée lorsque l’application est relancée depuis l’arrière-plan.
Notes

Il n’existe aucune méthode pour arrêter l’application. Dans des circonstances normales, l’arrêt de l’application est effectué à partir de la méthode OnSleep.
Dans la barre d’outils Visual Studio, appuyez sur le bouton Démarrer (le bouton triangulaire qui ressemble à un bouton de lecture) pour lancer l’application à l’intérieur du simulateur iOS distant ou de l’émulateur Android de votre choix. Lorsque l’application démarre, la méthode OnStart est appelée, et le résultat OnStart est affiché dans la fenêtre de sortie de Visual Studio :
```
[Mono] Found as 'java_interop_jnienv_get_object_array_element'.
OnStart
[OpenGLRenderer] HWUI GL Pipeline
```
Lorsque l’application passe en arrière-plan (en appuyant sur le bouton d’accueil iOS ou Android), la méthode OnSleep est appelée :
```
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
OnSleep
[Mono] Image addref System.Runtime.Serialization[0x83ee19c0] -> System.Runtime.Serialization.dll[0x83f57b00]: 2
```
Ensuite, lorsque l’application est relancée depuis l’arrière-plan (en appuyant sur l’icône d’application sur iOS ou en appuyant sur le bouton d’aperçu sur Android, puis en sélectionnant l’application AppLifecycleTutorial), la méthode OnResume est appelée :
```
Thread finished: <Thread Pool> #5
OnResume
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
```
Notes

Ces blocs de code illustrent un exemple de sortie lors de l’exécution de l’application sur Android.

Dans Visual Studio, arrêtez l’application.

Pour plus d’informations sur le cycle de vie des Xamarin.Forms applications, consultez Xamarin.Forms Cycle de vie des applications.

Pour suivre ce didacticiel, vous devez disposer de Visual Studio pour Mac (dernière version) avec une prise en charge des plateformes iOS et Android. Vous aurez également besoin de Xcode (dernière version). Pour plus d’informations sur l’installation de la plateforme Xamarin, consultez Installation de Xamarin.

Lancez Visual Studio pour Mac, puis créez une application vide Xamarin.Forms nommée AppLifecycleTutorial.

Important

Pour les extraits C# et XAML de ce didacticiel, la solution doit se nommer AppLifecycleTutorial. L’utilisation d’un autre nom entraîne des erreurs de build quand vous copiez le code à partir de ce didacticiel dans la solution.

Pour plus d’informations sur la bibliothèque .NET Standard créée, consultez Anatomie d’une Xamarin.Forms application dans le Xamarin.Forms guide de démarrage rapide Approfondi.
Dans Panneau Solutions, dans le projet AppLifecycleTutorial, développez MainPage.xaml, puis double-cliquez sur MainPage.xaml.cs pour l’ouvrir. Ensuite, dans App.xaml.cs, mettez à jour les substitutions OnStart, OnSleep et OnResume comme suit :
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

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

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Ce code met à jour les substitutions de méthodes de cycle de vie des applications, avec des instructions Console.WriteLine qui indiquent le moment où chaque méthode a été appelée :
- La méthode OnStart est appelée au démarrage de l’application.
- La méthode OnSleep est appelée lorsque l’application passe en arrière-plan.
- La méthode OnResume est appelée lorsque l’application est relancée depuis l’arrière-plan.
Notes

Il n’existe aucune méthode pour arrêter l’application. Dans des circonstances normales, l’arrêt de l’application est effectué à partir de la méthode OnSleep.

Dans la barre d’outils Visual Studio pour Mac, appuyez sur le bouton Démarrer (le bouton triangulaire qui ressemble à un bouton de lecture) pour lancer l’application dans le simulateur iOS ou dans l’émulateur Android de votre choix. Lorsque l’application démarre, la méthode OnStart est appelée, et le résultat OnStart est affiché dans la fenêtre de sortie d’application de Visual Studio pour 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

Lorsque l’application passe en arrière-plan (en appuyant sur le bouton d’accueil iOS ou Android), la méthode OnSleep est appelée :

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

Ensuite, lorsque l’application est relancée depuis l’arrière-plan (en appuyant sur l’icône d’application sur iOS ou en appuyant sur le bouton d’aperçu sur Android, puis en sélectionnant l’application AppLifecycleTutorial), la méthode OnResume est appelée :

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

Notes

Ces blocs de code illustrent un exemple de sortie lors de l’exécution de l’application sur iOS.

Dans Visual Studio pour Mac, arrêtez l’application.

Pour plus d’informations sur le cycle de vie des Xamarin.Forms applications, consultez Xamarin.Forms Cycle de vie des applications.

Conserver les données quelle que soit l’évolution de leur état pendant leur cycle de vie

4 minutes restantes

La sous-classe Application dispose d’un dictionnaire statique Properties qui peut être utilisé pour stocker des données tout au long des changements d’état du cycle de vie. Ce dictionnaire utilise une clé string et stocke une valeur object. Le dictionnaire est automatiquement enregistré sur l’appareil et il est rempli à nouveau lorsque l’application est redémarrée.

Important

Le dictionnaire Properties peut sérialiser uniquement les types primitifs de stockage.

Dans cet exercice, vous modifierez l’application pour conserver le texte d’un élément Entry lors de la mise en arrière-plan et restaurer le texte vers l’élément Entry lorsque l’application est redémarrée.

Visual Studio
Visual Studio pour Mac

Dans l’Explorateur de solutions, dans le projet AppLifecycleTutorial, développez MainPage.xaml, puis double-cliquez sur MainPage.xaml.cs pour l’ouvrir. Ensuite, dans App.xaml.cs, supprimez tout le code du modèle et remplacez-le par le code suivant :
```
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");
        }
    }
}
```
Ce code définit une propriété DisplayText et une constante displayText. Lorsque l’application est mise en arrière-plan ou arrêtée, la substitution de méthode OnSleep ajoute la valeur de propriété DisplayText au dictionnaire Properties, par rapport à une clé displayText. Puis, lorsque l’application démarre, si le dictionnaire Properties contient bien la clé displayText, la valeur de la clé est restaurée vers la propriété DisplayText.

Important

Pour éviter toute erreur inattendue, vérifiez toujours que le dictionnaire Properties contient la clé avant d’y accéder.

Il n’est pas nécessaire de restaurer les données à partir du dictionnaire Properties dans la surcharge de méthode OnResume. En effet, lorsqu’une application est mise en arrière-plan, son état est toujours conservé en mémoire.
Dans l’Explorateur de solutions, dans le projet AppLifecycleTutorial, double-cliquez sur MainPage.xaml pour l’ouvrir. Puis, dans MainPage.xaml, supprimez tout le code du modèle et remplacez-le par le code suivant :
```
<?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>
```
Ce code définit de manière déclarative l’interface utilisateur de la page, qui comprend un élément Entry dans StackLayout. La propriété Entry.Placeholder spécifie le texte d’espace réservé affiché lorsque l’élément Entry est affiché en premier, et un gestionnaire d’événements nommé OnEntryCompleted est inscrit auprès de l’événement Completed. En outre, l’élément Entry dispose d’un nom spécifié avec l’attribut x:Name. Ainsi, le fichier code-behind peut accéder à l’objet Entry en utilisant le nom qui y est affecté.
Dans l’Explorateur de solutions, dans le projet AppLifecycleTutorial, développez MainPage.xaml, puis double-cliquez sur MainPage.xaml.cs pour l’ouvrir. Puis, dans MainPage.xaml.cs, ajoutez une substitution pour la méthode OnAppearing, et le gestionnaire d’événements OnEntryCompleted à la 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;
}
```
La méthode OnAppearing récupère la valeur de la propriété App.DisplayText et la définit comme valeur de propriété Text de l’élément Entry.

Notes

Le remplacement de la méthode OnAppearing est exécuté une fois que ContentPage est mis en page, juste avant qu’il soit visible. Par conséquent, il s’agit d’un bon endroit pour définir le contenu des Xamarin.Forms vues.

Lorsque le texte est finalisé dans l’élément Entry, avec la touche de retour, la méthode OnEntryCompleted s’exécute et le texte Entry est stocké dans la propriété App.DisplayText.
Dans la barre d’outils Visual Studio, appuyez sur le bouton Démarrer (le bouton triangulaire qui ressemble à un bouton de lecture) pour lancer l’application à l’intérieur du simulateur iOS distant ou de l’émulateur Android de votre choix.

Entrez du texte dans l’élément Entry et appuyez sur la touche de retour. Ensuite, mettez l’application en arrière-plan en appuyant sur le bouton d’accueil pour appeler la méthode OnSleep.

Dans Visual Studio, arrêtez l’application, puis relancez-la. Le texte qui a été entré précédemment dans l’élément Entry sera restauré :

Dans Visual Studio, arrêtez l’application.

Pour plus d’informations sur la conservation des données dans le dictionnaire de propriétés, consultez Dictionnaire des propriétés dans le guide Classe d’applicationXamarin.Forms.

Dans Panneau Solutions, dans le projet AppLifecycleTutorial, développez MainPage.xaml, puis double-cliquez sur MainPage.xaml.cs pour l’ouvrir. Ensuite, dans App.xaml.cs, supprimez tout le code du modèle et remplacez-le par le code suivant :
```
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");
        }
    }
}
```
Ce code définit une propriété DisplayText et une constante displayText. Lorsque l’application est mise en arrière-plan ou arrêtée, la substitution de méthode OnSleep ajoute la valeur de propriété DisplayText au dictionnaire Properties, par rapport à une clé displayText. Puis, lorsque l’application démarre, si le dictionnaire Properties contient bien la clé displayText, la valeur de la clé est restaurée vers la propriété DisplayText.

Important

Pour éviter toute erreur inattendue, vérifiez toujours que le dictionnaire Properties contient la clé avant d’y accéder.

Il n’est pas nécessaire de restaurer les données à partir du dictionnaire Properties dans la surcharge de méthode OnResume. En effet, lorsqu’une application est mise en arrière-plan, son état est toujours conservé en mémoire.
Dans Panneau Solutions, dans le projet AppLifecycleTutorial, double-cliquez sur MainPage.xaml pour l’ouvrir. Puis, dans MainPage.xaml, supprimez tout le code du modèle et remplacez-le par le code suivant :
```
<?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>
```
Ce code définit de manière déclarative l’interface utilisateur de la page, qui comprend un élément Entry dans StackLayout. La propriété Entry.Placeholder spécifie le texte d’espace réservé affiché lorsque l’élément Entry est affiché en premier, et un gestionnaire d’événements nommé OnEntryCompleted est inscrit auprès de l’événement Completed. En outre, l’élément Entry dispose d’un nom spécifié avec l’attribut x:Name. Ainsi, le fichier code-behind peut accéder à l’objet Entry en utilisant le nom qui y est affecté.
Dans Panneau Solutions, dans le projet AppLifecycleTutorial, développez MainPage.xaml, puis double-cliquez sur MainPage.xaml.cs pour l’ouvrir. Puis, dans MainPage.xaml.cs, ajoutez une substitution pour la méthode OnAppearing, et le gestionnaire d’événements OnEntryCompleted à la 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;
}
```
La méthode OnAppearing récupère la valeur de la propriété App.DisplayText et la définit comme valeur de propriété Text de l’élément Entry.

Notes

Le remplacement de la méthode OnAppearing est exécuté une fois que ContentPage est mis en page, juste avant qu’il soit visible. Par conséquent, il s’agit d’un bon endroit pour définir le contenu des Xamarin.Forms vues.

Lorsque le texte est finalisé dans l’élément Entry, avec la touche de retour, la méthode OnEntryCompleted s’exécute et le texte Entry est stocké dans la propriété App.DisplayText.
Dans la barre d’outils Visual Studio pour Mac, appuyez sur le bouton Démarrer (le bouton triangulaire qui ressemble à un bouton de lecture) pour lancer l’application dans le simulateur iOS ou dans l’émulateur Android de votre choix.

Entrez du texte dans l’élément Entry et appuyez sur la touche de retour. Ensuite, mettez l’application en arrière-plan en appuyant sur le bouton d’accueil pour appeler la méthode OnSleep.

Dans Visual Studio pour Mac, arrêtez l’application, puis relancez-la. Le texte qui a été entré précédemment dans l’élément Entry sera restauré :

Dans Visual Studio pour Mac, arrêtez l’application.

Pour plus d’informations sur la conservation des données dans le dictionnaire de propriétés, consultez Dictionnaire des propriétés dans le guide Classe d’applicationXamarin.Forms.

Xamarin.Forms Tutoriel sur le cycle de vie des applications

Répondre aux changements d’état du cycle de vie

Conserver les données quelle que soit l’évolution de leur état pendant leur cycle de vie

Félicitations !

Étapes suivantes

Xamarin.Forms Tutoriel sur le cycle de vie des applications

Répondre aux changements d’état du cycle de vie

Conserver les données quelle que soit l’évolution de leur état pendant leur cycle de vie

Félicitations !

Étapes suivantes

Liens connexes