Xamarin.Forms: Tutorial zum App-Lebenszyklus

Artikel
Developer (Anfänger)
8 Minuten bis zum Abschluss

Bevor Sie mit diesem Tutorial fortfahren, sollten Sie zunächst Folgendes erfolgreich abgeschlossen haben:

Schnellstartanleitung Erstellen Ihrer ersten Xamarin.Forms-App
Das Tutorial zu StackLayout
Das Tutorial zu Entry.

In diesem Tutorial lernen Sie Folgendes:

Reagieren auf den Start, Ruhezustand oder das Fortsetzen einer Anwendung
Beibehalten von Daten bei Zustandsänderungen des Lebenszyklus

Sie verwenden Visual Studio 2019 oder Visual Studio für Mac, um eine einfache Anwendung zu erstellen, die zeigt, wie Sie Daten auch für alle Änderungen des Lebenszyklusstatus beibehalten können. Die folgenden Screenshots zeigen die finale Anwendung:

Reagieren auf Zustandsänderungen des Lebenszyklus

7 Minuten verbleibend

Visual Studio
Visual Studio für Mac

Für dieses Tutorial benötigen Sie das neueste Release von Visual Studio 2019 und die Workload Mobile-Entwicklung mit .NET. Außerdem müssen Sie über einen gekoppelten Mac verfügen, um die Tutorial-App unter iOS zu kompilieren. Informationen zur Installation der Xamarin-Plattform finden Sie unter Installieren von Xamarin. Informationen zum Verbinden von Visual Studio 2019 mit einem Mac-Buildhost finden Sie unter Durchführen einer Kopplung mit einem Mac für die Xamarin.iOS-Entwicklung.

Starten Sie Visual Studio, und erstellen Sie eine neue leere Xamarin.Forms-App mit dem Namen AppLifecycleTutorial.

Wichtig

Für die C#- und XAML-Codeausschnitte in diesem Tutorial ist es erforderlich, dass die Projektmappe AppLifecycleTutorial genannt wird. Die Verwendung eines anderen Namens führt zu Buildfehlern, wenn Sie Code aus diesem Tutorial in die Projektmappe kopieren.

Weitere Informationen zur .NET Standard-Bibliothek, die erstellt wird, finden Sie unter Struktur einer Xamarin.Forms-Anwendung im Artikel Xamarin.Forms: Ausführliche Erläuterungen zum Schnellstart.
Erweitern Sie App.xaml im Projektmappen-Explorer im Projekt AppLifecycleTutorial, und doppelklicken Sie dann auf die Datei App.xaml.cs, um sie zu öffnen. Aktualisieren Sie anschließend in App.xaml.cs die Überschreibungen OnStart, OnSleep und OnResume wie folgt:
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

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

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Diese Code aktualisiert die Methodenüberschreibungen für den Lebenszyklus der App mit Console.WriteLine-Anweisungen, die angeben, wann jede Methode aufgerufen wurde:
- Die OnStart-Methode wird aufgerufen, wenn die Anwendung gestartet wird.
- Die OnSleep-Methode wird aufgerufen, wenn die Anwendung in den Hintergrund wechselt.
- Die OnResume-Methode wird aufgerufen, wenn die Anwendung im Hintergrund fortgesetzt wird.
Hinweis

Es gibt keine Methode zum Beenden der App. Unter normalen Umständen erfolgt die Beendigung der Anwendung durch die OnSleep-Methode.
Klicken Sie in der Symbolleiste von Visual Studio auf die Schaltfläche zum Starten (die dreieckige Schaltfläche, die einer Wiedergabetaste ähnelt), um die Anwendung im ausgewählten iOS-Remotesimulator oder Android-Emulator zu starten: Beim Starten der Anwendung wird die OnStart-Methode aufgerufen, und OnStart wird an das Ausgabe-Fenster in Visual Studio ausgegeben:
```
[Mono] Found as 'java_interop_jnienv_get_object_array_element'.
OnStart
[OpenGLRenderer] HWUI GL Pipeline
```
Wenn die Anwendung in den Hintergrund wechselt (durch Tippen auf die „Home“-Taste unter iOS oder Android), wird die OnSleep-Methode ausgeführt:
```
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
OnSleep
[Mono] Image addref System.Runtime.Serialization[0x83ee19c0] -> System.Runtime.Serialization.dll[0x83f57b00]: 2
```
Wenn die Ausführung der Anwendung dann im Hintergrund fortgesetzt wird (tippen Sie unter iOS auf das Anwendungssymbol und unter Android auf das Übersichtssymbol, und wählen Sie die Anwendung „AppLifecycleTutorial“ aus), wird die OnResume-Methode aufgerufen:
```
Thread finished: <Thread Pool> #5
OnResume
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
```
Hinweis

