Začínáme s víceplatformovým uživatelským rozhraním aplikací .NET (.NET MAUI) Community Toolkit

Tento článek popisuje, jak začít používat balíčky poskytované v rámci projektu .NET MAUI Community Toolkit.

Přidání balíčků NuGet

Sada nástrojů je k dispozici jako sada balíčků NuGet, které je možné přidat do libovolného existujícího nebo nového projektu pomocí sady Visual Studio.

1. Otevřete existující projekt nebo vytvořte nový projekt podle dokumentace k nastavení .NET MAUI.

2. Na panelu Průzkumník řešení klikněte pravým tlačítkem na název projektu a vyberte Spravovat balíčky NuGet. Vyhledejte CommunityToolkit.Maui a ze seznamu zvolte požadovaný balíček NuGet.

   

3. V následujících možnostech zvolte sady nástrojů, které jsou nejvhodnější pro vaše potřeby:

CommunityToolkit.Maui

Tento balíček je kolekce animací, chování, převaděčů a vlastních zobrazení pro vývoj pomocí rozhraní .NET MAUI. Zjednodušuje a demonstruje běžné vývojářské úlohy při vytváření aplikací pro iOS, Android, macOS a Windows pomocí .NET MAUI.

Název balíčku:CommunityToolkit.Maui

Adresa URL balíčku:https://www.nuget.org/packages/CommunityToolkit.Maui

Inicializace balíčku

Nejprve je potřeba přidat příkaz using na začátek souboru MauiProgram.cs .

using CommunityToolkit.Maui;

Aby bylo možné použít sadu nástrojů správně, UseMauiCommunityToolkit musí být metoda volána ve MauiAppBuilder třídě při spuštění aplikace MauiProgram.cs soubor. Následující příklad ukazuje, jak to provést.

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

Pokud chcete použít funkce sady nástrojů, projděte si stránky dokumentace pro každou konkrétní funkci.

CommunityToolkit.Maui.Markup

Tento balíček je sada fluent pomocných metod a tříd pro zjednodušení vytváření deklarativních uživatelských rozhraní .NET MAUI v jazyce C#.

Název balíčku:CommunityToolkit.Maui.Markup

Adresa URL balíčku:https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

Inicializace balíčku

Nejprve je potřeba přidat příkaz using na začátek souboru MauiProgram.cs .

using CommunityToolkit.Maui.Markup;

Aby bylo možné použít sadu nástrojů správně, UseMauiCommunityToolkitMarkup musí být metoda volána ve MauiAppBuilder třídě při spuštění aplikace MauiProgram.cs soubor. Následující příklad ukazuje, jak to provést.

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

Pokud chcete použít funkce sady nástrojů, projděte si stránky dokumentace pro každou konkrétní funkci.

CommunityToolkit.Maui.Maps

Tento balíček umožňuje zobrazit mapu v aplikaci .NET MAUI pro Windows.

Název balíčku:CommunityToolkit.Maui.Maps

Adresa URL balíčku:https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

Inicializace balíčku

Nejprve je potřeba přidat příkaz using na začátek souboru MauiProgram.cs .

using CommunityToolkit.Maui.Maps;

Aby bylo možné správně použít Map metodu .UseMauiCommunityToolkitMaps , musí být volána ve MauiAppBuilder třídě při spuštění aplikace MauiProgram.cs soubor. Tato metoda očekává platný klíč rozhraní API Map Bing, který můžete získat prostřednictvím portálu Mapy Bing.

Následující příklad ukazuje, jak to provést.

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

Při použití mapy .NET MAUI Community Toolkit pro Windows a běžných map .NET MAUI budete muset zajistit, aby každé inicializační volání bylo provedeno pouze pro příslušnou platformu. Následující příklad ukazuje, jak to provést.

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

Další informace o inicializaci mapy v iOSu a Androidu a o tom, jak pracovat s rozhraním API pro ovládací prvky mapy, najdete v dokumentaci k mapám .NET MAUI.

CommunityToolkit.Maui.MediaElement

Tento balíček umožňuje přehrávat zvuk a video v aplikaci .NET MAUI.

Název balíčku:CommunityToolkit.Maui.MediaElement

Adresa URL balíčku:https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

Inicializace balíčku

Nejprve je potřeba přidat příkaz using na začátek souboru MauiProgram.cs .

using CommunityToolkit.Maui;

Aby bylo možné správně použít MediaElement metodu UseMauiCommunityToolkitMediaElement , musí být volána ve MauiAppBuilder třídě při spuštění aplikace MauiProgram.cs soubor. Následující příklad ukazuje, jak to provést.

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

Pokud chcete použít funkce sady nástrojů, projděte si stránky dokumentace pro každou konkrétní funkci.

CommunityToolkit.Maui.Camera

Tento balíček umožňuje připojení k fotoaparátu, zobrazení náhledu z fotoaparátu a pořizování fotek.

Název balíčku:CommunityToolkit.Maui.Camera

Adresa URL balíčku:https://www.nuget.org/packages/CommunityToolkit.Maui.Camera

Inicializace balíčku

Nejprve je potřeba přidat příkaz using na začátek souboru MauiProgram.cs .

using CommunityToolkit.Maui;

Aby bylo možné správně použít CameraView , UseMauiCommunityToolkitCamera musí být metoda volána ve MauiAppBuilder třídě při spuštění aplikace MauiProgram.cs soubor. Následující příklad ukazuje, jak to provést.

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

Pokud chcete použít funkce sady nástrojů, projděte si stránky dokumentace pro každou konkrétní funkci.

Použití balíčků NuGet

4. Povolení sady nástrojů v MauiProgram.cs:

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

4.1. Pro upřesňující nastavení nastavte CommunityToolkit.Maui.Options:

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

5. V další části dokumentace najdete další informace o implementaci konkrétních funkcí.

Další prostředky

Úložiště GitHubu v .NET MAUI Community Toolkit obsahuje zdrojový kód ukázkové aplikace, která je navržená tak, aby ukázala, jak můžete tuto sadu nástrojů použít k sestavení aplikace .NET MAUI. Upozorňujeme, že ke spuštění ukázkové aplikace budete muset naklonovat nebo stáhnout úložiště a zkompilovat zdrojový kód.

Doporučujeme vývojářům, kteří s rozhraním .NET MAUI začíná, navštívit dokumentaci k .NET MAUI .

Navštivte úložiště .NET MAUI Community Toolkit na GitHubu a podívejte se na aktuální zdrojový kód, co se chystá dál, a naklonujte úložiště. Příspěvky komunity jsou vítány!