Introdução ao Kit de Ferramentas da .NET Multi-Platform App UI (.NET MAUI) Community

Este artigo aborda como começar a usar os pacotes fornecidos como parte do projeto .NET MAUI Community Toolkit.

Adicionando o(s) pacote(s) NuGet

O kit de ferramentas está disponível como um pacote NuGet que pode ser adicionado a qualquer projeto, novo ou existente, através do Visual Studio.

1. Abra um projeto existente ou crie um novo projeto de acordo com a documentação de instalação do .NET MAUI

2. No painel do Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto e selecione Gerenciar Pacotes NuGet. Pesquise por CommunityToolkit.Mauie escolha o Pacote NuGet desejado na lista.

   

3. Escolha os kits de ferramentas mais apropriados para suas necessidades nas opções abaixo:

CommunityToolkit.Maui

Esse pacote é uma coleção de Animações, Comportamentos, Conversores e Exibições Personalizadas para desenvolvimento com o .NET MAUI. Ele simplifica e demonstra tarefas comuns do desenvolvedor criando aplicativos iOS, Android, macOS e Windows com o .NET MAUI.

Nome do pacote: CommunityToolkit.Maui

URL do pacote: https://www.nuget.org/packages/CommunityToolkit.Maui

Como inicializar o pacote

Primeiro, a instrução using precisa ser adicionada ao início do seu arquivo MauiProgram.cs

using CommunityToolkit.Maui;

Para você usar o kit de ferramentas corretamente, o método UseMauiCommunityToolkit precisará ser chamado na classe MauiAppBuilder quando um aplicativo for inicializado no arquivo MauiProgram.cs. O exemplo a seguir mostra como fazer isso.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkit()

Para usar os recursos do kit de ferramentas, consulte as páginas de documentação de cada recurso específico.

CommunityToolkit.Maui.Markup

Esse pacote é um conjunto de métodos e classes auxiliares fluentes para simplificar a criação de interfaces de usuário declarativas do .NET MAUI em C#.

Nome do pacote: CommunityToolkit.Maui.Markup

URL do pacote: https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

Como inicializar o pacote

Primeiro, a instrução using precisa ser adicionada ao início do seu arquivo MauiProgram.cs

using CommunityToolkit.Maui.Markup;

Para você usar o kit de ferramentas corretamente, o método UseMauiCommunityToolkitMarkup precisará ser chamado na classe MauiAppBuilder quando um aplicativo for inicializado no arquivo MauiProgram.cs. O exemplo a seguir mostra como fazer isso.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMarkup()

Para usar os recursos do kit de ferramentas, consulte as páginas de documentação de cada recurso específico.

CommunityToolkit.Maui.Maps

Esse pacote permite que você exiba um mapa em seu aplicativo do Windows .NET MAUI.

Importante

O Bing Mapas parou de fornecer novas chaves de API necessárias para que esse controle funcione. No momento, estamos decidindo se devemos atualizar esse controle para usar o controle WinUI que usa o Azure Mapas ou se aguardaremos a implementação oficial do .NET MAUI para isso. Por enquanto, isso significa que você não pode usar esse controle se ainda não tiver uma chave de API do Bing Mapas. O Bing Mapas como um todo será totalmente descontinuado em 30 de junho de 2025.

Nome do pacote: CommunityToolkit.Maui.Maps

URL do pacote: https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

Como inicializar o pacote

Primeiro, a instrução using precisa ser adicionada ao início do seu arquivo MauiProgram.cs

using CommunityToolkit.Maui.Maps;

Para você usar o Map corretamente, o método .UseMauiCommunityToolkitMaps precisará ser chamado na classe MauiAppBuilder quando um aplicativo for inicializado no arquivo MauiProgram.cs. Esse método espera uma chave de API válida do Bing Mapas que você pode obter por meio do Portal do Bing Mapas.

O exemplo a seguir mostra como fazer isso.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")

Ao usar o Mapa do Kit de Ferramentas da Community do .NET MAUI para Windows e os Mapas regulares do .NET MAUI, você precisará garantir que cada chamada de inicialização seja feita apenas para a plataforma correspondente. O exemplo a seguir mostra como fazer isso.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
#if ANDROID || IOS
    .UseMauiMaps()
#elif WINDOWS
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")
#endif

Para mais informações sobre como inicializar o mapa no iOS e no Android, bem como trabalhar com a API de controle de mapas, veja a documentação dos Mapas do .NET MAUI.

CommunityToolkit.Maui.MediaElement

Esse pacote permite que você reproduza áudio e vídeo em seu aplicativo .NET MAUI.

Nome do pacote: CommunityToolkit.Maui.MediaElement

URL do pacote: https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

Como inicializar o pacote

Primeiro, a instrução using precisa ser adicionada ao início do seu arquivo MauiProgram.cs

using CommunityToolkit.Maui;

Para você usar o MediaElement corretamente, o método UseMauiCommunityToolkitMediaElement precisará ser chamado na classe MauiAppBuilder quando um aplicativo for inicializado no arquivo MauiProgram.cs. O exemplo a seguir mostra como fazer isso.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMediaElement()

Para usar os recursos do kit de ferramentas, consulte as páginas de documentação de cada recurso específico.

CommunityToolkit.Maui.Camera

Este pacote permite a você se conectar-se a uma câmera, exibir uma visualização da câmera e tirar fotos.

Nome do pacote: CommunityToolkit.Maui.Camera

URL do pacote: https://www.nuget.org/packages/CommunityToolkit.Maui.Camera

Como inicializar o pacote

Primeiro, a instrução using precisa ser adicionada ao início do seu arquivo MauiProgram.cs

using CommunityToolkit.Maui;

Para você usar o CameraView corretamente, o método UseMauiCommunityToolkitCamera precisará ser chamado na classe MauiAppBuilder quando um aplicativo for inicializado no arquivo MauiProgram.cs. O exemplo a seguir mostra como fazer isso.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitCamera()

Para usar os recursos do kit de ferramentas, consulte as páginas de documentação de cada recurso específico.

Usando o(s) pacote(s) NuGet

4. Habilitar o Kit de Ferramentas em MauiProgram.cs:

var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();
builder.UseMauiCommunityToolkit();

4.1. Para configurações avançadas, defina CommunityToolkit.Maui.Options:

builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
});

5. Confira o restante da documentação para saber mais sobre como implementar recursos específicos.

Outros recursos

O Repositório GitHub do .NET MAUI Community Toolkit contém o código-fonte de um aplicativo de exemplo projetado para mostrar como você pode usar o kit de ferramentas para criar um aplicativo .NET MAUI. Observe que você precisará clonar ou baixar o repositório e compilar o código-fonte para executar o aplicativo de exemplo.

Recomendamos que os desenvolvedores que são novos no .NET MAUI acessem a documentação do .NET MAUI .

Visite o Repositório do GitHub do .NET MAUI Community Toolkit para ver o código-fonte atual, o que vem a seguir e clonar o repositório. Contribuições da comunidade são bem-vindas!