Samouczek: tworzenie aplikacji powłoki MAUI platformy .NET

Ten samouczek jest częścią 2 serii, która pokazuje, jak utworzyć aplikację powłoki interfejsu użytkownika aplikacji wieloplatformowej platformy .NET (.NET MAUI) i przygotować ją do uwierzytelniania przy użyciu centrum administracyjnego firmy Microsoft Entra. W części 1 tej serii zarejestrowano aplikację i skonfigurowano przepływy użytkowników w dzierżawie zewnętrznej. 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 wykonasz następujące instrukcje:

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

Wymagania wstępne

• Samouczek: rejestrowanie i konfigurowanie aplikacji mobilnej .NET MAUI w dzierżawie zewnętrznej
• Zestaw SDK platformy .NET 7.0
• Program Visual Studio 2022 z zainstalowanym obciążeniem MAUI:
  • Instrukcje dotyczące systemu Windows
  • Instrukcje dotyczące systemu macOS

Tworzenie aplikacji powłoki MAUI platformy .NET

1. W oknie startowym programu Visual Studio 2022 wybierz pozycję Utwórz nowy projekt.
2. W oknie Tworzenie nowego projektu wybierz pozycję MAUI z listy rozwijanej Wszystkie typy projektów, wybierz szablon aplikacja .NET MAUI, a następnie wybierz przycisk Dalej.
3. W oknie Konfigurowanie nowego projektu nazwa projektu musi być ustawiona na SignInMaui. Zaktualizuj nazwę rozwiązania, aby zalogować się do programu maui, a następnie wybierz pozycję Dalej.
4. W oknie Dodatkowe informacje wybierz pozycję .NET 7.0 i wybierz pozycję Utwórz.

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

Dodawanie obsługi zestawu MSAL SDK przy użyciu klas pomocnika biblioteki MSAL

Klient biblioteki MSAL umożliwia deweloperom uzyskiwanie tokenów zabezpieczających z dzierżawy zewnętrznej w celu uwierzytelniania i uzyskiwania dostępu do zabezpieczonych internetowych interfejsów API. 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 wyjątków i obsługą.
• IdentityLogger.cs — ten plik obsługuje sposób korzystania z 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 pobierania uchwytu okna.

Ważne

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 Eksplorator rozwiązań kliknij prawym przyciskiem myszy projekt SignInMaui i wybierz polecenie Dodaj>nowy folder. Nadaj folderowi nazwę MSALClient.
2. Kliknij prawym przyciskiem myszy folder MSALClient , wybierz pozycję 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 funkcje powiązania obiektu z danymi u dostawców konfiguracji 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).

NuGet Package Manager

Aby zainstalować pakiet Microsoft.Identity.Client w programie Visual Studio przy użyciu Menedżer pakietów NuGet, wykonaj następujące kroki:

1. Wybierz pozycję Narzędzia>NuGet Menedżer pakietów> Zarządzanie pakietami NuGet dla rozwiązania....
2. Na karcie Przeglądaj wyszukaj pozycję Microsoft.Identity.Client.
3. Wybierz pozycję Microsoft.Identity.Client na liście.
4. Wybierz pozycję SignInMaui w okienku Listy projektów .
5. Wybierz Zainstaluj.
6. Jeśli zostanie wyświetlony monit o zweryfikowanie instalacji, wybierz przycisk 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:

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

Przenoszenie obrazu za pomocą programu Visual Studio

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

Następny krok

Część 3. Samouczek: logowanie użytkowników w aplikacji powłoki MAUI platformy .NET przy użyciu dzierżawy zewnętrznej