Diese Codeblöcke zeigen eine Beispielausgabe, wenn die Anwendung unter Android ausgeführt wird.

Beenden Sie die Anwendung in Visual Studio.

Weitere Informationen zum Lebenszyklus von Xamarin.Forms-Apps finden Sie unter Lebenszyklus der Xamarin.Forms-App.

Für dieses Tutorial benötigen Sie Visual Studio für Mac (neuestes Release) mit Plattformunterstützung für iOS und Android. Zudem ist Xcode (neuestes Release) erforderlich. Weitere Informationen zur Installation der Xamarin-Plattform finden Sie unter Installieren von Xamarin.

Starten Sie Visual Studio für Mac, und erstellen Sie eine neue leere Xamarin.Forms-App mit dem Namen AppLifecycleTutorial.

Wichtig

Für die C#- und XAML-Codeausschnitte in diesem Tutorial ist es erforderlich, dass die Projektmappe AppLifecycleTutorial genannt wird. Die Verwendung eines anderen Namens führt zu Buildfehlern, wenn Sie Code aus diesem Tutorial in die Projektmappe kopieren.

Weitere Informationen zur .NET Standard-Bibliothek, die erstellt wird, finden Sie unter Struktur einer Xamarin.Forms-Anwendung im Artikel Xamarin.Forms: Ausführliche Erläuterungen zum Schnellstart.
Erweitern Sie App.xaml im Lösungspad im Projekt AppLifecycleTutorial, und doppelklicken Sie dann auf die Datei App.xaml.cs, um sie zu öffnen. Aktualisieren Sie anschließend in App.xaml.cs die Überschreibungen OnStart, OnSleep und OnResume wie folgt:
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

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

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Diese Code aktualisiert die Methodenüberschreibungen für den Lebenszyklus der App mit Console.WriteLine-Anweisungen, die angeben, wann jede Methode aufgerufen wurde:
- Die OnStart-Methode wird aufgerufen, wenn die Anwendung gestartet wird.
- Die OnSleep-Methode wird aufgerufen, wenn die Anwendung in den Hintergrund wechselt.
- Die OnResume-Methode wird aufgerufen, wenn die Anwendung im Hintergrund fortgesetzt wird.
Hinweis

Es gibt keine Methode zum Beenden der App. Unter normalen Umständen erfolgt die Beendigung der Anwendung durch die OnSleep-Methode.

Klicken Sie in der Symbolleiste von Visual Studio für Mac auf die Schaltfläche zum Starten (die dreieckige Schaltfläche, die einer Wiedergabetaste ähnelt), um die Anwendung im ausgewählten iOS-Simulator oder Android-Emulator zu starten: Beim Starten der Anwendung wird die OnStart-Methode aufgerufen, und OnStart wird an das Anwendungsausgabe-Fenster in Visual Studio für Mac ausgegeben:

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

Wenn die Anwendung in den Hintergrund wechselt (durch Tippen auf die „Home“-Taste unter iOS oder Android), wird die OnSleep-Methode ausgeführt:

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

Wenn die Ausführung der Anwendung dann im Hintergrund fortgesetzt wird (tippen Sie unter iOS auf das Anwendungssymbol und unter Android auf das Übersichtssymbol, und wählen Sie die Anwendung „AppLifecycleTutorial“ aus), wird die OnResume-Methode aufgerufen:

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

Hinweis

Diese Codeblöcke zeigen eine Beispielausgabe, wenn die Anwendung unter iOS ausgeführt wird.

Beenden Sie die Anwendung in Visual Studio für Mac.

Weitere Informationen zum Lebenszyklus von Xamarin.Forms-Apps finden Sie unter Lebenszyklus der Xamarin.Forms-App.

Beibehalten von Daten bei Zustandsänderungen des Lebenszyklus

4 Minuten verbleibend

Die Unterklasse Application enthält ein statisches Properties-Wörterbuch, das zum Speichern von Daten bei Zustandsänderungen des Lebenszyklus verwendet werden kann. Das Wörterbuch verwendet einen string-Schlüssel und speichert einen object-Wert. Das Wörterbuch wird automatisch auf dem Gerät gespeichert und wird bei Neustart der Anwendung erneut aufgefüllt.

Wichtig

Das Properties-Wörterbuch kann nur primitive Typen für die Speicherung serialisieren.

In dieser Übung passen Sie die Anwendung an, um den Text einer Entry-Klasse im Hintergrund beizubehalten und den Text für die Entry-Klasse wiederherzustellen, wenn die Anwendung erneut gestartet wird.

Visual Studio
Visual Studio für Mac

