Udostępnij za pośrednictwem

Wprowadzenie do zestawu narzędzi Community Toolkit interfejsu użytkownika aplikacji wieloplatformowych platformy .NET (.NET MAUI) Community Toolkit

  • Artykuł

W tym artykule opisano, jak rozpocząć korzystanie z pakietów dostarczonych w ramach projektu .NET MAUI Community Toolkit.

Dodawanie pakietów NuGet

Zestaw narzędzi jest dostępny jako zestaw pakietów NuGet, które można dodać do dowolnego istniejącego lub nowego projektu przy użyciu programu Visual Studio.

  1. Otwórz istniejący projekt lub utwórz nowy projekt zgodnie z dokumentacją konfiguracji programu MAUI platformy .NET

  2. W panelu Eksplorator rozwiązań kliknij prawym przyciskiem myszy nazwę projektu i wybierz pozycję Zarządzaj pakietami NuGet. Wyszukaj ciąg CommunityToolkit.Maui i wybierz odpowiedni pakiet NuGet z listy.

    Zarządzaj pakietami NuGet...

  3. Wybierz zestawy narzędzi, które są najbardziej odpowiednie dla Twoich potrzeb, z poniższych opcji:

Ten pakiet jest kolekcją animacji, zachowań, konwerterów i widoków niestandardowych na potrzeby programowania za pomocą programu .NET MAUI. Upraszcza i demonstruje typowe zadania deweloperskie tworzące aplikacje dla systemów iOS, Android, macOS i Windows za pomocą programu .NET MAUI.

Nazwa pakietu: CommunityToolkit.Maui

Adres URL pakietu: https://www.nuget.org/packages/CommunityToolkit.Maui

Inicjowanie pakietu

Najpierw należy dodać instrukcję using na początku pliku MauiProgram.cs

using CommunityToolkit.Maui;

Aby można było poprawnie użyć zestawu narzędzi, UseMauiCommunityToolkit należy wywołać metodę w MauiAppBuilder klasie podczas uruchamiania aplikacji w pliku MauiProgram.cs . W poniższym przykładzie pokazano, jak to zrobić.

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

Aby użyć funkcji zestawu narzędzi, zapoznaj się ze stronami dokumentacji dla każdej konkretnej funkcji.

Korzystanie z pakietów NuGet

  1. Włącz zestaw narzędzi w programie MauiProgram.cs:
var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();
builder.UseMauiCommunityToolkit();

4.1. W przypadku ustawień zaawansowanych ustaw wartość CommunityToolkit.Maui.Options:

builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
});
  1. Zapoznaj się z pozostałą częścią dokumentacji, aby dowiedzieć się więcej na temat implementowania określonych funkcji.

Inne zasoby

Repozytorium GitHub zestawu narzędzi .NET MAUI Community Toolkit zawiera kod źródłowy przykładowej aplikacji, która została zaprojektowana w celu pokazania sposobu tworzenia aplikacji MAUI platformy .NET za pomocą zestawu narzędzi. Należy pamiętać, że konieczne będzie sklonowanie lub pobranie repozytorium i skompilowanie kodu źródłowego w celu uruchomienia przykładowej aplikacji.

Zalecamy deweloperom, którzy są nowi na platformie .NET MAUI, aby odwiedzić dokumentację programu .NET MAUI .

Odwiedź repozytorium .NET MAUI Community Toolkit GitHub, aby zobaczyć bieżący kod źródłowy, co będzie dalej, i sklonować repozytorium. Wkład społeczności jest mile widziany!