Samouczek: tworzenie aplikacji 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). W części 1 tej serii zarejestrowano aplikację i skonfigurowano przepływy użytkowników w dzierżawie zewnętrznej. W tym samouczku pokazano, jak utworzyć aplikację powłoki .NET MAUI, dodać 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 shell .NET MAUI.
- Dodaj obsługę biblioteki SDK MSAL przy użyciu klas pomocniczych MSAL.
- Zainstaluj wymagane pakiety.
- Dodaj zasób obrazu.
Warunki wstępne
- Poradnik: rejestrowanie i konfigurowanie aplikacji MAUI platformy .NET w zewnętrznym tenantcie
- zestaw SDK platformy .NET 7.0
-
Visual Studio 2022 z zainstalowanym pakietem funkcji MAUI:
- Instrukcje dotyczące systemu Windows
- Instrukcje dotyczące systemu macOS
Tworzenie aplikacji .NET MAUI
- W oknie startowym programu Visual Studio 2022 wybierz pozycję Utwórz nowy projekt.
- W oknie Utwórz nowy projekt wybierz pozycję MAUI z listy rozwijanej Wszystkie typy projektów, wybierz szablon .NET MAUI App, a następnie wybierz pozycję Dalej.
- W oknie Konfigurowanie nowego projektunazwa projektu musi być ustawiona na wartość SignInMaui. Zaktualizuj nazwę rozwiązania, aby log-in-maui i wybierz pozycję Dalej.
- W oknie Dodatkowe informacje wybierz .NET 7.0 i kliknij Utwórz.
Poczekaj na utworzenie projektu i przywrócenie jego zależności.
Dodanie obsługi MSAL SDK przy użyciu klas pomocniczych MSAL
Klient biblioteki MSAL umożliwia deweloperom uzyskiwanie tokenów zabezpieczających od zewnętrznego dzierżawcy 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 pozyskiwania uchwytu okna.
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
- W okienku Eksploratora rozwiązań kliknij prawym przyciskiem myszy projekt SignInMaui i wybierz pozycję Dodaj>Nowy folder. Nadaj folderowi nazwę MSALClient.
- Kliknij prawym przyciskiem myszy na folderze MSALClient, wybierz opcję Dodaj>Istniejący element....
- Przejdź do folderu zawierającego pobrane wcześniej pliki MSALClient.
- Wybierz wszystkie pliki MSALClient, a następnie wybierz 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ązania 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 Visual Studio, wykonaj następujące kroki:
- Wybierz Tools>NuGet Package Manager>Zarządzaj pakietami NuGet dla rozwiązania....
- Na karcie Przeglądaj wyszukaj Microsoft.Identity.Client.
- Wybierz Microsoft.Identity.Client na liście.
- Wybierz SignInMaui w panelu listy Project.
- Wybierz pozycję Zainstaluj.
- 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
- W okienku eksploratora rozwiązań programu Visual Studio rozwiń folder Resources, który wyświetla folder Obrazy.
- Kliknij prawym przyciskiem myszy pozycję Obrazy i wybierz Dodaj>istniejący element....
- Przejdź do folderu zawierającego pobrane obrazy.
- Zmień filtr na filtr typu Pliki obrazów.
- Wybierz pobrany obraz.
- Wybierz pozycję Dodaj.