Erweitern Sie App.xaml im Projektmappen-Explorer im Projekt AppLifecycleTutorial, und doppelklicken Sie dann auf die Datei App.xaml.cs, um sie zu öffnen. Entfernen Sie anschließend in App.xaml.cs den gesamten Vorlagencode, und ersetzen Sie ihn durch den folgenden:
```
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");
        }
    }
}
```
Mit diesem Code wird eine DisplayText-Eigenschaft und eine displayText-Konstante definiert. Wenn die Anwendung minimiert oder beendet wird, fügt die Überschreibung der OnSleep-Methode den Eigenschaftswert DisplayText zum Properties-Wörterbuch für einen displayText-Schlüssel hinzu. Wenn die Anwendung dann gestartet wird, wird die Eigenschaft DisplayText als Wert für den Schlüssel wiederhergestellt, sofern das Properties-Wörterbuch den Schlüssel displayText enthält.

Wichtig

Überprüfen Sie immer, ob das Properties-Wörterbuch einen Schlüssel enthält, bevor Sie darauf zugreifen, um unerwartete Fehler zu vermeiden.

Dies ist nicht notwendig, um Daten aus dem Properties-Wörterbuch in der OnResume-Methodenüberladung wiederherzustellen. Das liegt daran, dass der Zustand noch im Arbeitsspeicher vorhanden ist, wenn die Anwendung minimiert wird.
Doppelklicken Sie im Projektmappen-Explorer im Projekt AppLifecycleTutorial auf die Datei MainPage.xaml, um sie zu öffnen. Entfernen Sie dann in MainPage.xaml den gesamten Vorlagencode, und ersetzen Sie ihn durch den folgenden:
```
<?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>
```
Dieser Code definiert deklarativ die Benutzeroberfläche für die Seite, die ein Entry in einem StackLayout enthält. Die Entry.Placeholder-Eigenschaft legt einen Platzhaltertext fest, der angezeigt wird, wenn Entry zum ersten Mal angezeigt wurde. Außerdem wird ein Ereignishandler namens OnEntryCompleted mit dem Ereignis Completed registriert. Außerdem hat die Entry-Klasse einen Namen, der mit dem x:Name-Attribut festgelegt wird. Dadurch kann die CodeBehind-Datei mithilfe des zugewiesenen Namens auf das Objekt Entry zugreifen.
Erweitern Sie MainPage.xaml im Projektmappen-Explorer im Projekt AppLifecycleTutorial, und doppelklicken Sie dann auf die Datei MainPage.xaml.cs, um sie zu öffnen. Fügen Sie dann in der Datei MainPage.xaml.cs eine Überschreibung für die Methode OnAppearing und den Ereignishandler OnEntryCompleted zur Klasse hinzu:
```
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;
}
```
Die OnAppearing-Methode ruft den Wert der Eigenschaft App.DisplayText ab und legt diesen als Text-Eigenschaftswert der Entry-Klasse fest.

Hinweis

Die Außerkraftsetzung der OnAppearing-Methode wird ausgeführt, nachdem die ContentPage-Klasse angelegt wurde, aber noch bevor sie angezeigt wird. Daher eignet sich diese Position gut, um den Inhalt von Xamarin.Forms-Ansichten festzulegen.

Sobald der Text in der Entry-Klasse mit der EINGABETASTE fertig gestellt wird, wird die Methode OnEntryCompleted ausgeführt, und der Entry-Text wird in der Eigenschaft App.DisplayText gespeichert.
Klicken Sie in der Symbolleiste von Visual Studio auf die Schaltfläche zum Starten (die dreieckige Schaltfläche, die einer Wiedergabetaste ähnelt), um die Anwendung im ausgewählten iOS-Remotesimulator oder Android-Emulator zu starten:

Geben Sie einen Text in die Entry-Klasse ein, und drücken Sie die EINGABETASTE. Minimieren Sie dann die Anwendung, indem Sie auf die Home-Taste tippen, um die Methode OnSleep aufzurufen.

Beenden Sie die Anwendung in Visual Studio, und starten Sie sie erneut. Der Text, den Sie zuvor in Entry eingegeben haben, wird wiederhergestellt:

Beenden Sie die Anwendung in Visual Studio.

Weitere Informationen zum Beibehalten von Daten im Eigenschaftenwörterbuch finden Sie unter Eigenschaftenwörterbuch im Leitfaden zur Xamarin.Forms-App-Klasse.

