Komma igång med .NET Multi-platform App UI (.NET MAUI) Community Toolkit

Den här artikeln beskriver hur du kommer igång med de paket som tillhandahålls som en del av .NET MAUI Community Toolkit-projektet.

Lägga till NuGet-paketen

Verktygslådan är tillgänglig som en uppsättning NuGet-paket som kan läggas till i alla befintliga eller nya projekt med hjälp av Visual Studio.

1. Öppna ett befintligt projekt eller skapa ett nytt projekt enligt installationsdokumentationen för .NET MAUI

2. I panelen Solution Explorer högerklickar du på projektnamnet och väljer Hantera NuGet-paket. Sök efter CommunityToolkit.Maui och välj önskat NuGet-paket i listan.

   

3. Välj de verktyg som passar bäst för dina behov från alternativen nedan:

CommunityToolkit.Maui

Det här paketet är en samling animeringar, beteenden, konverterare och anpassade vyer för utveckling med .NET MAUI. Det förenklar och demonstrerar vanliga utvecklaruppgifter när du skapar iOS-, Android-, macOS- och Windows-appar med .NET MAUI.

Paketnamn:CommunityToolkit.Maui

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

Initiera paketet

Först måste instruktionen using läggas till överst i din MauiProgram.cs-fil

using CommunityToolkit.Maui;

För att kunna använda verktygslådan UseMauiCommunityToolkit korrekt måste metoden anropas på MauiAppBuilder klassen vid start av ett program MauiProgram.cs filen. I följande exempel visas hur du utför detta.

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

Om du vill använda funktionerna i verktygslådan kan du läsa dokumentationssidorna för varje specifik funktion.

Markup

Det här paketet är en uppsättning flytande hjälpmetoder och klasser för att förenkla skapandet av deklarativa .NET MAUI-användargränssnitt i C#.

Paketnamn:CommunityToolkit.Maui.Markup

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

Initiera paketet

Först måste instruktionen using läggas till överst i din MauiProgram.cs-fil

using CommunityToolkit.Maui.Markup;

För att kunna använda verktygslådan UseMauiCommunityToolkitMarkup korrekt måste metoden anropas på MauiAppBuilder klassen vid start av ett program MauiProgram.cs filen. I följande exempel visas hur du utför detta.

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

Om du vill använda funktionerna i verktygslådan kan du läsa dokumentationssidorna för varje specifik funktion.

Kartor

Med det här paketet kan du visa en karta i .NET MAUI Windows-programmet.

Viktigt!

Bing Maps har slutat att dela ut nya API-nycklar som behövs för att den här kontrollen ska fungera. Vi bestämmer för närvarande om vi ska uppdatera den här kontrollen för att använda WinUI-kontrollen som använder Azure Maps eller att vi väntar på den officiella .NET MAUI-implementeringen från första part för detta. För närvarande innebär det att du inte kan använda den här kontrollen om du inte redan har en API-nyckel för Bing Maps. Bing Maps som helhet upphör helt och hållet den 30 juni 2025.

Paketnamn:CommunityToolkit.Maui.Maps

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

Initiera paketet

Först måste instruktionen using läggas till överst i din MauiProgram.cs-fil

using CommunityToolkit.Maui.Maps;

För att kunna använda Map korrekt .UseMauiCommunityToolkitMaps måste metoden anropas på MauiAppBuilder klassen när du startar ett program MauiProgram.cs filen. Den här metoden förväntar sig en giltig API-nyckel för Bing Maps som du kan hämta via Bing Maps-portalen.

I följande exempel visas hur du utför detta.

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

När du använder .NET MAUI Community Toolkit Map för Windows och de vanliga .NET MAUI Maps tillsammans måste du se till att varje initieringsanrop endast görs för relevant plattform. I följande exempel visas hur du gör detta.

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

Mer information om hur du initierar kartan på iOS och Android samt hur du arbetar med API:et för kartkontroll finns i dokumentationen för .NET MAUI Maps.

MediaElement

Med det här paketet kan du spela upp ljud och video i ditt .NET MAUI-program.

Paketnamn:CommunityToolkit.Maui.MediaElement

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

Initiera paketet

Först måste instruktionen using läggas till överst i din MauiProgram.cs-fil

using CommunityToolkit.Maui;

För att kunna använda MediaElement korrekt UseMauiCommunityToolkitMediaElement måste metoden anropas på MauiAppBuilder klassen när du startar ett program MauiProgram.cs filen. I följande exempel visas hur du utför detta.

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

Om du vill använda funktionerna i verktygslådan kan du läsa dokumentationssidorna för varje specifik funktion.

kamera

Med det här paketet kan du ansluta till en kamera, visa en förhandsgranskning från kameran och ta bilder.

Paketnamn:CommunityToolkit.Maui.Camera

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

Initiera paketet

Först måste instruktionen using läggas till överst i din MauiProgram.cs-fil

using CommunityToolkit.Maui;

För att kunna använda CameraView korrekt UseMauiCommunityToolkitCamera måste metoden anropas på MauiAppBuilder klassen när du startar ett program som MauiProgram.cs filen. I följande exempel visas hur du utför detta.

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

Om du vill använda funktionerna i verktygslådan kan du läsa dokumentationssidorna för varje specifik funktion.

Använda NuGet-paketen

4. Aktivera Toolkit i MauiProgram.cs:

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

4.1. För avancerade inställningar anger du CommunityToolkit.Maui.Options:

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

5. Läs resten av dokumentationen om du vill veta mer om hur du implementerar specifika funktioner.

Andra resurser

GitHub-lagringsplatsen för .NET MAUI Community Toolkit innehåller källkoden för ett exempelprogram som är utformat för att visa hur du kan använda verktygslådan för att skapa ett .NET MAUI-program. Observera att du måste klona eller ladda ned lagringsplatsen och kompilera källkoden för att kunna köra exempelprogrammet.

Vi rekommenderar utvecklare som är nya för .NET MAUI att besöka .NET MAUI-dokumentationen .

Besök GitHub-lagringsplatsen för .NET MAUI Community Toolkit för att se den aktuella källkoden, vad som kommer härnäst och klona lagringsplatsen. Community-bidrag är välkomna!