Tutorial: Criar um aplicativo shell .NET MAUI

Este tutorial é a parte 2 de uma série que demonstra como criar um aplicativo shell .NET Multi-platform App UI (.NET MAUI) e prepará-lo para autenticação usando o centro de administração do Microsoft Entra. Na Parte 1 desta série, você registrou um aplicativo e configurou fluxos de usuário em seu locatário externo. Neste tutorial, você adicionará um auxiliar de cliente personalizado da Microsoft Authentication Library (MSAL) para inicializar o SDK do MSAL, instalar as bibliotecas necessárias e incluir um recurso de imagem.

Neste tutorial, você;

• Crie um aplicativo shell .NET MAUI.
• Adicione suporte ao SDK do MSAL usando classes auxiliares do MSAL.
• Instale os pacotes necessários.
• Adicionar recurso de imagem.

Pré-requisitos

• Tutorial: Registrar e configurar o aplicativo móvel .NET MAUI em um locatário externo
• SDK do .NET 7.0
• Visual Studio 2022 com a carga de trabalho MAUI instalada:
  • Instruções para Windows
  • Instruções para macOS

Criar aplicativo shell .NET MAUI

1. Na janela inicial do Visual Studio 2022, selecione Criar um novo projeto.
2. Na janela Criar um novo projeto, selecione MAUI na lista suspensa Todos os tipos de projeto, selecione o modelo Aplicativo .NET MAUI e selecione Avançar.
3. Na janela Configurar seu novo projeto, o nome do projeto deve ser definido como SignInMaui. Atualize o nome da solução para entrar-maui e selecione Avançar.
4. Na janela Informações adicionais, escolha .NET 7.0 e selecione Criar.

Aguarde até que o projeto seja criado e suas dependências sejam restauradas.

Adicionar suporte ao SDK do MSAL usando classes auxiliares do MSAL

O cliente MSAL permite que os desenvolvedores adquiram tokens de segurança de um locatário externo para autenticar e acessar APIs da Web seguras. Nesta seção, você baixa arquivos que compõem o MSALClient.

Transfira os seguintes ficheiros para uma pasta no seu computador:

• AzureAdConfig.cs - Este arquivo obtém e define os identificadores exclusivos do aplicativo Microsoft Entra a partir do arquivo de configuração do aplicativo.
• DownStreamApiConfig.cs - Este arquivo obtém e define os escopos para chamada do Microsoft Graph.
• DownstreamApiHelper.cs - Este arquivo lida com as exceções que ocorrem ao chamar a API downstream.
• Exception.cs - Este arquivo oferece alguns métodos de extensão relacionados ao lançamento e tratamento de exceções.
• IdentityLogger.cs - Este arquivo mostra como usar o registro em log MSAL.NET.
• MSALClientHelper.cs - Este arquivo contém métodos para inicializar o SDK do MSAL.
• PlatformConfig.cs - Este arquivo contém métodos para lidar com uma plataforma específica. Por exemplo, o Windows.
• PublicClientSingleton.cs - Este arquivo contém uma implementação singleton para encapsular o MSALClient e classes associadas para suportar o modelo de inicialização estática para plataformas.
• WindowsHelper.cs - Este arquivo contém métodos para recuperar o identificador da janela.

Importante

Não ignore o download dos arquivos MSALClient, eles são necessários para concluir este tutorial.

Mover os arquivos MSALClient com o Visual Studio

1. No painel Gerenciador de Soluções, clique com o botão direito do mouse no projeto SignInMaui e selecione Adicionar>Nova Pasta. Nomeie a pasta MSALClient.
2. Clique com o botão direito do mouse na pasta MSALClient, selecione Adicionar>item existente....
3. Navegue até a pasta que contém os arquivos MSALClient baixados que você baixou anteriormente.
4. Selecione todos os arquivos MSALClient que você baixou e, em seguida, selecione Adicionar

Instalar pacotes necessários

Você precisa instalar os seguintes pacotes:

• Microsoft.Identity.Client - Este pacote contém os binários da Biblioteca de Autenticação da Microsoft para .NET (MSAL.NET).
• Microsoft.Extensions.Configuration.Json - Este pacote contém a implementação do provedor de configuração JSON para Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Binder - Este pacote contém funcionalidade para vincular um objeto a dados em provedores de configuração para Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions - Este pacote contém abstrações de configuração baseada em par chave-valor.
• Microsoft.Identity.Client.Extensions.Msal - Este pacote contém extensões para a Biblioteca de Autenticação da Microsoft para .NET (MSAL.NET).

Gestor de Pacotes NuGet

Para usar o Gerenciador de pacotes NuGet para instalar o pacote Microsoft.Identity.Client no Visual Studio, execute estas etapas:

1. Selecione Ferramentas>Gerenciador de Pacotes>NuGet Gerenciar Pacotes NuGet para Solução....
2. Na guia Procurar, procure Microsoft.Identity.Client.
3. Selecione Microsoft.Identity.Client na lista.
4. Selecione SignInMaui no painel de lista Projeto .
5. Selecione Instalar.
6. Se lhe for pedido para verificar a instalação, selecione OK.

Repita o processo para instalar os pacotes necessários restantes.

Adicionar recurso de imagem

Nesta seção, você baixa uma imagem que usa em seu aplicativo para aprimorar a forma como os usuários interagem com ela.

Faça o download da seguinte imagem:

• Ícone: Microsoft Entra ID - Esta imagem é usada como ícone na página principal.

Mover a imagem com o Visual Studio

1. No painel Gerenciador de Soluções do Visual Studio, expanda a pasta Recursos, que revela a pasta Imagens.
2. Clique com o botão direito do mouse em Imagens e selecione Adicionar>item existente....
3. Navegue até a pasta que contém as imagens baixadas.
4. Altere o filtro para filtro de tipo de arquivo para Arquivos de imagem.
5. Selecione a imagem que você baixou.
6. Selecione Adicionar.

Próximo passo

Parte 3: Tutorial: Entrar em usuários no aplicativo shell .NET MAUI usando um locatário externo