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

  • Článek

Tento kurz ukazuje, jak vytvořit aplikaci prostředí .NET MAUI (Multi-platform App UI). Přidáte také vlastní pomocnou rutinu klienta Microsoft Authentication Library (MSAL), která inicializuje sadu MSAL SDK, nainstaluje požadované knihovny a zahrne prostředek image.

V tomto kurzu se naučíte:

  • 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

Vytvoření aplikace prostředí .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ě Konfigurace nového projektu musí být název projektu nastavený na SignInMaui. Aktualizujte název řešení na sign-in-maui a vyberte Další.
  4. V okně Další informace zvolte .NET 7.0 a vyberte Vytvořit.

Počkejte na vytvoření projektu a obnovení jeho závislostí.

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 Microsoft Entra ID pro tenanta zákazníka, aby mohli ověřovat zabezpečená webová rozhraní API a přistupovat k jim. V této části stáhnete soubory, které tvoří MSALClient.

Stáhněte následující soubory do složky v počítači:

  • AzureAdConfig.cs – Tento soubor získá a nastaví jedinečné identifikátory Microsoft Entra aplikace z konfiguračního souboru 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í rozhraní API pro příjem dat.
  • Exception.cs – tento soubor nabízí několik rozšiřujících metod souvisejících s vyvoláním a zpracováním výjimek.
  • IdentityLogger.cs – tento popisovač souboru ukazuje, jak používat MSAL.NET protokolování.
  • MSALClientHelper.cs – tento soubor obsahuje metody pro inicializaci 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 statického inicializačního modelu pro platformy.
  • WindowsHelper.cs – tento soubor obsahuje metody pro načtení popisovače okna.

Důležité

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

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, 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 funkci pro vytvoření vazby objektu na data ve 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ů NuGetSpravovat balíčky NuGet pro řešení....
  2. Na kartě Procházet vyhledejteMicrosoft.Identity.Client.
  3. V seznamu vyberte Microsoft.Identity.Client .
  4. V podokně se seznamem projektů vyberte SignInMaui (Přihlásit se).
  5. Vyberte Nainstalovat.
  6. Pokud se zobrazí výzva k ověření instalace, vyberte OK.

Tento postup opakujte a nainstalujte zbývající požadované balíčky.

Přidat prostředek image

V této části si stáhnete obrázek, který používáte ve své aplikaci k vylepšení způsobu, jakým s ním uživatelé pracují.

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

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

  1. V podokně Průzkumník řešení v sadě Visual Studio rozbalte složku Prostředky, čímž se zobrazí složka 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 typ souboru na Soubory obrázků.
  5. Vyberte image, kterou jste stáhli.
  6. Vyberte Přidat.

Další kroky

Kurz: Přihlašování uživatelů v aplikaci prostředí .NET MAUI