Kurz: Vytvoření aplikace prostředí .NET MAUI

Tento kurz je druhou částí série, která ukazuje, jak vytvořit aplikaci prostředí .NET Multi-Platform App UI (.NET MAUI) a připravit ji na ověřování pomocí Centra pro správu Microsoft Entra. V části 1 této sériejste zaregistrovali aplikaci a nakonfigurovali toky uživatelů ve svém externím tenantovi. V tomto návodu přidáte vlastního pomocného klienta knihovny Microsoft Authentication Library (MSAL) pro inicializaci sady SDK, instalaci požadovaných knihoven a zahrnutí obrazového zdroje.

V tomto kurzu budete;

• Vytvořte shellovou aplikaci .NET MAUI.
• Přidání podpory sady MSAL SDK pomocí pomocných tříd MSAL
• Nainstalujte požadované balíčky.
• Přidejte zdroj obrázku.

Požadavky

• kurz : Registrace a konfigurace mobilní aplikace .NET MAUI v externím tenantovi
• .NET SDK
• sady Visual Studio 2022 s nainstalovanou úlohou MAUI:
  • pokyny k instalaci sady Visual Studio

Vytvoření aplikace typu .NET MAUI shell

1. V úvodním okně sady Visual Studio 2022 vyberte Vytvořit nový projekt.
2. V okně Vytvořit nový projekt vyberte MAUI v rozevíracím seznamu Všechny typy projektů, vyberte šablonu aplikace .NET MAUI a vyberte Další.
3. V okně Konfigurovat nový projekt musí být název projektu nastaven na SignInMaui. Aktualizujte název řešení tak, aby přihlášení a vyberte Další.
4. V okně Další informace zvolte nejnovější .NET SDK a zvolte Vytvořit.

Počkejte, až se projekt vytvoří a jeho závislosti se obnoví.

Přidání podpory sady MSAL SDK pomocí pomocných tříd MSAL

Klient MSAL umožňuje vývojářům získat tokeny zabezpečení z externího tenanta pro ověřování a přístup k zabezpečeným webovým rozhraním API. V této části stáhnete soubory, které tvoří MSALClient.

Do složky v počítači si stáhněte následující soubory:

• AzureAdConfig.cs – Tento soubor získá a nastaví jedinečné identifikátory aplikace Microsoft Entra z konfiguračního souboru vaší aplikace.
• DownStreamApiConfig.cs – Tento soubor získá a nastaví obory pro volání Microsoft Graphu.
• DownstreamApiHelper.cs – Tento soubor zpracovává výjimky, ke kterým dochází při volání podřízeného rozhraní API.
• Exception.cs – Tento soubor nabízí několik rozšiřujících metod souvisejících s vyvolání a zpracováním výjimek.
• IdentityLogger.cs – Tento soubor ukazuje, jak používat logování MSAL.NET.
• MSALClientHelper.cs – Tento soubor obsahuje metody inicializace sady MSAL SDK.
• PlatformConfig.cs – Tento soubor obsahuje metody pro zpracování konkrétní platformy. Například Windows.
• PublicClientSingleton.cs – Tento soubor obsahuje jednoúčelovou implementaci pro zabalení MSALClient a přidružených tříd pro podporu modelu statické inicializace pro platformy.
• WindowsHelper.cs – Tento soubor obsahuje metody pro načtení popisovače okna.

Důležitý

Nepřekočujte stahování souborů MSALClient, které jsou potřeba k dokončení tohoto kurzu.

Přesunutí souborů MSALClient pomocí sady Visual Studio

1. V podokně Průzkumníka řešení klikněte pravým tlačítkem na projekt SignInMaui a vyberte PřidatNovou složku. Pojmenujte složku MSALClient .
2. Klikněte pravým tlačítkem na složku MSALClient, vyberte Přidat>Existující položku....
3. Přejděte do složky, která obsahuje stažené soubory MSALClient, které jste stáhli dříve.
4. Vyberte všechny soubory MSALClient, které jste stáhli, a pak vyberte Přidat

Instalace požadovaných balíčků

Musíte nainstalovat následující balíčky:

• Microsoft.Identity.Client – tento balíček obsahuje binární soubory knihovny Microsoft Authentication Library pro .NET (MSAL.NET).
• Microsoft.Extensions.Configuration.Json – tento balíček obsahuje implementaci zprostředkovatele konfigurace JSON pro Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Binder – tento balíček obsahuje funkce pro vytvoření vazby objektu na data v zprostředkovatelích konfigurace pro Microsoft.Extensions.Configuration.
• Microsoft.Extensions.Configuration.Abstractions – tento balíček obsahuje abstrakce konfigurace založené na páru klíč-hodnota.
• Microsoft.Identity.Client.Extensions.Msal – tento balíček obsahuje rozšíření knihovny Microsoft Authentication Library pro .NET (MSAL.NET).

Správce balíčků NuGet

Pokud chcete použít správce balíčků NuGet k instalaci balíčku Microsoft.Identity.Client v sadě Visual Studio, postupujte takto:

1. Vyberte nástroje >Správce balíčků NuGet>Spravovat balíčky NuGet pro řešení....
2. Na kartě Procházet vyhledejte Microsoft.Identity.Client.
3. V seznamu vyberte Microsoft.Identity.Client.
4. V podokně seznamu Projectu vyberte SignInMaui.
5. Vyberte Nainstalovat.
6. Pokud se zobrazí výzva k ověření instalace, vyberte OK.

Opakujte proces instalace zbývajících požadovaných balíčků.

Přidání prostředku image

V této části si stáhnete obrázek, který používáte ve své aplikaci, abyste vylepšili způsob interakce uživatelů s ní.

Stáhněte si následující obrázek:

• ikona : Microsoft Entra ID – tento obrázek se používá jako ikona na hlavní stránce.

Přesunutí obrázku pomocí sady Visual Studio

1. V podokně Průzkumníka řešení sady Visual Studio rozbalte složku Resources, která odhalí složku Obrázky.
2. Klikněte pravým tlačítkem na Obrázky a vyberte Přidat>Existující položka....
3. Přejděte do složky, která obsahuje stažené obrázky.
4. Změňte filtr na filtr typu souboru na obrazové soubory.
5. Vyberte obrázek, který jste stáhli.
6. Vyberte Přidat.

Další krok

část 3: Kurz: Přihlášení uživatelů v aplikaci prostředí .NET MAUI pomocí externího tenanta