Erste Schritte mit dem .NET MAUI Community Toolkit (.NET Multi-Platform App UI)

In diesem Artikel erhalten Sie Informationen zu den ersten Schritten mit den Paketen, die im .NET MAUI Community Toolkit-Projekt bereitgestellt werden.

Hinzufügen der NuGet-Pakete

Das Toolkit ist als eine Reihe von NuGet-Paketen verfügbar, die jedem vorhandenen oder neuen Projekt mit Visual Studio hinzugefügt werden können.

1. Öffnen Sie ein vorhandenes Projekt, oder erstellen Sie ein anhand der .NET MAUI-Setupdokumentation.

2. Klicke im Bereich des Projektmappen-Explorers mit der rechten Maustaste auf den Namen deines Projekts, und wähle NuGet-Pakete verwalten aus. Suchen Sie nach CommunityToolkit.Maui, und wählen Sie das gewünschte NuGet-Paket aus der Liste aus.

   

3. Wählen Sie aus den folgenden Optionen die Toolkits aus, die für Ihre Anforderungen am besten geeignet sind:

CommunityToolkit.Maui

Dieses Paket ist eine Sammlung von Animationen, Verhaltensweisen, Konvertern und benutzerdefinierten Ansichten für die Entwicklung mit .NET MAUI. Es vereinfacht und veranschaulicht allgemeine Entwicklungsaufgaben beim Erstellen von iOS-, Android-, macOS- und Windows-Apps mit .NET MAUI.

Paketname: CommunityToolkit.Maui

Paket-URL: https://www.nuget.org/packages/CommunityToolkit.Maui

Initialisieren des Pakets

Zuerst muss die using-Anweisung oben in der Datei MauiProgram.cs hinzugefügt werden.

using CommunityToolkit.Maui;

Um das Toolkit richtig zu verwenden, muss die UseMauiCommunityToolkit-Methode in der MauiAppBuilder-Klasse beim Bootstrapping einer Anwendung in der Datei MauiProgram.cs aufgerufen werden. Das folgende Beispiel veranschaulicht, wie Sie dies durchführen.

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

Informationen zur Verwendung der Features des Toolkits finden Sie auf den Dokumentationsseiten der einzelnen Features.

CommunityToolkit.Maui.Markup

Dieses Paket umfasst Fluent-Hilfsmethoden und -klassen, die das Erstellen deklarativer .NET MAUI-Benutzeroberflächen in C# vereinfachen.

Paketname: CommunityToolkit.Maui.Markup

Paket-URL: https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

Initialisieren des Pakets

Zuerst muss die using-Anweisung oben in der Datei MauiProgram.cs hinzugefügt werden.

using CommunityToolkit.Maui.Markup;

Um das Toolkit richtig zu verwenden, muss die UseMauiCommunityToolkitMarkup-Methode in der MauiAppBuilder-Klasse beim Bootstrapping einer Anwendung in der Datei MauiProgram.cs aufgerufen werden. Das folgende Beispiel veranschaulicht, wie Sie dies durchführen.

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

Informationen zur Verwendung der Features des Toolkits finden Sie auf den Dokumentationsseiten der einzelnen Features.

CommunityToolkit.Maui.Maps

Mit diesem Paket können Sie eine Karte in Ihrer .NET MAUI-Anwendung für Windows anzeigen.

Wichtig

Bing Maps stellt keine neuen, für dieses Steuerelement erforderlichen API-Schlüssel bereit. Wir entscheiden derzeit drüber, ob wir dieses Steuerelement aktualisieren sollen, um das von Azure Maps verwendete WinUI-Steuerelement zu verwenden, oder ob wir auf die offizielle Erstanbieterbereitstellung von .NET MAUI warten sollten. Im Moment bedeutet dies, dass Sie dieses Steuerelement nicht verwenden können, wenn Sie noch keinen Bing Maps-API-Schlüssel haben. Das gesamte Bing Maps wird am 30. Juni 2025 vollständig eingestellt.

Paketname: CommunityToolkit.Maui.Maps

Paket-URL: https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

Initialisieren des Pakets