Erweitern Sie App.xaml im Lösungspad im Projekt AppLifecycleTutorial, und doppelklicken Sie dann auf die Datei App.xaml.cs, um sie zu öffnen. Entfernen Sie anschließend in App.xaml.cs den gesamten Vorlagencode, und ersetzen Sie ihn durch den folgenden:
```
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");
        }
    }
}
```
Mit diesem Code wird eine DisplayText-Eigenschaft und eine displayText-Konstante definiert. Wenn die Anwendung minimiert oder beendet wird, fügt die Überschreibung der OnSleep-Methode den Eigenschaftswert DisplayText zum Properties-Wörterbuch für einen displayText-Schlüssel hinzu. Wenn die Anwendung dann gestartet wird, wird die Eigenschaft DisplayText als Wert für den Schlüssel wiederhergestellt, sofern das Properties-Wörterbuch den Schlüssel displayText enthält.

Wichtig

Überprüfen Sie immer, ob das Properties-Wörterbuch einen Schlüssel enthält, bevor Sie darauf zugreifen, um unerwartete Fehler zu vermeiden.

Dies ist nicht notwendig, um Daten aus dem Properties-Wörterbuch in der OnResume-Methodenüberladung wiederherzustellen. Das liegt daran, dass der Zustand noch im Arbeitsspeicher vorhanden ist, wenn die Anwendung minimiert wird.
Doppelklicken Sie im Lösungspad im Projekt AppLifecycleTutorial auf die Datei MainPage.xaml, um sie zu öffnen. Entfernen Sie dann in MainPage.xaml den gesamten Vorlagencode, und ersetzen Sie ihn durch den folgenden:
```
<?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>
```
Dieser Code definiert deklarativ die Benutzeroberfläche für die Seite, die ein Entry in einem StackLayout enthält. Die Entry.Placeholder-Eigenschaft legt einen Platzhaltertext fest, der angezeigt wird, wenn Entry zum ersten Mal angezeigt wurde. Außerdem wird ein Ereignishandler namens OnEntryCompleted mit dem Ereignis Completed registriert. Außerdem hat die Entry-Klasse einen Namen, der mit dem x:Name-Attribut festgelegt wird. Dadurch kann die CodeBehind-Datei mithilfe des zugewiesenen Namens auf das Objekt Entry zugreifen.
Erweitern Sie MainPage.xaml im Lösungspad im Projekt AppLifecycleTutorial, und doppelklicken Sie dann auf die Datei MainPage.xaml.cs, um sie zu öffnen. Fügen Sie dann in der Datei MainPage.xaml.cs eine Überschreibung für die Methode OnAppearing und den Ereignishandler OnEntryCompleted zur Klasse hinzu:
```
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;
}
```
Die OnAppearing-Methode ruft den Wert der Eigenschaft App.DisplayText ab und legt diesen als Text-Eigenschaftswert der Entry-Klasse fest.

Hinweis

Die Außerkraftsetzung der OnAppearing-Methode wird ausgeführt, nachdem die ContentPage-Klasse angelegt wurde, aber noch bevor sie angezeigt wird. Daher eignet sich diese Position gut, um den Inhalt von Xamarin.Forms-Ansichten festzulegen.

Sobald der Text in der Entry-Klasse mit der EINGABETASTE fertig gestellt wird, wird die Methode OnEntryCompleted ausgeführt, und der Entry-Text wird in der Eigenschaft App.DisplayText gespeichert.
Klicken Sie in der Symbolleiste von Visual Studio für Mac auf die Schaltfläche zum Starten (die dreieckige Schaltfläche, die einer Wiedergabetaste ähnelt), um die Anwendung im ausgewählten iOS-Simulator oder Android-Emulator zu starten:

Geben Sie einen Text in die Entry-Klasse ein, und drücken Sie die EINGABETASTE. Minimieren Sie dann die Anwendung, indem Sie auf die Home-Taste tippen, um die Methode OnSleep aufzurufen.

Beenden Sie die Anwendung in Visual Studio für Mac, und starten Sie sie erneut. Der Text, den Sie zuvor in Entry eingegeben haben, wird wiederhergestellt:

Beenden Sie die Anwendung in Visual Studio für Mac.

Weitere Informationen zum Beibehalten von Daten im Eigenschaftenwörterbuch finden Sie unter Eigenschaftenwörterbuch im Leitfaden zur Xamarin.Forms-App-Klasse.

Xamarin.Forms: Tutorial zum App-Lebenszyklus

Reagieren auf Zustandsänderungen des Lebenszyklus

Beibehalten von Daten bei Zustandsänderungen des Lebenszyklus

Herzlichen Glückwunsch!

Nächste Schritte

Xamarin.Forms: Tutorial zum App-Lebenszyklus

Reagieren auf Zustandsänderungen des Lebenszyklus

Beibehalten von Daten bei Zustandsänderungen des Lebenszyklus

Herzlichen Glückwunsch!

Nächste Schritte

Verwandte Links