Tutorial: Criar um aplicativo .NET MAUI

Este tutorial é a segunda parte de uma série que demonstra como criar um aplicativo shell de interface do usuário do aplicativo .NET multiplataforma (.NET MAUI). Na Parte 1 desta série, você registrou um aplicativo e configurou fluxos de usuários em seu locatário externo. Este tutorial demonstra como criar um aplicativo shell do .NET MAUI, adicionar um auxiliar de cliente personalizado da MSAL (Biblioteca de Autenticação da Microsoft) para inicializar o SDK da MSAL, instalar bibliotecas necessárias e incluir um recurso de imagem.

Neste tutorial, você aprenderá a:

• Criar um aplicativo shell .NET MAUI.
• Adicionar suporte ao SDK da MSAL usando classes auxiliares da MSAL.
• Instalar os pacotes necessários.
• Adicionar o recurso de imagem.

Pré-requisitos

• Tutorial: Registrar e configurar um aplicativo .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 um aplicativo .NET MAUI

1. Na janela inicial do Visual Studio 2022, selecione Criar um novo projeto.
2. Na janela Criar um 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 sign-in-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 da MSAL usando classes auxiliares da MSAL

O cliente do MSAL permite que os desenvolvedores adquiram tokens de segurança de um locatário externo para autenticar e acessar às APIs Web protegidas. Nesta seção, você fará o download dos arquivos que compõem o MSALClient.

Baixe os seguintes arquivos em uma pasta em seu computador:

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

Importante

Não deixe de fazer o download dos arquivos do MSALClient, pois eles são necessários para concluir este tutorial.

Mover os arquivos do MSALClient com o Visual Studio

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

Instalar os pacotes necessários

Você precisa instalar os seguintes pacotes:

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

Gerenciador de Pacotes NuGet

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

1. Selecione Ferramentas>Gerenciador de Pacotes NuGet>Gerenciar Pacotes NuGet para a Solução... .
2. Na guia Procurar, procure por Microsoft.Identity.Client.
3. Selecione Microsoft.Identity.Client na lista.
4. Selecione SignInMaui no painel da lista do Projeto.
5. Selecione Instalar.
6. Se for solicitado que você verifique a instalação, selecione OK.

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

Adicionar o recurso de imagem

Nesta seção, você faz o download de uma imagem que pode ser usada no aplicativo para aprimorar a forma como os usuários interagem com ele.

Faça o download da imagem a seguir:

• Ícone: Microsoft Entra ID: essa 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 revelará 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 os Arquivos de Imagem.
5. Selecione a imagem que você baixou.
6. Selecione Adicionar.

Próxima etapa

Parte 3: Faça login de usuários no aplicativo shell .NET MAUI usando um locatário externo