Xamarin.Forms Kurz životního cyklu aplikace

Článek
Developer (Začátečník)
8 min do dokončení

Než se pustíte do tohoto kurzu, měli byste úspěšně dokončit tyto položky:

Vytvořte svůj první Xamarin.Forms rychlý start k aplikaci .
Kurz k objektu StackLayout
Kurz o objektu Entry

V tomto kurzu se naučíte:

Reagovat na spuštění, uspání nebo obnovení aplikace
Uchovávat data napříč změnami stavu životního cyklu

V sadě Visual Studio 2019 nebo Visual Studio pro Mac vytvoříte jednoduchou aplikaci, která předvádí, jak trvale uchovávat data napříč změnami životního cyklu. Na následujících snímcích obrazovky je zachycena finální aplikace:

Reakce na změny stavu životního cyklu

7 min zbývá

Visual Studio
Visual Studio pro Mac

K dokončení tohoto kurzu byste měli mít Visual Studio 2019 (nejnovější vydanou verzi) s nainstalovanou sadou funkcí Vývoj mobilních aplikací pomocí .NET. Kromě toho budete potřebovat spárovaný Mac pro sestavení aplikace z kurzu v iOSu. Informace o instalaci platformy Xamarin najdete v článku Instalace Xamarinu. Informace o připojení sady Visual Studio 2019 k hostiteli buildu pro Mac najdete v článku Spárování s počítačem Mac pro vývoj na platformě Xamarin.iOS.

Spusťte Visual Studio a vytvořte novou prázdnou Xamarin.Forms aplikaci s názvem AppLifecycleTutorial.

Důležité

Fragmenty kódu C# a XAML v tomto kurzu vyžadují, aby řešení mělo název AppLifecycleTutorial. Použití jiného názvu způsobí při kopírování kódu z tohoto kurzu do řešení chyby sestavení.

Další informace o knihovně .NET Standard, která se vytvoří, najdete v tématu Anatomie Xamarin.Forms aplikace v podrobném Xamarin.Forms kurzu Rychlý start.
V Průzkumníkovi řešení v projektu AppLifecycleTutorial rozbalte uzel App.xaml a poklikáním otevřete soubor App.xaml.cs. Pak v souboru App.xaml.cs aktualizujte přepsání metod OnStart, OnSleep a OnResume následujícím způsobem:
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

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

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Tento kód aktualizuje přepsání metod životního cyklu aplikace pomocí příkazů Console.WriteLine, které indikují, kdy byly jednotlivé metody vyvolány:
- Metoda OnStart se vyvolá při spuštění aplikace.
- Metoda OnSleep se vyvolá při přechodu aplikace do pozadí.
- Metoda OnResume se vyvolá při obnovení aplikace z pozadí.
Poznámka:

