Xamarin.Forms Tutorial do ciclo de vida do aplicativo

Artigo
Developer (Iniciante)
8 minutos para concluir

Antes de tentar realizar este tutorial, você deve ter concluído com sucesso:

Crie seu primeiro Xamarin.Forms início rápido do aplicativo.
Tutorial de StackLayout.
Tutorial de Entrada.

Neste tutorial, você aprenderá como:

Responder quando um aplicativo é iniciado, suspenso ou retomado.
Persistir dados entre alterações de estado do ciclo de vida.

Você usará o Visual Studio 2019 ou Visual Studio para Mac para criar um aplicativo simples que demonstra como persistir dados entre alterações de estado do ciclo de vida. Estas capturas de tela mostram o aplicativo final:

Responder a alterações de estado do ciclo de vida

7 minutos restantes

Visual Studio
Visual Studio para Mac

Para concluir este tutorial, você precisará ter o Visual Studio 2019 (versão mais recente) com a carga de trabalho Desenvolvimento mobile com .NET instalada. Além disso, você precisará de um Mac emparelhado para compilar o aplicativo do tutorial no iOS. Para obter informações sobre como instalar a plataforma Xamarin, confira Instalando o Xamarin. Para obter informações sobre como conectar o Visual Studio 2019 a um host de build Mac, confira Emparelhar com o Mac para desenvolvimento no Xamarin.iOS.

Inicie o Visual Studio e crie um novo aplicativo em branco Xamarin.Forms chamado AppLifecycleTutorial.

Importante

Os snippets de C# e XAML neste tutorial exigem que a solução seja denominada AppLifecycleTutorial. Usar um nome diferente causará erros de build ao copiar o código deste tutorial para a solução.

Para obter mais informações sobre a biblioteca do .NET Standard que é criada, consulte Anatomia de um Xamarin.Forms aplicativo no Xamarin.Forms Início Rápido Aprofundamento.
No Gerenciador de Soluções, no projeto AppLifecycleTutorial, expanda App.xaml e clique duas vezes em App.xaml.cs para abri-lo. Em seguida, em App.xaml.cs, atualize as substituições OnStart, OnSleep e OnResume da seguinte maneira:
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

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

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Esse código atualiza as substituições de método do ciclo de vida do aplicativo, com instruções Console.WriteLine que indicam quando cada método foi invocado:
- O método OnStart é invocado quando o aplicativo é iniciado.
- O método OnSleep é invocado quando o aplicativo vai para o segundo plano.
- O método OnResume é invocado quando o aplicativo é retomado em segundo plano.
Observação

Não há nenhum método de encerramento do aplicativo. Em circunstâncias normais, o encerramento do aplicativo ocorrerá do método OnSleep.
Na barra de ferramentas do Visual Studio, pressione o botão Iniciar (o botão triangular que se parece com o botão Reproduzir) para iniciar o aplicativo dentro de seu simulador remoto de iOS ou do Android Emulator escolhido. Quando o aplicativo é iniciado, o método OnStart é invocado e OnStart é gerado na janela de Saída do Visual Studio:
```
[Mono] Found as 'java_interop_jnienv_get_object_array_element'.
OnStart
[OpenGLRenderer] HWUI GL Pipeline
```
Quando o aplicativo é colocado em segundo plano (tocando no botão Página Inicial no iOS ou Android), o método OnSleep é invocado:
```
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
OnSleep
[Mono] Image addref System.Runtime.Serialization[0x83ee19c0] -> System.Runtime.Serialization.dll[0x83f57b00]: 2
```
Em seguida, quando o aplicativo é retomado em segundo plano (toque no ícone do aplicativo no iOS, toque no botão de Visão geral no Android e selecione o aplicativo AppLifecycleTutorial), o método OnResume é invocado:
```
Thread finished: <Thread Pool> #5
OnResume
[EGL_emulation] eglMakeCurrent: 0x83ee2920: ver 3 0 (tinfo 0x8357eff0)
```
Observação

Esses blocos de código mostram a saída de exemplo ao executar o aplicativo no Android.

Interrompa o aplicativo no Visual Studio.

Para obter mais informações sobre o ciclo de vida do Xamarin.Forms aplicativo, consulte Xamarin.Forms Ciclo de vida do aplicativo.

Para concluir este tutorial, você precisará ter o Visual Studio para Mac (versão mais recente), com suporte para plataforma iOS e Android, instalado. Além disso, você também precisará do Xcode (versão mais recente). Para obter mais informações sobre como instalar a plataforma Xamarin, confira Instalando o Xamarin.

Inicie Visual Studio para Mac e crie um novo aplicativo em branco Xamarin.Forms chamado AppLifecycleTutorial.

Importante

Os snippets de C# e XAML neste tutorial exigem que a solução seja denominada AppLifecycleTutorial. Usar um nome diferente causará erros de build ao copiar o código deste tutorial para a solução.