Zuerst muss die using-Anweisung oben in der Datei MauiProgram.cs hinzugefügt werden.

using CommunityToolkit.Maui.Maps;

Um Map richtig zu verwenden, muss die .UseMauiCommunityToolkitMaps-Methode für die MauiAppBuilder-Klasse beim Bootstrapping einer Anwendung in der Datei MauiProgram.cs aufgerufen werden. Diese Methode erwartet einen gültigen Bing Maps-API-Schlüssel, den Sie über das Bing Maps-Portal abrufen können.

Das folgende Beispiel veranschaulicht, wie Sie dies durchführen.

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

Wenn Sie die .NET MAUI Community Toolkit-Zuordnung für Windows und die regulären .NET MAUI-Karten zusammen verwenden, müssen Sie sicherstellen, dass jeder Initialisierungsaufruf nur für die relevante Plattform erfolgt. Das folgende Beispiel zeigt die erforderliche Vorgehensweise.

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

Weitere Informationen dazu, wie Sie die Karte unter iOS und Android initialisieren und wie Sie mit der Kartensteuerelement-API arbeiten, finden Sie in der Dokumentation zu .NET MAUI Maps.

CommunityToolkit.Maui.MediaElement

Mit diesem Paket können Sie Audio- und Videoinhalte in Ihrer .NET MAUI-Anwendung wiedergeben.

Paketname: CommunityToolkit.Maui.MediaElement

Paket-URL: https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

Initialisieren des Pakets

Zuerst muss die using-Anweisung oben in der Datei MauiProgram.cs hinzugefügt werden.

using CommunityToolkit.Maui;

Um MediaElement richtig zu verwenden, muss die UseMauiCommunityToolkitMediaElement-Methode für die MauiAppBuilder-Klasse beim Bootstrapping einer Anwendung in der Datei MauiProgram.cs aufgerufen werden. Das folgende Beispiel veranschaulicht, wie Sie dies durchführen.

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

Informationen zur Verwendung der Features des Toolkits finden Sie auf den Dokumentationsseiten der einzelnen Features.

CommunityToolkit.Maui.Camera

Mit diesem Paket können Sie eine Verbindung mit einer Kamera herstellen, eine Vorschau von der Kamera anzuzeigen und Fotos aufzunehmen.

Paketname: CommunityToolkit.Maui.Camera

Paket-URL: https://www.nuget.org/packages/CommunityToolkit.Maui.Camera

Initialisieren des Pakets

Zuerst muss die using-Anweisung oben in der Datei MauiProgram.cs hinzugefügt werden.

using CommunityToolkit.Maui;

Um CameraView richtig zu verwenden, muss die UseMauiCommunityToolkitCamera-Methode für die MauiAppBuilder-Klasse beim Bootstrapping einer Anwendung in der Datei MauiProgram.cs aufgerufen werden. Das folgende Beispiel veranschaulicht, wie Sie dies durchführen.

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

Informationen zur Verwendung der Features des Toolkits finden Sie auf den Dokumentationsseiten der einzelnen Features.

Verwenden der NuGet-Pakete

4. Aktivieren Sie das Toolkit in MauiProgram.cs:

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

4.1. Für erweiterte Einstellungen legen Sie CommunityToolkit.Maui.Options fest:

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

5. Weitere Informationen zur Implementierung bestimmter Features finden Sie in der restlichen Dokumentation.

Weitere Ressourcen

Das GitHub-Repository des .NET MAUI Community Toolkits enthält den Quellcode für eine Beispielanwendung, die zeigt, wie Sie das Toolkit zum Erstellen einer .NET MAUI-Anwendung verwenden. Beachten Sie, dass Sie das Repository klonen oder herunterladen und den Quellcode kompilieren müssen, um die Beispielanwendung auszuführen.

Wenn Sie noch nicht mit .NET MAUI vertraut sind, sollten Sie die .NET MAUI-Dokumentation konsultieren.

Im GitHub-Repository für das .NET MAUI Community Toolkit finden Sie den aktuellen Quellcode sowie Ankündigungen und erfahren, wie Sie das Repository klonen. Wir freuen uns über Beiträge aus der Community.