Tutorial: Criar um aplicativo .NET MAUI

Aplica-se a: Locatários de força de trabalho Locatários externos (saiba mais)

Este tutorial é a parte 1 de uma série que demonstra como criar um shell de interface de usuário multiplataforma .NET (.NET MAUI). 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ê:

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

Pré-requisitos

• Registre um novo aplicativo no Centro de administração do Microsoft Entra, configurado apenas para Contas neste diretório organizacional. Consulte Registrar um aplicativo para obter mais detalhes. Registre os seguintes valores na página visão geral do aplicativo para uso posterior:
  • ID do aplicativo (cliente)
  • ID do diretório (locatário)
• Associe seu aplicativo a um fluxo de usuário no Centro de administração do Microsoft Entra. Esse fluxo de usuário pode ser usado em vários aplicativos. Para obter mais informações, consulte Criar fluxos de usuário de inscrição de autoatendimento para aplicativos em locatários externos e Adicionar seu aplicativo ao fluxo do usuário.
• 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 o 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 MSAL

O cliente MSAL permite que os desenvolvedores adquiram tokens de segurança de um locatário externo para autenticar e acessar APIs Web protegidas. Nesta seção, você baixará 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 Microsoft Entra do arquivo de configuração do aplicativo.
• DownStreamApiConfig.cs - Esse arquivo obtém e define os escopos da chamada do Microsoft Graph.
• DownstreamApiHelper.cs - Esse arquivo manipula 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 ao tratamento de exceções.
• IdentityLogger.cs - Este arquivo demonstra como usar o registro de 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 lidar com uma plataforma específica. Por exemplo, Windows.
• PublicClientSingleton.cs - Esse arquivo contém uma implementação singleton para encapsular 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 de 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 do Gerenciador de Soluções , clique com o botão direito do mouse no projeto SignInMaui e selecione AdicionarNova Pasta. Dê à pasta o nome 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 que você baixou anteriormente.
4. Selecione todos os arquivos MSALClient e, em seguida, selecione Adicionar

Instalar 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 funcionalidade para associar um objeto a dados em provedores de configuração para Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions - Esse pacote contém abstrações da configuração baseada em par chave-valor.
• Microsoft.Identity.Client.Extensions.Msal - Esse pacote contém extensões para a Biblioteca de Autenticação da Microsoft para .NET (MSAL.NET).

Gerenciador de Pacotes NuGet

Para usar o do 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, pesquise por Microsoft.Identity.Client.
3. Selecione Microsoft.Identity.Client na lista.
4. Selecione SignInMaui no painel da lista Projeto.
5. Selecione Instalar.
6. Se for solicitado que você verifique a instalação, selecione OK.

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

Adicionar recurso de imagem

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

Baixe a imagem a seguir:

• Í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 em Arquivos de Imagem.
5. Selecione a imagem baixada.
6. Selecione Adicionar.

Próxima etapa

Parte 3: Conectar usuários no aplicativo de shell .NET MAUI usando um locatário externo