Para obter mais informações sobre a biblioteca do .NET Standard que é criada, consulte Anatomia de um Xamarin.Forms aplicativo no Xamarin.Forms Início Rápido Aprofundamento.
No Painel de Soluções, no projeto AppLifecycleTutorial, expanda App.xaml e clique duas vezes em App.xaml.cs para abri-lo. Em seguida, em App.xaml.cs, atualize as substituições OnStart, OnSleep e OnResume da seguinte maneira:
```
protected override void OnStart()
{
    Console.WriteLine("OnStart");
}

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

protected override void OnResume()
{
    Console.WriteLine("OnResume");
}
```
Esse código atualiza as substituições de método do ciclo de vida do aplicativo, com instruções Console.WriteLine que indicam quando cada método foi invocado:
- O método OnStart é invocado quando o aplicativo é iniciado.
- O método OnSleep é invocado quando o aplicativo vai para o segundo plano.
- O método OnResume é invocado quando o aplicativo é retomado em segundo plano.
Observação

Não há nenhum método de encerramento do aplicativo. Em circunstâncias normais, o encerramento do aplicativo ocorrerá do método OnSleep.

Na barra de ferramentas do Visual Studio para Mac, pressione o botão Iniciar (o botão triangular que se parece com um botão Reproduzir) para iniciar o aplicativo dentro do simulador de iOS ou do Android Emulator escolhido. Quando o aplicativo é iniciado, o método OnStart é invocado e OnStart é gerado na janela de Saída do Aplicativo do Visual Studio para 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 o aplicativo é colocado em segundo plano (tocando no botão Página Inicial no iOS ou Android), o método OnSleep é invocado:

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

Em seguida, quando o aplicativo é retomado em segundo plano (toque no ícone do aplicativo no iOS, toque no botão de Visão geral no Android e selecione o aplicativo AppLifecycleTutorial), o método OnResume é invocado:

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

Observação

Esses blocos de código mostram a saída de exemplo ao executar o aplicativo no iOS.

Interrompa o aplicativo no Visual Studio para Mac.

Para obter mais informações sobre o ciclo de vida do Xamarin.Forms aplicativo, consulte Xamarin.Forms Ciclo de vida do aplicativo.

Persistir dados entre alterações de estado do ciclo de vida

4 minutos restantes

A subclasse Application tem um dicionário Properties estático que pode ser usado para armazenar dados entre alterações de estado do ciclo de vida. Esse dicionário usa uma chave string e armazena um valor de object. O dicionário é salvo automaticamente no dispositivo e é populado novamente quando o aplicativo é reiniciado.

Importante

O dicionário Properties pode serializar apenas tipos primitivos para armazenamento.

Neste exercício, você modificará o aplicativo para persistir o texto de um Entry após ser passado para segundo plano e restaurará o texto no Entry quando o aplicativo for reiniciado.

Visual Studio
Visual Studio para Mac

No Gerenciador de Soluções, no projeto AppLifecycleTutorial, expanda App.xaml e clique duas vezes em App.xaml.cs para abri-lo. Em seguida, em App.xaml.cs, remova todo o código de modelo e substitua-o pelo código a seguir:
```
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");
        }
    }
}
```
Esse código define uma propriedade DisplayText e um constante displayText. Quando o aplicativo é colocado em segundo plano ou encerrado, a substituição do método OnSleep adiciona o valor da propriedade DisplayText ao dicionário Properties, em relação a uma chave de displayText. Em seguida, quando o aplicativo é iniciado, desde que o dicionário Properties contenha a chave displayText, o valor da chave é restaurado na propriedade DisplayText.

Importante

Sempre verifique no dicionário Properties a presença de uma chave antes de acessá-lo, a fim de evitar erros inesperados.

