Compartilhar via

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

  • Artigo

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.

    Gerenciar Pacotes NuGet...

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

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.

Usando o(s) pacote(s) NuGet

  1. 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);
});
  1. 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!