Начало работы с многоплатформенным пользовательским интерфейсом приложений .NET (.NET MAUI) набор средств

В этой статье описывается, как приступить к использованию пакетов, предоставляемых в рамках проекта сообщества .NET MAUI Community набор средств.

Добавление пакетов NuGet

Набор пакетов NuGet доступен в виде набора пакетов NuGet, которые можно добавить в любой существующий или новый проект с помощью Visual Studio.

1. Открытие существующего проекта или создание нового проекта в документации по настройке .NET MAUI

2. На панели обозревателя решений щелкните название проекта правой кнопкой мыши и выберите Управление пакетами NuGet. Выполните поиск сообщества набор средств. Maui и выберите нужный пакет NuGet из списка.

   

3. Выберите наборы средств, наиболее подходящие для ваших потребностей, из следующих вариантов:

Сообщество набор средств. Мауи

Этот пакет представляет собой коллекцию анимаций, поведения, преобразователей и настраиваемых представлений для разработки с помощью .NET MAUI. Он упрощает и демонстрирует распространенные задачи разработчика по созданию приложений iOS, Android, macOS и Windows с помощью .NET MAUI.

Имя пакета:CommunityToolkit.Maui

URL-адрес пакета:https://www.nuget.org/packages/CommunityToolkit.Maui

Инициализация пакета

Сначала необходимо добавить инструкцию using в начало файла MauiProgram.cs

using CommunityToolkit.Maui;

Чтобы использовать набор средств правильно, UseMauiCommunityToolkit метод должен вызываться в MauiAppBuilder классе при загрузке приложения MauiProgram.cs-файла . В следующем примере показано, как это сделать.

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

Чтобы использовать функции набора средств, ознакомьтесь со страницами документации для каждой конкретной функции.

Сообщество набор средств. Maui.Markup

Этот пакет представляет собой набор вспомогательных методов и классов, упрощающих создание декларативных пользовательских интерфейсов .NET MAUI в C#.

Имя пакета:CommunityToolkit.Maui.Markup

URL-адрес пакета:https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

Инициализация пакета

Сначала необходимо добавить инструкцию using в начало файла MauiProgram.cs

using CommunityToolkit.Maui.Markup;

Чтобы использовать набор средств правильно, UseMauiCommunityToolkitMarkup метод должен вызываться в MauiAppBuilder классе при загрузке приложения MauiProgram.cs-файла . В следующем примере показано, как это сделать.

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

Чтобы использовать функции набора средств, ознакомьтесь со страницами документации для каждой конкретной функции.

Сообщество набор средств. Мауи. Карты

Этот пакет позволяет отобразить карту в приложении Windows для .NET MAUI.

Имя пакета:CommunityToolkit.Maui.Maps

URL-адрес пакета:https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

Инициализация пакета

Сначала необходимо добавить инструкцию using в начало файла MauiProgram.cs

using CommunityToolkit.Maui.Maps;

Чтобы правильно использовать Map метод, необходимо вызвать в MauiAppBuilder классе при загрузке приложения MauiProgram.cs-файл..UseMauiCommunityToolkitMaps Этот метод ожидает допустимый ключ API Bing Карты, который можно получить через портал Bing Карты.

В следующем примере показано, как это сделать.

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

При использовании набор средств сопоставления сообщества .NET MAUI для Windows и обычных Карты .NET MAUI необходимо убедиться, что каждый вызов инициализации выполняется только для соответствующей платформы. В приведенном ниже примере показано, как это сделать.

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

Дополнительные сведения о том, как инициализировать карту в iOS и Android, а также как работать с API управления картами, см. в документации по Карты .NET MAUI.

Сообщество набор средств. Maui.MediaElement

Этот пакет позволяет воспроизводить аудио и видео в приложении .NET MAUI.

Имя пакета:CommunityToolkit.Maui.MediaElement

URL-адрес пакета:https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

Инициализация пакета

Сначала необходимо добавить инструкцию using в начало файла MauiProgram.cs

using CommunityToolkit.Maui.MediaElement;

Чтобы правильно использовать MediaElement метод, необходимо вызвать в MauiAppBuilder классе при загрузке приложения MauiProgram.cs-файл.UseMauiCommunityToolkitMediaElement В следующем примере показано, как это сделать.

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

Чтобы использовать функции набора средств, ознакомьтесь со страницами документации для каждой конкретной функции.

Использование пакетов NuGet

4. Включение набор средств вMauiProgram.cs:

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

4.1. Для дополнительных параметров задайте community набор средств. Maui.Options:

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

5. Ознакомьтесь с остальной документацией, чтобы узнать больше о реализации конкретных функций.

Другие ресурсы

Сообщество .NET MAUI набор средств репозиторий GitHub содержит исходный код для примера приложения, предназначенного для демонстрации того, как использовать набор средств для создания приложения .NET MAUI. Обратите внимание, что вам потребуется клонировать или скачать репозиторий и скомпилировать исходный код для запуска примера приложения.

Мы рекомендуем разработчикам, которые являются новыми для .NET MAUI, чтобы посетить документацию по .NET MAUI .

Посетите репозиторий сообщества .NET MAUI набор средств репозитория GitHub, чтобы просмотреть текущий исходный код, то, что происходит дальше, и клонировать репозиторий. Мы рады любому вкладу в сообщество!