Créer un projet de bibliothèque de classes

Pour activer les tests unitaires de vos services et viewModels, créez un projet de bibliothèque de classes distinct. Vous avez besoin de ce projet, car les projets de test unitaire WinUI ne peuvent pas référencer directement des projets d’application WinUI.

Présentation du modèle bibliothèque de classes WinUI

Le modèle de projet Bibliothèque de classes WinUI crée une bibliothèque de classes managées .NET spécifiquement conçue pour une utilisation avec des applications de bureau WinUI 3. Ce modèle fait partie du Kit de développement logiciel (SDK) de l’application Windows et fournit des fonctionnalités importantes qu’une bibliothèque de classes .NET standard n’inclut pas.

Différences clés d’une bibliothèque de classes .NET

Le modèle bibliothèque de classes WinUI diffère d’une bibliothèque de classes .NET standard de plusieurs façons importantes :

• Ciblage spécifique à Windows : il cible une infrastructure spécifique à Windows (par net8.0-windows10.0.19041.0exemple) plutôt que le .NET framework multiplateforme, donnant accès aux API Windows.
• Intégration du Kit de développement logiciel (SDK) d’application Windows : elle inclut des références aux packages NuGet, permettant d’accéder aux API WinUI 3 et du Kit de développement logiciel (SDK) Windows App.
• Prise en charge de WinUI activée : le projet inclut <UseWinUI>true</UseWinUI> dans sa configuration, en activant les tâches de génération spécifiques à WinUI et la compilation XAML.
• Identificateurs Windows Runtime : il est configuré pour les identificateurs d’exécution spécifiques à Windows (win-x86, win-x64, win-arm64).

Pourquoi utiliser une bibliothèque de classes WinUI ?

Utilisez le modèle bibliothèque de classes WinUI au lieu d’une bibliothèque de classes .NET normale lorsque votre bibliothèque doit :

• Référencer les types et contrôles WinUI 3 : le modèle de bibliothèque de classes WinUI vous permet d’utiliser des types à partir de l’espace de noms Microsoft.UI.Xaml et d’autres API du Kit de développement d'applications Windows dans le code de votre bibliothèque.
• Incluez des ressources XAML : si votre bibliothèque contient UserControls, des contrôles personnalisés ou d’autres ressources XAML, vous avez besoin du modèle bibliothèque de classes WinUI pour compiler et empaqueter correctement ces ressources.
• Intégrer à des applications WinUI : le modèle est configuré pour fonctionner en toute transparence avec les applications de bureau WinUI 3, garantissant ainsi la compatibilité avec le runtime et le modèle de déploiement du Kit de développement logiciel (SDK) d’application Windows.
• Prise en charge de la compilation de balisage XAML : le modèle inclut les tâches de génération nécessaires pour compiler des fichiers XAML dans la bibliothèque.

Quand utiliser une bibliothèque de classes .NET standard

Utilisez un projet de bibliothèque de classes .NET standard lorsque votre bibliothèque :

• Contient uniquement du code .NET pur (ViewModels, modèles, services, utilitaires)
• Ne fait référence à aucun type de Kit de développement logiciel (SDK) WinUI 3 ou Windows App
• N’inclut aucun fichier XAML ni code lié à l’interface utilisateur
• Doit être partagé entre différents types d’applications (pas seulement les applications WinUI)
• Cible plusieurs plateformes (par exemple, .NET MAUI ou ASP.NET Core) ou des systèmes d’exploitation (par exemple, Linux ou macOS)

Pour obtenir un didacticiel sur l’ajout d’une bibliothèque de classes .NET à votre solution, consultez Étendre l’application console C# et déboguer dans Visual Studio.

Pour ce tutoriel, utilisez le modèle bibliothèque de classes WinUI , car il vous permet de référencer les types WinUI si nécessaire à l’avenir, et il est spécifiquement conçu pour s’intégrer aux applications WinUI 3. Bien que nos viewModels et services ne nécessitent pas actuellement de types WinUI, l’utilisation de ce modèle offre une flexibilité et garantit une intégration appropriée à l’environnement du KIT de développement logiciel (SDK) d’application Windows.

Créer le projet WinUINotes.Bus

Créez un projet de bibliothèque de classes WinUI nommé WinUINotes.Bus pour contenir vos ViewModels, modèles et services dans la même solution que votre projet d’application WinUI.

1. Dans Visual Studio, cliquez avec le bouton droit sur la solution dans l’Explorateur de solutions.

2. Sélectionnez Ajouter>un nouveau projet....

3. Choisissez le modèle bibliothèque de classes WinUI , puis sélectionnez Suivant.

   Note

   Veillez à sélectionner la bibliothèque de classes WinUI, pas seulement la bibliothèque de classes. Le modèle bibliothèque de classes WinUI inclut des références au Kit de développement logiciel (SDK) d’application Windows et à l’infrastructure WinUI 3.

4. Nommez le projet WinUINotes.Bus et sélectionnez Créer.

5. Supprimez le fichier par défaut Class1.cs .

Ajouter des références de projet

Les références de projet permettent à votre projet d’application WinUI d’utiliser les viewModels et les services définis dans le projet de bibliothèque de classes :

1. Cliquez avec le bouton droit sur le projet WinUINotes et sélectionnez Ajouter une>référence de projet....
2. Vérifiez le projet WinUINotes.Bus , puis sélectionnez OK.

Le projet Bus contient vos ViewModels, modèles et services. Vous pouvez donc les tester indépendamment de la couche d’interface utilisateur.