Não é necessário restaurar dados do dicionário Properties na sobrecarga de método OnResume. Isso ocorre porque, quando um aplicativo é colocado em segundo plano, ele e seu estado ainda estão na memória.
No Gerenciador de Soluções, no projeto AppLifecycleTutorial, clique duas vezes em MainPage.xaml para abri-lo. Em seguida, em MainPage.xaml, remova todo o código do modelo e substitua-o pelo código a seguir:
```
<?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>
```
Esse código define declarativamente a interface do usuário para a página, que é composta por um Entry em um StackLayout. A propriedade Entry.Placeholder especifica o texto de espaço reservado mostrado quando o Entry é exibido pela primeira vez e um manipulador de eventos denominado OnEntryCompleted é registrado com o evento Completed. Além disso, o Entry tem um nome especificado com o atributo x:Name. Isso permite que o arquivo code-behind acesse o objeto Entry usando o nome atribuído a ele.
No Gerenciador de Soluções, no projeto AppLifecycleTutorial, expanda MainPage.xaml e clique duas vezes em MainPage.xaml.cs para abri-lo. Em seguida, em MainPage.xaml.cs, adicione uma substituição para o método OnAppearing e o manipulador de eventos OnEntryCompleted à 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;
}
```
O método OnAppearing recupera o valor da propriedade App.DisplayText e o define como o valor de propriedade Text do Entry.

Observação

A substituição do método OnAppearing é executada após a ContentPage ser apresentada, mas apenas antes de se tornar visível. Portanto, esse é um bom lugar para definir o conteúdo dos modos de Xamarin.Forms exibição.

Quando o texto é finalizado no Entry, com a tecla de retorno, o método OnEntryCompleted é executado e o texto Entry é armazenado na propriedade App.DisplayText.
Na barra de ferramentas do Visual Studio, pressione o botão Iniciar (o botão triangular que se parece com o botão Reproduzir) para iniciar o aplicativo dentro de seu simulador remoto de iOS ou do Android Emulator escolhido.

Digite algum texto no Entry e pressione a tecla de retorno. Em seguida, coloque o aplicativo em segundo plano tocando botão Página Inicial para invocar o método OnSleep.

Interrompa e reinicie o aplicativo no Visual Studio. Dessa maneira, o texto inserido anteriormente na Entry será restaurado:

Interrompa o aplicativo no Visual Studio.

Para obter mais informações sobre como persistir dados no dicionário de propriedades, consulte Dicionário de propriedades no guia classe deXamarin.Forms aplicativo.

No Painel de Soluções, no projeto AppLifecycleTutorial, expanda App.xaml e clique duas vezes em App.xaml.cs para abri-lo. Em seguida, em App.xaml.cs, remova todo o código de modelo e substitua-o pelo código a seguir:
```
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");
        }
    }
}
```
Esse código define uma propriedade DisplayText e um constante displayText. Quando o aplicativo é colocado em segundo plano ou encerrado, a substituição do método OnSleep adiciona o valor da propriedade DisplayText ao dicionário Properties, em relação a uma chave de displayText. Em seguida, quando o aplicativo é iniciado, desde que o dicionário Properties contenha a chave displayText, o valor da chave é restaurado na propriedade DisplayText.

Importante

Sempre verifique no dicionário Properties a presença de uma chave antes de acessá-lo, a fim de evitar erros inesperados.

Não é necessário restaurar dados do dicionário Properties na sobrecarga de método OnResume. Isso ocorre porque, quando um aplicativo é colocado em segundo plano, ele e seu estado ainda estão na memória.
No Painel de Soluções, no projeto AppLifecycleTutorial, clique duas vezes em MainPage.xaml para abri-lo. Em seguida, em MainPage.xaml, remova todo o código do modelo e substitua-o pelo código a seguir:
```
<?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>
```
Esse código define declarativamente a interface do usuário para a página, que é composta por um Entry em um StackLayout. A propriedade Entry.Placeholder especifica o texto de espaço reservado mostrado quando o Entry é exibido pela primeira vez e um manipulador de eventos denominado OnEntryCompleted é registrado com o evento Completed. Além disso, o Entry tem um nome especificado com o atributo x:Name. Isso permite que o arquivo code-behind acesse o objeto Entry usando o nome atribuído a ele.
No Painel de Soluções, no projeto AppLifecycleTutorial, expanda MainPage.xaml e clique duas vezes em MainPage.xaml.cs para abri-lo. Em seguida, em MainPage.xaml.cs, adicione uma substituição para o método OnAppearing e o manipulador de eventos OnEntryCompleted à 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;
}
```
O método OnAppearing recupera o valor da propriedade App.DisplayText e o define como o valor de propriedade Text do Entry.

Observação

A substituição do método OnAppearing é executada após a ContentPage ser apresentada, mas apenas antes de se tornar visível. Portanto, esse é um bom lugar para definir o conteúdo dos modos de Xamarin.Forms exibição.

Quando o texto é finalizado no Entry, com a tecla de retorno, o método OnEntryCompleted é executado e o texto Entry é armazenado na propriedade App.DisplayText.
Na barra de ferramentas do Visual Studio para Mac, pressione o botão Iniciar (o botão triangular que se parece com um botão Reproduzir) para iniciar o aplicativo dentro do simulador de iOS ou do Android Emulator escolhido.

Digite algum texto no Entry e pressione a tecla de retorno. Em seguida, coloque o aplicativo em segundo plano tocando botão Página Inicial para invocar o método OnSleep.

Interrompa e reinicie o aplicativo no Visual Studio para Mac. Dessa maneira, o texto inserido anteriormente na Entry será restaurado:

Interrompa o aplicativo no Visual Studio para Mac.

Para obter mais informações sobre como persistir dados no dicionário de propriedades, consulte Dicionário de propriedades no guia classe deXamarin.Forms aplicativo.

Xamarin.Forms Tutorial do ciclo de vida do aplicativo

Responder a alterações de estado do ciclo de vida

Persistir dados entre alterações de estado do ciclo de vida

Parabéns!

Próximas etapas

Xamarin.Forms Tutorial do ciclo de vida do aplicativo

Responder a alterações de estado do ciclo de vida

Persistir dados entre alterações de estado do ciclo de vida

Parabéns!

Próximas etapas

Links relacionados