Kurz: Vytvoření aplikace .NET MAUI

Tento kurz je druhou částí série, která ukazuje, jak vytvořit aplikaci prostředí .NET Multi-Platform App UI (.NET MAUI). V první části této série jste zaregistrovali aplikaci a nakonfigurovali toky uživatelů ve vašem externím tenantovi. V tomto kurzu se dozvíte, jak vytvořit aplikaci prostředí .NET MAUI, přidat vlastního pomocníka microsoft Authentication Library (MSAL) pro inicializaci sady MSAL SDK, instalaci požadovaných knihoven a zahrnutí prostředku image.

V tomto kurzu:

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

Požadavky

• Kurz: Registrace a konfigurace aplikace .NET MAUI v externím tenantovi
• .NET 7.0 SDK
• Visual Studio 2022 s nainstalovanou úlohou MAUI:
  • Pokyny pro Windows
  • Pokyny pro macOS

Vytvoření aplikace .NET MAUI

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 se přihlásil(a) a vyberte Další.
4. V okně Další informace zvolte .NET 7.0 a vyberte 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í výjimek a zpracováním.
• IdentityLogger.cs – Tento popisovač souborů ukazuje, jak používat protokolová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ík řešení klikněte pravým tlačítkem na projekt SignInMaui a vyberte Přidat>novou složku. Pojmenujte složku MSALClient.
2. Klikněte pravým tlačítkem na složku MSALClient a vyberte Přidat>existující položku....
3. Přejděte do složky obsahující soubory MSALClient, které jste stáhli dříve.
4. Vyberte všechny soubory MSALClient 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 k datům 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 k instalaci balíčku Microsoft.Identity.Client v sadě Visual Studio použít Správce balíčků NuGet, postupujte takto:

1. Vyberte Nástroje>NuGet Správce balíčků> Manage balíčků NuGet pro řešení....
2. Na kartě Procházet vyhledejte Microsoft.Identity.Client.
3. V seznamu vyberte Microsoft.Identity.Client .
4. V podokně seznamu projektů vyberte SignInMaui.
5. Vyberte volbu Instalovat.
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ík ř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žku....
3. Přejděte do složky, která obsahuje stažené obrázky.
4. Změňte filtr na filtr typu souboru na Soubory obrázků.
5. Vyberte obrázek, který jste stáhli.
6. Vyberte Přidat.

Další krok

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