Introdução ao .NET Multi-platform App UI (.NET MAUI) Community Toolkit

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 conjunto de pacotes NuGet que podem ser adicionados a qualquer projeto novo ou existente usando o Visual Studio.

Abra um projeto existente ou crie um novo projeto de acordo com a documentação de instalação do .NET MAUI
No painel Gerenciador de Soluções, clique com o botão direito do mouse no nome do projeto e selecione Gerenciar pacotes NuGet. Procure CommunityToolkit.Maui e escolha o pacote NuGet desejado na lista.
Escolha o(s) conjunto(s) de ferramentas mais adequado às suas necessidades a partir das opções abaixo:

Este pacote é uma coleção de animações, comportamentos, conversores e exibições personalizadas para desenvolvimento com a MAUI do .NET. Ele simplifica e demonstra tarefas comuns do desenvolvedor criando aplicativos iOS, Android, macOS e Windows com a MAUI .NET.

Nome do pacote:CommunityToolkit.Maui

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

Inicializando o pacote

Primeiro, a instrução using precisa ser adicionada à parte superior do arquivo MauiProgram.cs

using CommunityToolkit.Maui;

Para usar o kit de ferramentas corretamente, o UseMauiCommunityToolkit método deve ser chamado na MauiAppBuilder classe ao inicializar um aplicativo, o arquivo MauiProgram.cs . O exemplo a seguir mostra como executar isso.

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

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

Este pacote é um conjunto de métodos auxiliares fluentes e classes 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

Inicializando o pacote

Primeiro, a instrução using precisa ser adicionada à parte superior do arquivo MauiProgram.cs

using CommunityToolkit.Maui.Markup;

Para usar o kit de ferramentas corretamente, o UseMauiCommunityToolkitMarkup método deve ser chamado na MauiAppBuilder classe ao inicializar um aplicativo, o arquivo MauiProgram.cs . O exemplo a seguir mostra como executar isso.

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

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

Este pacote permite que você exiba um mapa em seu aplicativo .NET MAUI para Windows.

Importante

O Bing Maps 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 Maps 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 da API do Bing Maps. O Bing Maps como um todo será descontinuado totalmente em 30 de junho de 2025.

Nome do pacote:CommunityToolkit.Maui.Maps

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

Inicializando o pacote

Primeiro, a instrução using precisa ser adicionada à parte superior do arquivo MauiProgram.cs

using CommunityToolkit.Maui.Maps;

Para usar o corretamente, Map o .UseMauiCommunityToolkitMaps método deve ser chamado na MauiAppBuilder classe ao inicializar um aplicativo, o arquivo MauiProgram.cs . Este método espera uma chave válida da API do Bing Maps que pode obter através do Portal do Bing Maps.

O exemplo a seguir mostra como executar isso.

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

Ao usar o .NET MAUI Community Toolkit Map for Windows e o .NET MAUI Maps juntos, você precisará se certificar de que cada chamada de inicialização seja feita apenas para a plataforma relevante. 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 obter mais informações sobre como inicializar o mapa no iOS e Android, bem como como trabalhar com a API de controle de mapa, consulte a documentação do .NET MAUI Maps.

Este 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

Inicializando o pacote

Primeiro, a instrução using precisa ser adicionada à parte superior do arquivo MauiProgram.cs

using CommunityToolkit.Maui;

Para usar o corretamente, MediaElement o UseMauiCommunityToolkitMediaElement método deve ser chamado na MauiAppBuilder classe ao inicializar um aplicativo, o arquivo MauiProgram.cs . O exemplo a seguir mostra como executar isso.

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

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

Este pacote permite que você se conecte a uma câmera, exiba uma visualização da câmera e tire fotos.

Nome do pacote:CommunityToolkit.Maui.Camera

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

Inicializando o pacote

Primeiro, a instrução using precisa ser adicionada à parte superior do arquivo MauiProgram.cs

using CommunityToolkit.Maui;

Para usar o CameraView corretamente, o UseMauiCommunityToolkitCamera método deve ser chamado na MauiAppBuilder classe ao inicializar um aplicativo o arquivo MauiProgram.cs . O exemplo a seguir mostra como executar isso.

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

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

Usando o(s) pacote(s) NuGet

Habilite o Toolkit 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);
});

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ê será obrigado a 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 visitem a documentação do .NET MAUI .

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

Feedback

Esta página foi útil?

Last updated on 2025-08-20

Partilhar via

Introdução ao .NET Multi-platform App UI (.NET MAUI) Community Toolkit

Adicionando o(s) pacote(s) NuGet

Inicializando o pacote

Usando o(s) pacote(s) NuGet

Outros recursos

Feedback

Recursos adicionais