Självstudie: Skapa en .NET MAUI-app

Den här självstudien är del 2 i en serie som visar hur du skapar en .NET Multi-platform App UI(.NET MAUI)-skalapp. I del 1 av den här serien registrerade du ett program och konfigurerade användarflöden i din externa klientorganisation. Den här självstudien visar hur du skapar en .NET MAUI-gränssnittsapp, lägger till en anpassad MSAL-klienthjälp (Microsoft Authentication Library) för att initiera MSAL SDK, installera nödvändiga bibliotek och inkludera en avbildningsresurs.

I den här självstudien ska du:

• Skapa en .NET MAUI-gränssnittsapp.
• Lägg till MSAL SDK-stöd med hjälp av MSAL-hjälpklasser.
• Installera nödvändiga paket.
• Lägg till avbildningsresurs.

Förutsättningar

• Självstudie: Registrera och konfigurera en .NET MAUI-app i en extern klientorganisation
• .NET 7.0 SDK
• Visual Studio 2022 med MAUI-arbetsbelastningen installerad:
  • Instruktioner för Windows
  • Instruktioner för macOS

Skapa .NET MAUI-app

1. I startfönstret i Visual Studio 2022 väljer du Skapa ett nytt projekt.
2. I fönstret Skapa ett nytt projekt väljer du MAUI i listrutan Alla projekttyper, väljer mallen .NET MAUI-app och väljer Nästa.
3. I fönstret Konfigurera det nya projektet måste projektnamnet anges till SignInMaui. Uppdatera lösningsnamnet för att logga in-maui och välj Nästa.
4. I fönstret Ytterligare information väljer du .NET 7.0 och väljer Skapa.

Vänta tills projektet har skapats och dess beroenden ska återställas.

Lägga till MSAL SDK-stöd med hjälpklasser för MSAL

MED MSAL-klienten kan utvecklare hämta säkerhetstoken från en extern klientorganisation för att autentisera och komma åt skyddade webb-API:er. I det här avsnittet laddar du ned filer som utgör MSALClient.

Ladda ned följande filer till en mapp på datorn:

• AzureAdConfig.cs – Den här filen hämtar och anger unika identifierare för Microsoft Entra-appen från din appkonfigurationsfil.
• DownStreamApiConfig.cs – Den här filen hämtar och anger omfången för Microsoft Graph-anropet.
• DownstreamApiHelper.cs – Den här filen hanterar de undantag som inträffar när du anropar det underordnade API:et.
• Exception.cs – Den här filen erbjuder några tilläggsmetoder relaterade till undantagskastning och hantering.
• IdentityLogger.cs – Den här filreferensen visar hur du använder MSAL.NET loggning.
• MSALClientHelper.cs – Den här filen innehåller metoder för att initiera MSAL SDK.
• PlatformConfig.cs – Den här filen innehåller metoder för att hantera en specifik plattform. Till exempel Windows.
• PublicClientSingleton.cs – Den här filen innehåller en singleton-implementering för att omsluta MSALClient och associerade klasser för att stödja statisk initieringsmodell för plattformar.
• WindowsHelper.cs – Den här filen innehåller metoder för att hämta fönsterhandtag.

Viktigt!

Hoppa inte över att ladda ned MSALClient-filerna. De krävs för att slutföra den här självstudien.

Flytta MSALClient-filerna med Visual Studio

1. I fönstret Solution Explorer högerklickar du på SignInMaui-projektet och väljer Lägg till>ny mapp. Ge mappen namnet MSALClient.
2. Högerklicka på mappen MSALClient och välj Lägg till>befintligt objekt....
3. Gå till mappen som innehåller MSALClient-filerna som du laddade ned tidigare.
4. Markera alla MSALClient-filer och välj sedan Lägg till

Installera de paket som krävs

Du måste installera följande paket:

• Microsoft.Identity.Client – Det här paketet innehåller binärfilerna i Microsoft Authentication Library för .NET (MSAL.NET).
• Microsoft.Extensions.Configuration.Json – Det här paketet innehåller JSON-konfigurationsproviderimplementering för Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Binder – Det här paketet innehåller funktioner för att binda ett objekt till data i konfigurationsprovidrar för Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions – Det här paketet innehåller abstraktioner av nyckel/värde-parbaserad konfiguration.
• Microsoft.Identity.Client.Extensions.Msal – Det här paketet innehåller tillägg till Microsoft Authentication Library för .NET (MSAL.NET).

NuGet Package Manager

Följ dessa steg om du vill använda NuGet Package Manager för att installera Microsoft.Identity.Client-paketet i Visual Studio:

1. Välj Verktyg>NuGet Package Manager>Hantera NuGet-paket för lösning....
2. På fliken Bläddra söker du efter Microsoft.Identity.Client.
3. Välj Microsoft.Identity.Client i listan.
4. Välj SignInMaui i fönstret Projektlista .
5. Välj Installera.
6. Om du uppmanas att verifiera installationen väljer du OK.

Upprepa processen för att installera de återstående nödvändiga paketen.

Lägg till avbildningsresurs

I det här avsnittet laddar du ned en bild som du använder i din app för att förbättra hur användarna interagerar med den.

Ladda ned följande bild:

• Ikon: Microsoft Entra-ID – Den här bilden används som ikon på huvudsidan.

Flytta bilden med Visual Studio

1. I fönstret Solution Explorer i Visual Studio expanderar du mappen Resurser, som visar mappen Bilder.
2. Högerklicka på Bilder och välj Lägg till>befintligt objekt....
3. Navigera till mappen som innehåller de nedladdade bilderna.
4. Ändra filtret till filtypsfilter till Bildfiler.
5. Välj den bild som du laddade ned.
6. Markera Lägga till.

Gå vidare

Del 3: Logga in användare i .NET MAUI Shell-appen med hjälp av en extern klientorganisation