Introdução ao Kit de Ferramentas do MVVM

O pacote CommunityToolkit.Mvvm (também conhecido como Kit de Ferramentas do MVVM, anteriormente denominadoMicrosoft.Toolkit.Mvvm) é uma biblioteca MVVM moderna, rápida e modular. Ele faz parte do Kit de Ferramentas da Comunidade .NET Toolkit e é criado de acordo com os seguintes princípios:

• Plataforma e Runtime Independentes - .NET Standard 2.0, .NET Standard 2.1 e .NET 6🚀 (Independente da Interface do Usuário)
• Simples de escolher e usar – não há requisitos estritos na estrutura do aplicativo ou nos paradigmas de codificação (fora do 'MVVM'ness), ou seja, uso flexível.
• À la carte – liberdade para escolher quais componentes usar.
• Implementação de referência – simples e com ótimo desempenho, fornecendo implementações para interfaces incluídas na Biblioteca de Classes Base, mas que não têm tipos concretos para usá-las diretamente.

O Kit de Ferramentas do MVVM é mantido e publicado pela Microsoft e faz parte do .NET Foundation. Ele também é usado por vários aplicativos internos que são integrados ao Windows, como a Microsoft Store.

Esse pacote é direcionado ao .NET Standard para que possa ser usado em qualquer plataforma de aplicativo: WinUI 3, UWP, WinForms, WPF, Xamarin, Uno e muito mais; e em qualquer runtime: .NET Native, .NET Core, .NET Framework ou Mono. Ele é executado em todos eles. A superfície da API é idêntica em todos os casos, tornando-a perfeita para a criação de bibliotecas compartilhadas.

Além disso, o Kit de Ferramentas do MVVM também tem um destino .NET 6, que é usado para habilitar mais otimizações internas ao executar no .NET 6. A superfície da API pública é idêntica em ambos os casos, portanto, o NuGet sempre resolverá a melhor versão possível do pacote sem que os consumidores precisem se preocupar com quais APIs estarão disponíveis em sua plataforma.

Introdução

Para instalar o pacote de dentro do Visual Studio:

1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e selecione Gerenciar Pacotes NuGet. Pesquise CommunityToolkit.Mvvm e instale-o.

   

2. Adicione uma diretiva using ou Imports para usar as novas APIs:

   using CommunityToolkit.Mvvm;
   

   Imports CommunityToolkit.Mvvm
   

3. Exemplos de código estão disponíveis nas outras páginas de documentos para o Kit de Ferramentas do MVVM e nos testes de unidade do projeto.

Quando devo usar esse recurso?

Use este pacote para acesso a uma coleção de tipos leves padrão e autocontidos que fornecem uma implementação inicial para a criação de aplicativos modernos usando o padrão MVVM. Esses tipos são geralmente suficientes para muitos usuários criarem aplicativos sem precisar de referências externas adicionais.

Os tipos incluídos são:

• CommunityToolkit.Mvvm.ComponentModel
  • ObservableObject
  • ObservableRecipient
  • ObservableValidator
• CommunityToolkit.Mvvm.DependencyInjection
  • Ioc
• CommunityToolkit.Mvvm.Input
  • RelayCommand
  • RelayCommand<T>
  • AsyncRelayCommand
  • AsyncRelayCommand<T>
  • IRelayCommand
  • IRelayCommand<T>
  • IAsyncRelayCommand
  • IAsyncRelayCommand<T>
• CommunityToolkit.Mvvm.Messaging
  • IMessenger
  • WeakReferenceMessenger
  • StrongReferenceMessenger
  • IRecipient<TMessage>
  • MessageHandler<TRecipient, TMessage>
• CommunityToolkit.Mvvm.Messaging.Messages
  • PropertyChangedMessage<T>
  • RequestMessage<T>
  • AsyncRequestMessage<T>
  • CollectionRequestMessage<T>
  • AsyncCollectionRequestMessage<T>
  • ValueChangedMessage<T>

Esse pacote visa oferecer o máximo de flexibilidade possível, para que os desenvolvedores sejam livres para escolher quais componentes usar. Todos os tipos são acoplados de forma flexível, de modo que só é necessário incluir o que você usa. Não há nenhum requisito para ir "all-in" com uma série específica de APIs abrangentes, nem há um conjunto de padrões obrigatórios que precisam ser seguidos ao criar aplicativos usando esses auxiliares. Combine esses blocos de construção da maneira que melhor atenda às suas necessidades.

Recursos adicionais

• Confira o aplicativo de amostra (para várias estruturas de interface do usuário) para ver o Kit de Ferramentas do MVVM em ação.
• Você também pode encontrar mais exemplos nos testes de unidade.