Prise en main du kit d’outils de la communauté .NET Multi-Platform App UI (.NET MAUI)

Cet article explique comment commencer à utiliser les packages fournis dans le cadre du projet du kit d’outils de la communauté .NET MAUI.

Ajout du ou des packages NuGet

Le kit d’outils est disponible sous la forme d’un ensemble de packages NuGet qui peuvent être ajoutés à n’importe quel projet existant ou nouveau à l’aide de Visual Studio.

1. Ouvrez un projet existant ou créez un projet en suivant la documentation de configuration de .NET MAUI

2. Dans le volet Explorateur de solutions, cliquez avec le bouton droit sur le nom de votre projet, puis sélectionnez Gérer les packages NuGet. Recherchez CommunityToolkit.Maui, puis choisissez le package NuGet souhaité dans la liste.

   

3. Choisissez le ou les kits d’outils qui conviennent le mieux à vos besoins dans les options ci-dessous :

CommunityToolkit.Maui

Ce package est une collection d’animations, de comportements, de convertisseurs et de vues personnalisées pour développer avec .NET MAUI. Il simplifie et illustre les tâches de développement courantes lors de la génération d’applications iOS, Android, macOS et Windows avec .NET MAUI.

Nom du package :CommunityToolkit.Maui

URL du package : https://www.nuget.org/packages/CommunityToolkit.Maui

Initialisation du package

Tout d’abord, vous devez ajouter l’instruction « using » en haut de votre fichier MauiProgram.cs.

using CommunityToolkit.Maui;

Pour utiliser correctement le kit d’outils, la méthode UseMauiCommunityToolkit doit être appelée sur la classe MauiAppBuilder lors de l’amorçage du fichier MauiProgram.cs d’une application. L’exemple suivant montre comment effectuer cette opération.

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

Pour utiliser les fonctionnalités du kit d’outils, reportez-vous aux pages de documentation de chaque fonctionnalité spécifique.

CommunityToolkit.Maui.Markup

Ce package est un ensemble de méthodes et de classes d’assistance fluides pour simplifier la création d’interfaces utilisateur .NET MAUI déclaratives en C#.

Nom du package :CommunityToolkit.Maui.Markup

URL du package : https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

Initialisation du package

Tout d’abord, vous devez ajouter l’instruction « using » en haut de votre fichier MauiProgram.cs.

using CommunityToolkit.Maui.Markup;

Pour utiliser correctement le kit d’outils, la méthode UseMauiCommunityToolkitMarkup doit être appelée sur la classe MauiAppBuilder lors de l’amorçage du fichier MauiProgram.cs d’une application. L’exemple suivant montre comment effectuer cette opération.

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

Pour utiliser les fonctionnalités du kit d’outils, reportez-vous aux pages de documentation de chaque fonctionnalité spécifique.

CommunityToolkit.Maui.Maps

Ce package vous permet d’afficher une carte dans votre application Windows .NET MAUI.

Important

Bing Maps a cessé de distribuer de nouvelles clés API nécessaires pour que ce contrôle fonctionne. Nous sommes actuellement en train de décider si nous devons mettre à jour ce contrôle pour utiliser le contrôle WinUI qui utilise Azure Maps ou si nous devons attendre la mise en œuvre officielle de première partie .NET MAUI pour cela. Pour l’instant, cela signifie que vous ne pouvez pas utiliser ce contrôle si vous ne possédez pas déjà une clé API Bing Maps. Bing Maps dans son ensemble sera complètement abandonné le 30 juin 2025.

Nom du package :CommunityToolkit.Maui.Maps

URL du package : https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

Initialisation du package

Tout d’abord, vous devez ajouter l’instruction « using » en haut de votre fichier MauiProgram.cs.

using CommunityToolkit.Maui.Maps;

Pour utiliser Map correctement, la méthode .UseMauiCommunityToolkitMaps doit être appelée sur la classe MauiAppBuilder lors de l’amorçage du fichier MauiProgram.cs d’une application. Cette méthode attend une clé API Bing Maps valide que vous pouvez obtenir via le portail Bing Maps.

L’exemple suivant montre comment effectuer cette opération.

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

Lorsque vous utilisez le kit d’outils Map de la communauté .NET MAUI pour Windows et .NET MAUI Maps standard, vous devez vous assurer que chaque appel d’initialisation est effectué pour la plateforme appropriée. L’exemple suivant vous montre comment procéder.

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
#if ANDROID || IOS
    .UseMauiMaps()
#elif WINDOWS
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")
#endif

Pour plus d’informations sur l’initialisation de la carte sur iOS et Android et sur l’utilisation de l’API de contrôle de carte, consultez la documentation sur .NET MAUI Maps.

CommunityToolkit.Maui.MediaElement

Ce package vous permet de lire du contenu audio et vidéo dans votre application .NET MAUI.

Nom du package :CommunityToolkit.Maui.MediaElement

URL du package : https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

Initialisation du package

Tout d’abord, vous devez ajouter l’instruction « using » en haut de votre fichier MauiProgram.cs.

using CommunityToolkit.Maui;

Pour utiliser MediaElement correctement, la méthode UseMauiCommunityToolkitMediaElement doit être appelée sur la classe MauiAppBuilder lors de l’amorçage du fichier MauiProgram.cs d’une application. L’exemple suivant montre comment effectuer cette opération.

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

Pour utiliser les fonctionnalités du kit d’outils, reportez-vous aux pages de documentation de chaque fonctionnalité spécifique.

CommunityToolkit.Maui.Camera

Ce package vous permet de vous connecter à un appareil photo, d’afficher une préversion à partir de l’appareil photo et de prendre des photos.

Nom du package :CommunityToolkit.Maui.Camera

URL du package : https://www.nuget.org/packages/CommunityToolkit.Maui.Camera

Initialisation du package

Tout d’abord, vous devez ajouter l’instruction « using » en haut de votre fichier MauiProgram.cs.

using CommunityToolkit.Maui;

Pour utiliser CameraView correctement, la méthode UseMauiCommunityToolkitCamera doit être appelée sur la classe MauiAppBuilder lors du démarrage du fichier MauiProgram.cs d’une application. L’exemple suivant montre comment effectuer cette opération.

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

Pour utiliser les fonctionnalités du kit d’outils, reportez-vous aux pages de documentation de chaque fonctionnalité spécifique.

Utilisation du ou des packages NuGet

4. Activez le kit d’outils dans MauiProgram.cs :

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

4.1. Pour les paramètres avancés, définissez CommunityToolkit.Maui.Options :

builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
});

5. Consultez le reste de la documentation pour en savoir plus sur l’implémentation de fonctionnalités spécifiques.

Autres ressources

Le référentiel GitHub du kit d’outils de la communauté .NET MAUI contient le code source d’un exemple d’application conçu pour montrer comment utiliser le kit pour créer une application .NET MAUI. Veuillez noter que vous devrez cloner ou télécharger le référentiel et compiler le code source pour exécuter l’exemple d’application.

Nous recommandons aux développeurs qui débutent avec .NET MAUI de consulter la documentation .NET MAUI.

Consultez le référentiel GitHub du kit d’outils de la communauté .NET MAUI pour voir le code source actuel, savoir ce qui vient ensuite et cloner le référentiel. Les contributions de la communauté sont les bienvenues !