Xamarin.Essentials: Tópico principal

  • Artigo

A classe MainThread permite que os aplicativos executem o código no thread de execução principal e determinem se certo bloco de código está sendo executado no thread principal.

Tela de fundo

A maioria dos sistemas operacionais, incluindo iOS, Android e a Plataforma Universal do Windows, usa um modelo de threading simples para o código que envolve a interface do usuário. Esse modelo é necessário para serializar adequadamente os eventos da interface do usuário, incluindo pressionamentos de tecla e entrada de toque. Este thread é frequentemente chamado de thread principal ou o thread da interface do usuário ou, ainda, o thread da IU. A desvantagem desse modelo é que todo código que acessa os elementos da interface do usuário deve ser executado no thread principal do aplicativo.

Às vezes, os aplicativos precisam usar eventos que chamam o manipulador de eventos em um thread de execução secundário. (As Xamarin.Essentials classes Accelerometer, Compass, , MagnetometerGyroscope, e OrientationSensor all podem retornar informações em um thread secundário quando usadas com velocidades mais rápidas.) Se o manipulador de eventos precisar acessar elementos da interface do usuário, ele deverá executar esse código no thread principal. A classe MainThread permite que os aplicativos executem esse código no thread principal.

Introdução

Para começar a usar essa API, leia o guia de introdução para Xamarin.Essentials garantir que a biblioteca esteja instalada e configurada corretamente em seus projetos.

Como executar códigos no Thread Principal

Adicione uma referência a Xamarin.Essentials em sua classe:

using Xamarin.Essentials;

Para executar o código no thread principal, chame o método MainThread.BeginInvokeOnMainThread estático. O argumento é um objeto Action, que é simplesmente um método sem argumentos e sem valor de retorno:

MainThread.BeginInvokeOnMainThread(() =>
{
    // Code to run on the main thread
});

Também é possível definir um método separado para o código que deverá ser executado no thread principal:

void MyMainThreadCode()
{
    // Code to run on the main thread
}

Você pode executar esse método no thread principal fazendo referência a ele no método BeginInvokeOnMainThread:

MainThread.BeginInvokeOnMainThread(MyMainThreadCode);

Observação

Xamarin.Forms tem um método chamado Device.BeginInvokeOnMainThread(Action) que faz a mesma coisa que MainThread.BeginInvokeOnMainThread(Action). Embora você possa usar qualquer um dos métodos em um Xamarin.Forms aplicativo, considere se o código de chamada tem ou não alguma outra necessidade de dependência do Xamarin.Forms. Caso contrário, é provável que MainThread.BeginInvokeOnMainThread(Action) seja uma opção melhor.

Como determinar se o código está em execução no thread principal

A classe MainThread também permite que um aplicativo determine se certo bloco de código está em execução no thread principal. A propriedade IsMainThread retorna true se o código que chama a propriedade estiver em execução no thread principal. Um programa pode usar essa propriedade para executar um código diferente no thread principal ou em um thread secundário:

if (MainThread.IsMainThread)
{
    // Code to run if this is the main thread
}
else
{
    // Code to run if this is a secondary thread
}

Você pode se perguntar se deve verificar se o código está sendo executado em um thread secundário antes de chamar BeginInvokeOnMainThread, por exemplo:

if (MainThread.IsMainThread)
{
    MyMainThreadCode();
}
else
{
    MainThread.BeginInvokeOnMainThread(MyMainThreadCode);
}

Você pode suspeitar que essa verificação possa melhorar o desempenho se o bloco de código já estiver em execução no thread principal.

No entanto, essa verificação não é necessária. As implementações da plataforma de BeginInvokeOnMainThread verificam se a chamada é feita no thread principal. A perda de desempenho é pouca se você chamar BeginInvokeOnMainThread quando não for realmente necessário.

Métodos adicionais

A classe MainThread inclui os seguintes métodos static adicionais que podem ser usados para interagir com elementos da interface do usuário dos threads em segundo plano:

Método Argumentos Devoluções Finalidade
InvokeOnMainThreadAsync<T> Func<T> Task<T> Invoca um Func<T> no thread principal e aguarda sua conclusão.
InvokeOnMainThreadAsync Action Task Invoca um Action no thread principal e aguarda sua conclusão.
InvokeOnMainThreadAsync<T> Func<Task<T>> Task<T> Invoca um Func<Task<T>> no thread principal e aguarda sua conclusão.
InvokeOnMainThreadAsync Func<Task> Task Invoca um Func<Task> no thread principal e aguarda sua conclusão.
GetMainThreadSynchronizationContextAsync Task<SynchronizationContext> Retorna o SynchronizationContext para o thread principal.

API

Encontre mais vídeos sobre o Xamarin no Channel 9 e no YouTube.