Начало работы с комплектом инструментов сообщества .NET Multi-platform App UI (.NET MAUI)

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

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

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

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

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

   

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

CommunityToolkit.Maui

Этот пакет представляет собой коллекцию анимаций, поведения, преобразователей и настраиваемых представлений для разработки с помощью .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()

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

Разметка

Этот пакет представляет собой набор вспомогательных методов и классов, упрощающих создание декларативных пользовательских интерфейсов .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.

Внимание

Карты Bing перестали предоставлять новые ключи API, необходимые для работы этого элемента управления. В настоящее время мы решаем, следует ли обновить этот элемент управления для использования элемента управления WinUI с Azure Maps или подождать официальной реализации .NET MAUI от первого лица. Пока это означает, что вы не можете использовать этот элемент управления, если у вас еще нет ключа API Карт Bing. Карты Bing в целом будут полностью прекращены 30 июня 2025 года.

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

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

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

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

using CommunityToolkit.Maui.Maps;

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

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

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

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

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

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

MediaElement

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

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

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

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

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

using CommunityToolkit.Maui;

Чтобы правильно использовать MediaElement, необходимо вызвать метод UseMauiCommunityToolkitMediaElement в классе MauiAppBuilder при загрузке приложения в файле MauiProgram.cs. В следующем примере показано, как это сделать. Необходимо указать, следует ли включить службу переднего плана в Android, установив enableForegroundService для параметра значение true или false. Если вам требуются расширенные уведомления мультимедиа или фоновое воспроизведение в Android, установите значение enableForegroundServicetrue при вызове UseMauiCommunityToolkitMediaElement.

Примечание. MediaElement Не требует добавления дополнительных AndroidManifest.xml разрешений для службы переднего плана. Вызов метода построителя с enableForegroundService: true достаточно, чтобы включить функции уведомлений и фонового воспроизведения. Если enableForegroundService является true, инструменты автоматически добавят все необходимые записи в манифест Android для службы переднего плана и уведомлений. Если enableForegroundService равно false и вы пытаетесь использовать функции фонового воспроизведения, в Android может возникнуть исключение.

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

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

Фотоаппарат

Этот пакет позволяет подключаться к камере, отображать предварительный просмотр с камеры и делать фотографии.

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

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

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

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

using CommunityToolkit.Maui;

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

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

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

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

4. Включение инструментария в MauiProgram.cs:

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

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

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

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

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

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

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

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