Поделиться через

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

  • Статья

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

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

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

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

Создание приложения оболочки .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. Если вам будет предложено проверить установку, нажмите кнопку "ОК".

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

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

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

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

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

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

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

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