Tutorial: Creación de una aplicación de shell de MAUI de .NET
Este tutorial es la parte 2 de una serie que muestra cómo crear una aplicación de shell de interfaz de usuario de aplicaciones multiplataforma de .NET (.NET MAUI) y prepararla para la autenticación mediante el Centro de administración de Microsoft Entra. En la parte 1 de esta serie, registró una aplicación y configuró los flujos de usuario en el inquilino externo. En este tutorial, agregará un asistente de cliente personalizado de la Biblioteca de autenticación de Microsoft (MSAL) para inicializar el SDK de MSAL, instalará las bibliotecas necesarias e incluirá un recurso de imagen.
En este tutorial, aprenderás;
- Cree una aplicación de shell de .NET MAUI.
- Agregue compatibilidad con el SDK de MSAL mediante clases auxiliares de MSAL.
- Instale los paquetes necesarios.
- Agregue el recurso de imagen.
Prerrequisitos
- Tutorial: Registro y configuración de la aplicación móvil MAUI de .NET en un inquilino externo
- SDK DE .NET
- Visual Studio 2022 con la carga de trabajo de MAUI instalada:
Crear una aplicación de shell de .NET MAUI
- En la ventana de inicio de Visual Studio 2022, seleccione Crear un nuevo proyecto.
- En la ventana Crear un nuevo proyecto, seleccione MAUI en la lista desplegable Todos los tipos de proyecto, seleccione la plantilla Aplicación de .NET MAUI y seleccione Siguiente.
- En la ventana Configurar el nuevo proyecto, Nombre del proyecto debe establecerse en SignInMaui. Actualice el Nombre de la solución para iniciar sesión en maui y seleccione Siguiente.
- En la ventana Información adicional, elija el SDK de .NET más reciente y seleccione Crear.
Espere a que se creen los proyectos y se restauren sus dependencias.
Adición de compatibilidad con el SDK de MSAL mediante clases auxiliares de MSAL
El cliente MSAL permite a los desarrolladores adquirir tokens de seguridad de un inquilino externo para autenticar y acceder a las API web protegidas. En esta sección, descargará archivos que componen MSALClient.
Descargue los archivos siguientes en una carpeta del equipo:
- AzureAdConfig.cs: este archivo obtiene y establece los identificadores únicos de la aplicación Microsoft Entra del archivo de configuración de la aplicación.
- DownStreamApiConfig.cs: este archivo obtiene y establece los ámbitos de la llamada a Microsoft Graph.
- DownstreamApiHelper.cs: este archivo controla las excepciones que se producen al llamar a la API de bajada.
- Exception.cs: Este archivo ofrece algunos métodos de extensión relacionados con el lanzamiento y manejo de excepciones.
- IdentityLogger.cs - Este archivo muestra cómo usar el registro de MSAL.NET.
- MSALClientHelper.cs: este archivo contiene métodos para inicializar el SDK de MSAL.
- PlatformConfig.cs: este archivo contiene métodos para controlar una plataforma específica. Por ejemplo, Windows.
- PublicClientSingleton.cs: este archivo contiene una implementación singleton para encapsular MSALClient y las clases asociadas para admitir el modelo de inicialización estática para las plataformas.
- WindowsHelper.cs: este archivo contiene métodos para recuperar el identificador de ventana.
Importante
No omita la descarga de los archivos MSALClient, que son necesarios para completar este tutorial.
Mover los archivos MSALClient con Visual Studio
- En el panel Explorador de soluciones, haga clic con el botón derecho en el proyecto SignInMaui y seleccione Agregar>Nueva carpeta. Asigne un nombre a la carpeta MSALClient.
- Haga clic con el botón derecho en la carpeta MSALClient y seleccione Agregar>Elemento existente....
- Vaya a la carpeta que contiene los archivos MSALClient descargados que descargó anteriormente.
- Seleccione todos los archivos MSALClient que descargó y, a continuación, seleccione Agregar
Instalación de paquetes necesarios
Debe instalar los siguientes paquetes:
- Microsoft.Identity.Client: este paquete contiene los archivos binarios de la biblioteca de autenticación de Microsoft para .NET (MSAL.NET).
- Microsoft.Extensions.Configuration.Json: este paquete contiene la implementación del proveedor de configuración JSON para Microsoft.Extensions.Configuration.
- microsoft.Extensions.Configuration.Binder: este paquete contiene funcionalidad para enlazar un objeto a datos de proveedores de configuración para Microsoft.Extensions.Configuration.
- Microsoft.Extensions.Configuration.Abstractions: este paquete contiene abstracciones de la configuración basada en pares clave-valor.
- Microsoft.Identity.Client.Extensions.Msal: este paquete contiene extensiones a la Biblioteca de autenticación de Microsoft para .NET (MSAL.NET).
Administrador de paquetes NuGet
Para usar el Administrador de paquetes NuGet para instalar el paquete Microsoft.Identity.Client en Visual Studio, siga estos pasos:
- Seleccione Tools>Administrador de paquetes NuGet>Administrar paquetes NuGet para la solución....
- En la pestaña Examinar, busque Microsoft.Identity.Client.
- Seleccione Microsoft.Identity.Client en la lista.
- Seleccione SignInMaui en el panel de lista Proyecto.
- Seleccione Instalar.
- Si se le pide que compruebe la instalación, seleccione Aceptar.
Repita el proceso para instalar los paquetes necesarios restantes.
Adición de un recurso de imagen
En esta sección, descargarás una imagen que usas en tu aplicación para mejorar cómo interactúan los usuarios con ella.
Descargue la siguiente imagen:
- Icono: Microsoft Entra ID: esta imagen se usa como icono en la página principal.
Mover la imagen con Visual Studio
- En el panel Explorador de soluciones de Visual Studio, expanda la carpeta Recursos, que muestra la carpeta Imágenes.
- Haga clic con el botón derecho en Imágenes y seleccione Agregar>Elemento existente....
- Vaya a la carpeta que contiene las imágenes descargadas.
- Cambie el filtro al filtro de tipo de archivo a Archivos de imagen.
- Seleccione la imagen que descargó.
- Seleccione Agregar.