Samouczek: tworzenie aplikacji powłoki MAUI platformy .NET

Ten samouczek jest częścią serii, część 2, która pokazuje, jak utworzyć powłokową aplikację międzyplatformową .NET MAUI i przygotować ją do uwierzytelniania za pomocą centrum administracyjnego Microsoft Entra. W części 1 tej seriizarejestrowałeś aplikację i skonfigurowałeś przepływy użytkowników w swojej zewnętrznej dzierżawie. W tym samouczku dodasz niestandardowy pomocnik klienta biblioteki Microsoft Authentication Library (MSAL), aby zainicjować zestaw MSAL SDK, zainstalować wymagane biblioteki i dołączyć zasób obrazu.

W tym samouczku nauczysz się:

• Utwórz aplikację typu powłoka .NET MAUI.
• Dodaj obsługę zestawu SDK MSAL przy użyciu klas pomocniczych MSAL.
• Zainstaluj wymagane pakiety.
• Dodaj zasób obrazu.

Warunki wstępne

• Samouczek : Rejestrowanie i konfigurowanie aplikacji mobilnej .NET MAUI w zewnętrznej dzierżawie
• zestawu SDK platformy .NET
• Visual Studio 2022 z zainstalowanym pakietem roboczym MAUI:
  • instrukcje dotyczące instalacji programu Visual Studio

Tworzenie aplikacji powłoki .NET MAUI

1. W oknie startowym programu Visual Studio 2022 wybierz pozycję Utwórz nowy projekt.
2. W oknie Utwórz nowy projekt, wybierz MAUI z rozwijanej listy Wszystkie typy projektów, wybierz szablon .NET MAUI App, a następnie kliknij Dalej.
3. W oknie Konfigurowanie nowego projektunazwa projektu musi być ustawiona na wartość SignInMaui. Zaktualizuj nazwę rozwiązania na sign-in-maui i wybierz Dalej.
4. W oknie Dodatkowe informacje wybierz pozycję latest .NET SDK i wybierz pozycję Create.

Poczekaj na utworzenie projektu i przywrócenie jego zależności.

Dodaj wsparcie dla MSAL SDK przy użyciu klas pomocniczych MSAL

Klient MSAL umożliwia deweloperom uzyskiwanie tokenów dostępu z dzierżawcy zewnętrznego w celu uwierzytelniania i uzyskiwania dostępu do zabezpieczonych interfejsów API sieci Web. W tej sekcji pobierasz pliki tworzące bibliotekę MSALClient.

Pobierz następujące pliki do folderu na komputerze:

• AzureAdConfig.cs — ten plik pobiera i ustawia unikatowe identyfikatory aplikacji Microsoft Entra z pliku konfiguracji aplikacji.
• DownStreamApiConfig.cs — ten plik pobiera i ustawia zakresy wywołania programu Microsoft Graph.
• DownstreamApiHelper.cs — ten plik obsługuje wyjątki występujące podczas wywoływania podrzędnego interfejsu API.
• Exception.cs — ten plik oferuje kilka metod rozszerzenia związanych z zgłaszaniem i obsługą wyjątków.
• IdentityLogger.cs — ten plik pokazuje, jak używać rejestrowania MSAL.NET.
• MSALClientHelper.cs — ten plik zawiera metody inicjowania zestawu SDK biblioteki MSAL.
• PlatformConfig.cs — ten plik zawiera metody obsługi określonej platformy. Na przykład system Windows.
• PublicClientSingleton.cs — ten plik zawiera pojedynczą implementację służącą do zawijania klasy MSALClient i skojarzonych klas w celu obsługi statycznego modelu inicjowania dla platform.
• WindowsHelper.cs — Ten plik zawiera metody do pobierania uchwytów okien.

Ważny

Nie pomijaj pobierania plików MSALClient. Są one wymagane do ukończenia tego samouczka.

Przenoszenie plików MSALClient za pomocą programu Visual Studio

1. W okienku Eksploratora rozwiązań kliknij prawym przyciskiem myszy projekt SignInMaui i wybierz pozycję Dodaj>Nowy folder. Nadaj folderowi nazwę MSALClient.
2. Kliknij prawym przyciskiem myszy folder MSALClient, wybierz Dodaj>istniejący element....
3. Przejdź do folderu zawierającego pobrane wcześniej pliki MSALClient.
4. Wybierz wszystkie pobrane pliki MSALClient, a następnie wybierz pozycję Dodaj

Instalowanie wymaganych pakietów

Należy zainstalować następujące pakiety:

• Microsoft.Identity.Client — ten pakiet zawiera pliki binarne biblioteki Microsoft Authentication Library for .NET (MSAL.NET).
• Microsoft.Extensions.Configuration.Json — ten pakiet zawiera implementację dostawcy konfiguracji JSON dla microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Binder — ten pakiet zawiera funkcjonalność do powiązywania obiektu z danymi w dostawcach konfiguracji dla Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions — ten pakiet zawiera abstrakcje konfiguracji opartej na parach klucz-wartość.
• Microsoft.Identity.Client.Extensions.Msal — ten pakiet zawiera rozszerzenia biblioteki Microsoft Authentication Library for .NET (MSAL.NET).

Menedżer pakietów NuGet

Aby użyć menedżera pakietów NuGet do zainstalowania pakietu Microsoft.Identity.Client w programie Visual Studio, wykonaj następujące kroki:

1. Wybierz Narzędzia>Menedżer pakietów NuGet>Zarządzaj pakietami NuGet dla rozwiązania....
2. Na karcie Przeglądanie wyszukaj Microsoft.Identity.Client.
3. Wybierz Microsoft.Identity.Client na liście.
4. Wybierz pozycję SignInMaui w okienku listy Project.
5. Wybierz pozycję Zainstaluj.
6. Jeśli zostanie wyświetlony monit o zweryfikowanie instalacji, wybierz pozycję OK.

Powtórz ten proces, aby zainstalować pozostałe wymagane pakiety.

Dodawanie zasobu obrazu

W tej sekcji pobierzesz obraz używany w aplikacji, aby ulepszyć sposób interakcji użytkowników z nią.

Pobierz następujący obraz:

• Icon: Microsoft Entra ID — ten obraz jest używany jako ikona na stronie głównej.

Przenoszenie obrazu za pomocą programu Visual Studio

1. W okienku eksploratora rozwiązań programu Visual Studio rozwiń folder Resources, który wyświetla folder Obrazy .
2. Kliknij prawym przyciskiem myszy pozycję Obrazy i wybierz Dodaj>istniejący element....
3. Przejdź do folderu zawierającego pobrane obrazy.
4. Zmień filtr na filtr typu pliku do „Pliki obrazów”.
5. Wybierz pobrany obraz.
6. Wybierz pozycję Dodaj.

Następny krok

Część 3: Samouczek: Logowanie się użytkowników w aplikacji powłoki .NET MAUI przy użyciu zewnętrznego dzierżawcy