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

Применимо: Арендаторы рабочей силы Внешние арендаторы (узнать больше)

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

Изучив это руководство, вы:

Предпосылки

• Зарегистрируйте новое приложение в Центре администрирования Microsoft Entra, настроенное только для учетных записей в этом каталоге организации. Дополнительные сведения см. в статье "Регистрация приложения ". Запишите следующие значения на странице обзора приложения для последующего использования:
  • Идентификатор приложения (клиента)
  • Идентификатор каталога (арендатора)
• Свяжите приложение с потоком пользователя в Центре администрирования Microsoft Entra. Этот поток пользователя можно использовать в нескольких приложениях. Для получения дополнительной информации см. статью Создание потоков пользователей для самостоятельной регистрации приложений во внешних клиентах и Добавление приложения в поток пользователя.
• Пакет SDK для .NET 7.0
• Visual Studio 2022 с установленной рабочей нагрузкой MAUI:
  • инструкции для Windows
  • Инструкции для macOS

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

1. В окне запуска Visual Studio 2022 выберите Создать проект.
2. В окне Создание нового проекта выберите MAUI в раскрывающемся списке Все типы проектов, выберите шаблон Приложение .NET MAUI и выберите Далее.
3. В окне Настройка нового проекта, имя проекта должно быть установлено как SignInMaui. Обновите имя решения , чтобы войти в maui и выбрать Next.
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 с помощью 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 в области списка Project.
5. Нажмите Установить.
6. Если вам будет предложено проверить установку, нажмите кнопку ОК.

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

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

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

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

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

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

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

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