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 i den här serien du registrerat ett program och konfigurerat användarflöden i din externa klientorganisation. Den här självstudien visar hur du skapar en .NET MAUI-skal-app, lägger till en anpassad hjälpfunktion för MSAL-klient (Microsoft Authentication Library) för att initiera MSAL SDK, installera nödvändiga bibliotek och lägga till en bildresurs.

I den här instruktionsguiden kommer du att:

• 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 tenant
• .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 Projektnamn anges till SignInMaui. Uppdatera lösningsnamnet till sign-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.

Viktig

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å projektet SignInMaui 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 nödvändiga paket

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 Pakethanterare

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 listfönstret Project.
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:

• Icon: 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 Resources, som visar mappen Images.
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 filtypsfiltret till Image Files.
5. Välj den bild som du laddade ned.
6. Välj Lägg till.

Nästa steg

del 3: Logga in användare i .NET MAUI shell-appen med hjälp av en extern tenant