Pro ukončení aplikace není k dispozici žádná metoda. Za normálních podmínek dochází k ukončení aplikace z metody OnSleep.
Na panelu nástrojů sady Visual Studio stiskněte tlačítko Spustit (trojúhelníkové tlačítko, která se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném vzdáleném simulátoru iOSu nebo emulátoru Androidu. Při spuštění aplikace se vyvolá metoda OnStart a výstupem v sadě Visual Studio v okně Výstup je OnStart:
```
[Mono] Found as 'java_interop_jnienv_get_object_array_element'.
OnStart
[OpenGLRenderer] HWUI GL Pipeline
```
Při přechodu aplikace do pozadí (klepnutím na tlačítko Domů v iOSu nebo Androidu) se vyvolá metoda OnSleep:
```
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
OnSleep
[Mono] Image addref System.Runtime.Serialization[0x83ee19c0] -> System.Runtime.Serialization.dll[0x83f57b00]: 2
```
Při obnovení aplikace z pozadí (v iOSu po klepnutí na ikonu aplikace, v Androidu po klepnutí na tlačítko přehledu a následném výběru aplikace AppLifecycleTutorial) se pak vyvolá metoda OnResume:
```
Thread finished: <Thread Pool> #5
OnResume
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
```
Poznámka:

Tyto bloky kódu ukazují příklad výstupu při spuštění aplikace v Androidu.

V sadě Visual Studio zastavte aplikaci.

Další informace o Xamarin.Forms životním cyklu aplikace najdete v tématu Xamarin.Forms Životní cyklus aplikace.

K dokončení tohoto kurzu byste měli mít Visual Studio pro Mac (nejnovější vydanou verzi) s nainstalovanou podporou pro platformy iOS a Android. Kromě toho budete také potřebovat Xcode (nejnovější vydanou verzi). Další informace o instalaci platformy Xamarin najdete v článku Instalace Xamarinu.

Spusťte Visual Studio pro Mac a vytvořte novou prázdnou Xamarin.Forms aplikaci s názvem AppLifecycleTutorial.

Důležité

Fragmenty kódu C# a XAML v tomto kurzu vyžadují, aby řešení mělo název AppLifecycleTutorial. Použití jiného názvu způsobí při kopírování kódu z tohoto kurzu do řešení chyby sestavení.

Další informace o knihovně .NET Standard, která se vytvoří, najdete v tématu Anatomie Xamarin.Forms aplikace v podrobném Xamarin.Forms kurzu Rychlý start.
V Oblasti řešení v projektu AppLifecycleTutorial rozbalte uzel App.xaml a poklikáním otevřete soubor App.xaml.cs. Pak v souboru App.xaml.cs aktualizujte přepsání metod OnStart, OnSleep a OnResume následujícím způsobem:
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

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

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Tento kód aktualizuje přepsání metod životního cyklu aplikace pomocí příkazů Console.WriteLine, které indikují, kdy byly jednotlivé metody vyvolány:
- Metoda OnStart se vyvolá při spuštění aplikace.
- Metoda OnSleep se vyvolá při přechodu aplikace do pozadí.
- Metoda OnResume se vyvolá při obnovení aplikace z pozadí.
Poznámka:

Pro ukončení aplikace není k dispozici žádná metoda. Za normálních podmínek dochází k ukončení aplikace z metody OnSleep.

Na panelu nástrojů sady Visual Studio pro Mac stiskněte tlačítko Spustit (trojúhelníkové tlačítko, která se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném simulátoru iOSu nebo emulátoru Androidu. Při spuštění aplikace se vyvolá metoda OnStart a výstupem v sadě Visual Studio pro Mac v okně Výstup aplikace je OnStart:

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

Při přechodu aplikace do pozadí (klepnutím na tlačítko Domů v iOSu nebo Androidu) se vyvolá metoda 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

Při obnovení aplikace z pozadí (v iOSu po klepnutí na ikonu aplikace, v Androidu po klepnutí na tlačítko přehledu a následném výběru aplikace AppLifecycleTutorial) se pak vyvolá metoda 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

Poznámka:

Tyto bloky kódu ukazují příklad výstupu při spuštění aplikace v iOSu.

V sadě Visual Studio pro Mac zastavte aplikaci.

Další informace o Xamarin.Forms životním cyklu aplikace najdete v tématu Xamarin.Forms Životní cyklus aplikace.

Uchovávání dat napříč změnami stavu životního cyklu

4 min zbývá

Podtřída Application má statický slovník Properties, do kterého je možné ukládat data napříč změnami stavu životního cyklu. Tento slovník využívá klíč string a ukládá hodnotu object. Slovník se na zařízení ukládá automaticky a opakovaně se plní při restartování aplikace.

Důležité

Slovník Properties může serializovat pouze primitivní typy úložiště.

V tomto cvičení změníte aplikaci tak, aby při zpracování úloh na pozadí uchovala text z objektu Entry a při restartování aplikace ho v objektu Entry obnovila.

Visual Studio
Visual Studio pro Mac

V Průzkumníkovi řešení v projektu AppLifecycleTutorial rozbalte uzel App.xaml a poklikáním otevřete soubor App.xaml.cs. Pak v souboru App.xaml.cs odeberte veškerý kód šablony a nahraďte ho následujícím kódem:
```
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");
        }
    }
}
```
Tento kód definuje vlastnost DisplayText a konstantu displayText. Při přechodu aplikace do pozadí nebo při jejím ukončení přepsání metody OnSleep přidá hodnotu vlastnosti DisplayText do slovníku Properties oproti klíči displayText. Po spuštění aplikace se za předpokladu, že slovník Properties obsahuje klíčdisplayText, obnoví hodnota klíče ve vlastnosti DisplayText.

Důležité

Před použitím slovníku vždy zkontroluje, že obsahuje klíč Properties, abyste předešli neočekávaným chybám.

V přetížení metody OnResume není nutné obnovovat data ze slovníku Properties. Důvodem je to, že při přechodu aplikace do pozadí zůstává i se svým stavem v paměti.
V Průzkumníkovi řešení v projektu AppLifecycleTutorial poklikáním otevřete soubor MainPage.xaml. Pak v souboru MainPage.xaml odeberte veškerý kód šablony a nahraďte ho následujícím kódem:
```
<?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>
```
Tento kód deklarativně definuje uživatelské rozhraní pro stránku, která se skládá z objektu Entry v objektu StackLayout. Vlastnost Entry.Placeholder určuje zástupný text, který se zobrazí při prvním zobrazení objektu Entry, a obslužná rutina s názvem OnEntryCompleted se zaregistruje v události Completed. Kromě toho objekt Entry má název určený atributem x:Name. Soubor kódu tak může přistupovat k objektu Entry pomocí přiřazeného názvu.
V Průzkumníkovi řešení v projektu AppLifecycleTutorial rozbalte uzel MainPage.xaml a poklikáním otevřete soubor MainPage.xaml.cs. Potom v souboru MainPage.xaml.cs přidejte do třídy přepsání metody OnAppearing a obslužnou rutinu události OnEntryCompleted:
```
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;
}
```
Metoda OnAppearing načte hodnotu vlastnosti App.DisplayText a nastaví ji jako hodnotu vlastnosti Text objektu Entry.

Poznámka:

Přepsání metody OnAppearing se spustí až po rozložení ContentPage, ale těsně předtím, než se stane viditelným. Proto je to vhodné místo pro nastavení obsahu Xamarin.Forms zobrazení.

Při dokončování zadávání textu do objektu Entry se stisknutím klávesy Return spustí metoda OnEntryCompleted a text objektu Entry se uloží do vlastnosti App.DisplayText.
Na panelu nástrojů sady Visual Studio stiskněte tlačítko Spustit (trojúhelníkové tlačítko, která se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném vzdáleném simulátoru iOSu nebo emulátoru Androidu.

Zadejte text do objektu Entry a stiskněte klávesu Return. Potom aplikaci převeďte do pozadí klepnutím na tlačítko Domů, aby se vyvolala metoda OnSleep.

V sadě Visual Studio zastavte aplikaci a pak ji znovu spusťte. Text, který jste zadali do objektu Entry, se obnoví:

V sadě Visual Studio zastavte aplikaci.

Další informace o zachování dat do slovníku vlastností naleznete v tématu Vlastnosti slovníkuXamarin.Forms v průvodci třídou aplikace.

V Oblasti řešení v projektu AppLifecycleTutorial rozbalte uzel App.xaml a poklikáním otevřete soubor App.xaml.cs. Pak v souboru App.xaml.cs odeberte veškerý kód šablony a nahraďte ho následujícím kódem:
```
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");
        }
    }
}
```
Tento kód definuje vlastnost DisplayText a konstantu displayText. Při přechodu aplikace do pozadí nebo při jejím ukončení přepsání metody OnSleep přidá hodnotu vlastnosti DisplayText do slovníku Properties oproti klíči displayText. Po spuštění aplikace se za předpokladu, že slovník Properties obsahuje klíčdisplayText, obnoví hodnota klíče ve vlastnosti DisplayText.

Důležité

Před použitím slovníku vždy zkontroluje, že obsahuje klíč Properties, abyste předešli neočekávaným chybám.

V přetížení metody OnResume není nutné obnovovat data ze slovníku Properties. Důvodem je to, že při přechodu aplikace do pozadí zůstává i se svým stavem v paměti.
V Oblasti řešení v projektu AppLifecycleTutorial poklikáním otevřete soubor MainPage.xaml. Pak v souboru MainPage.xaml odeberte veškerý kód šablony a nahraďte ho následujícím kódem:
```
<?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>
```
Tento kód deklarativně definuje uživatelské rozhraní pro stránku, která se skládá z objektu Entry v objektu StackLayout. Vlastnost Entry.Placeholder určuje zástupný text, který se zobrazí při prvním zobrazení objektu Entry, a obslužná rutina s názvem OnEntryCompleted se zaregistruje v události Completed. Kromě toho objekt Entry má název určený atributem x:Name. Soubor kódu tak může přistupovat k objektu Entry pomocí přiřazeného názvu.
V Oblasti řešení v projektu AppLifecycleTutorial rozbalte uzel MainPage.xaml a poklikáním otevřete soubor MainPage.xaml.cs. Potom v souboru MainPage.xaml.cs přidejte do třídy přepsání metody OnAppearing a obslužnou rutinu události OnEntryCompleted:
```
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;
}
```
Metoda OnAppearing načte hodnotu vlastnosti App.DisplayText a nastaví ji jako hodnotu vlastnosti Text objektu Entry.

Poznámka:

Přepsání metody OnAppearing se spustí až po rozložení ContentPage, ale těsně předtím, než se stane viditelným. Proto je to vhodné místo pro nastavení obsahu Xamarin.Forms zobrazení.

Při dokončování zadávání textu do objektu Entry se stisknutím klávesy Return spustí metoda OnEntryCompleted a text objektu Entry se uloží do vlastnosti App.DisplayText.
Na panelu nástrojů sady Visual Studio pro Mac stiskněte tlačítko Spustit (trojúhelníkové tlačítko, která se podobá tlačítku Přehrát), aby se aplikace spustila ve zvoleném simulátoru iOSu nebo emulátoru Androidu.

Zadejte text do objektu Entry a stiskněte klávesu Return. Potom aplikaci převeďte do pozadí klepnutím na tlačítko Domů, aby se vyvolala metoda OnSleep.

V sadě Visual Studio pro Mac zastavte aplikaci a pak ji znovu spusťte. Text, který jste zadali do objektu Entry, se obnoví:

V sadě Visual Studio pro Mac zastavte aplikaci.

Další informace o zachování dat do slovníku vlastností naleznete v tématu Vlastnosti slovníkuXamarin.Forms v průvodci třídou aplikace.

Xamarin.Forms Kurz životního cyklu aplikace

Reakce na změny stavu životního cyklu

Uchovávání dat napříč změnami stavu životního cyklu

Gratulujeme!

Další kroky

Xamarin.Forms Kurz životního cyklu aplikace

Reakce na změny stavu životního cyklu

Uchovávání dat napříč změnami stavu životního cyklu

Gratulujeme!

Další kroky

Související odkazy