Руководство: Создание приложения оболочки .NET MAUI
Это руководство является частью 2 серии, демонстрирующей создание приложения оболочки .NET Multi-platform App UI (.NET MAUI) и подготовка его к проверке подлинности с помощью Центра администрирования Microsoft Entra. В части 1 этой сериивы зарегистрировали приложение и настроили потоки пользователей во внешнем клиенте. В этом руководстве вы добавите пользовательский вспомогательный модуль клиента Microsoft Authentication Library (MSAL) для инициализации MSAL SDK, установите необходимые библиотеки и включите ресурс изображения.
В этом руководстве описано, как это сделать.
- Создайте приложение оболочки .NET MAUI.
- Добавьте поддержку пакета SDK MSAL с помощью вспомогательных классов MSAL.
- Установите необходимые пакеты.
- Добавьте ресурс изображения.
Необходимые условия
- руководство по . Регистрация и настройка мобильного приложения .NET MAUI во внешнем клиенте
- пакет SDK для .NET
- Visual Studio 2022 с установленной рабочей нагрузкой MAUI:
Создайте приложение оболочки .NET MAUI
- В окне запуска Visual Studio 2022 выберите Создать проект.
- В окне Создание нового проекта выберите MAUI в раскрывающемся списке "Все типы проектов", выберите шаблон приложения .NET MAUI и выберите далее.
- В окне
Настройка нового проекта имя проектадолжно иметь значение SignInMaui . Обновите имя решения, чтобы войти в maui и выбратьNext . - В окне
Дополнительные сведения выберите последнюю версиюпакета SDK для .NET и выберите Создать .
Подождите, пока проект будет создан и восстановлены его зависимости.
Добавление поддержки пакета 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
- В области обозревателя решений щелкните правой кнопкой мыши проект SignInMaui и выберите Добавить>Новая папка. Присвойте папке имя MSALClient.
- Щелкните правой кнопкой мыши папку MSALClient, выберите Добавить>Существующий элемент....
- Перейдите в папку, содержащую скачанные файлы MSALClient, скачанные ранее.
- Выберите все скачанные файлы 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, выполните следующие действия.
- Выберите Инструменты>Диспетчер пакетов NuGet>Управление пакетами NuGet для решения....
- На вкладке Обзор найдите Microsoft.Identity.Client.
- Выберите Microsoft.Identity.Client в списке.
- Выберите SignInMaui в области списка Project.
- Выберите Установить.
- Если вам будет предложено проверить установку, нажмите кнопку ОК.
Повторите процесс, чтобы установить оставшиеся необходимые пакеты.
Добавление ресурса изображения
В этом разделе вы скачайте образ, используемый в приложении, чтобы улучшить взаимодействие пользователей с ним.
Скачайте следующий образ:
- Значок : Microsoft Entra ID. Это изображение используется в качестве значка на главной странице.
Перемещение изображения с помощью Visual Studio
- В панели обозревателя решений
Visual Studio раскройте папку ресурсов , чтобы открыть папкуизображений . - Щелкните правой кнопкой мыши на Изображения и выберите Добавить>существующий элемент....
- Перейдите в папку, содержащую скачанные изображения.
- Измените фильтр на фильтр по типу файла: файлы изображений.
- Выберите скачанный образ.
- Выберите Добавить.