Présentation du kit de ressources MVVM

Le package CommunityToolkit.Mvvm (également appelé Kit de ressources MVVM, anciennement Microsoft.Toolkit.Mvvm) est une bibliothèque MVVM moderne, rapide et modulaire. Il fait partie du kit de ressources de la communauté .NET et repose sur les principes suivants :

  • Indépendant de la plateforme et du runtime - .NET Standard 2.0, .NET Standard 2.1 et .NET 6🚀 (Indépendant de l’infrastructure d’IU)
  • Simple à récupérer et à utiliser – Aucune exigence stricte sur la structure de l’application ou les paradigmes de codage (en dehors de leur compatibilité MVVM), c’est-à-dire une utilisation flexible.
  • À la carte – Liberté de choisir les composants à utiliser.
  • Implémentation de référence – Simple et performant, il fournit des implémentations pour les interfaces incluses dans la bibliothèque de classes de base, mais qui manquent de types concrets pour les utiliser directement.

Le kit de ressources MVVM est géré et publié par Microsoft et fait partie de .NET Foundation. Il est également utilisé par plusieurs applications internes intégrées à Windows, telles que le Microsoft Store.

Ce package cible .NET Standard, afin qu’il puisse être utilisé sur n’importe quelle plateforme d’application : UWP, WinForms, WPF, Xamarin, Uno, etc., et sur n’importe quel runtime : .NET Native, .NET Core, .NET Framework ou Mono. Il s’exécute sur chacun d’eux. La surface d’API est identique dans tous les cas, ce qui le rend parfait pour la création de bibliothèques partagées.

En outre, le kit de ressources MVVM a également une cible .NET 6, qui sert à activer davantage d’optimisations internes lors de l’exécution sur .NET 6. La surface d’API publique est identique dans les deux cas, de sorte que NuGet résout toujours la meilleure version possible du package sans que les consommateurs n’aient à se soucier des API qui seront disponibles sur leur plateforme.

Mise en route

Pour installer le package à partir de Visual Studio :

  1. Dans l’Explorateur de solutions, cliquez avec le bouton droit sur le projet, puis sélectionnez Gérer les packages NuGet. Recherchez CommunityToolkit.Mvvm et installez-le.

    NuGet Packages

  2. Ajoutez une directive d’utilisation ou Imports pour utiliser les nouvelles API :

    using CommunityToolkit.Mvvm;
    
    Imports CommunityToolkit.Mvvm
    
  3. Les exemples de code sont disponibles dans les autres pages de la documentation pour le kit de ressources MVVM et dans les tests unitaires pour le projet.

Quand dois-je utiliser ce package ?

Utilisez ce package pour accéder à une collection de types standard, autonomes et légers qui fournissent une implémentation de départ pour la création d’applications modernes à l’aide du modèle MVVM. Ces types sont généralement suffisants pour que de nombreux utilisateurs puissent créer des applications sans avoir besoin de références externes supplémentaires.

Les types inclus sont les suivants :

Ce package vise à offrir autant de flexibilité que possible, afin que les développeurs soient libres de choisir les composants à utiliser. Tous les types sont faiblement couplés, de sorte qu’il est uniquement nécessaire d’inclure ce que vous utilisez. Il n’est pas obligatoire d’utiliser toute une série spécifique d’API globales, et il n’existe pas d’ensemble de modèles obligatoires qui doivent être suivis lors de la création d’applications avec ces assistances. Combinez ces blocs de construction de la manière qui correspond le mieux à vos besoins.

Ressources supplémentaires

  • Consultez l’exemple d’application (pour plusieurs infrastructures d’interface utilisateur) pour voir le kit de ressources MVVM en action.
  • Vous trouverez également d’autres exemples dans les tests unitaires.