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

Это руководство является частью 2 серии, демонстрирующей создание приложения оболочки .NET Multi-platform App UI (.NET MAUI). В части 1 этой серии вы зарегистрировали приложение и настроили потоки пользователей во внешнем клиенте. В этом руководстве показано, как создать приложение оболочки .NET MAUI, добавить вспомогателя пользовательской библиотеки проверки подлинности Майкрософт (MSAL), чтобы инициализировать пакет SDK MSAL, установить необходимые библиотеки и включить ресурс образа.

В этом руководстве вы выполните следующие действия.

• Создайте приложение оболочки .NET MAUI.
• Добавьте поддержку пакета SDK MSAL с помощью вспомогательных классов MSAL.
• Установите необходимые пакеты.
• Добавьте ресурс изображения.

Необходимые компоненты

• Руководство. Регистрация и настройка приложения MAUI .NET в внешнем клиенте
• Пакет SDK для .NET 7.0
• Visual Studio 2022 с установленной рабочей нагрузкой MAUI:
  • Инструкции для Windows
  • Инструкции для macOS

Создание приложения .NET MAUI

1. В окне запуска Visual Studio 2022 выберите "Создать проект".
2. В окне создания проекта выберите MAUI в раскрывающемся списке "Все типы проектов", выберите шаблон приложения .NET MAUI и нажмите кнопку "Далее".
3. В окне "Настройка нового проекта" имя проекта должно иметь значение SignInMaui. Обновите имя решения для входа в maui и нажмите кнопку "Далее".
4. В окне "Дополнительные сведения" выберите .NET 7.0 и нажмите кнопку "Создать".

Дождитесь создания проекта и его зависимостей.

Добавление поддержки пакета SDK MSAL с помощью вспомогательных классов MSAL

Клиент MSAL позволяет разработчикам получать маркеры безопасности от внешнего клиента для проверки подлинности и доступа к защищенным веб-API. В этом разделе вы скачиваете файлы, составляющие MSALClient.

Скачайте следующие файлы в папку на компьютере:

• AzureAdConfig.cs . Этот файл получает и задает уникальные идентификаторы приложения Microsoft Entra из файла конфигурации приложения.
• DownStreamApiConfig.cs — этот файл получает и задает область для вызова Microsoft Graph.
• DownstreamApiHelper.cs . Этот файл обрабатывает исключения, возникающие при вызове нижестоящего API.
• Exception.cs . Этот файл предлагает несколько методов расширения, связанных с исключением и обработкой.
• IdentityLogger.cs . Этот дескриптор файла показывает, как использовать ведение журнала MSAL.NET.
• MSALClientHelper.cs. Этот файл содержит методы инициализации пакета SDK MSAL.
• PlatformConfig.cs — этот файл содержит методы для обработки конкретной платформы. Например, Windows.
• PublicClientSingleton.cs . Этот файл содержит единую реализацию, чтобы упаковать MSALClient и связанные классы для поддержки статической модели инициализации для платформ.
• WindowsHelper.cs — этот файл содержит методы для извлечения дескриптора окна.

Внимание

Не пропускайте скачивание файлов MSALClient, они необходимы для выполнения этого руководства.

Перемещение файлов MSALClient с помощью Visual Studio

1. В области Обозреватель решений щелкните правой кнопкой мыши проект SignInMaui и выберите "Добавить>новую папку". Присвойте папке MSALClient имя.
2. Щелкните правой кнопкой мыши папку MSALClient , выберите " Добавить>существующий элемент...".
3. Перейдите в папку, содержащую скачанные ранее файлы MSALClient.
4. Выберите все файлы MSALClient, а затем нажмите кнопку "Добавить".

Установка необходимых пакетов

Необходимо установить следующие пакеты:

• Microsoft.Identity.Client — Этот пакет содержит двоичные файлы библиотеки проверки подлинности Майкрософт для .NET (MSAL.NET).
• Microsoft.Extensions.Configuration.Json — Этот пакет содержит реализацию поставщика конфигурации JSON для Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Binder — Этот пакет содержит функциональные возможности для привязки объекта к данным в поставщиках конфигурации для Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions — Этот пакет содержит абстракции конфигурации на основе пар "ключ-значение".
• Microsoft.Identity.Client.Extensions.Msal — Этот пакет содержит расширения библиотеки проверки подлинности Майкрософт для .NET (MSAL.NET).

Диспетчер пакетов NuGet

Чтобы использовать диспетчер пакетов NuGet для установки пакета Microsoft.Identity.Client в Visual Studio, выполните следующие действия.

1. Выберите Инструменты>Диспетчер пакетов NuGet>Управление пакетами NuGet для решения....
2. На вкладке "Обзор" найдите Microsoft.Identity.Client.
3. Выберите Microsoft.Identity.Client в списке.
4. Выберите SignInMaui в области списка проектов .
5. Выберите Установить.
6. Если вам будет предложено проверить установку, нажмите кнопку "ОК".

Повторите процесс, чтобы установить оставшиеся необходимые пакеты.

Добавление ресурса изображения

В этом разделе вы скачайте образ, используемый в приложении, чтобы улучшить взаимодействие пользователей с ним.

Скачайте следующий образ:

• Значок: идентификатор Microsoft Entra — это изображение используется в качестве значка на главной странице.

Перемещение изображения с помощью Visual Studio

1. В области Обозреватель решений Visual Studio разверните папку "Ресурсы", которая отображает папку "Изображения".
2. Щелкните правой кнопкой мыши изображения и выберите "Добавить>существующий элемент...".
3. Перейдите в папку, содержащую скачанные изображения.
4. Измените фильтр на фильтр типа файла на "Файлы изображений".
5. Выберите скачанный образ.
6. Выберите Добавить.

Следующий шаг

Часть 3. Вход пользователей в приложение оболочки .NET MAUI с помощью внешнего клиента