分享方式:


教學課程:建立 .NET MAUI Shell 應用程式

本教學課程是系列的第 2 部分,示範如何建立 .NET 多平台應用程式 UI (.NET MAUI) Shell 應用程式,並使用 Microsoft Entra 系統管理中心準備其進行驗證。 在本系列的第 1 部分中,您已在外部租用戶中註冊應用程式並設定使用者流程。 在本教學課程中,您將新增自訂 Microsoft 驗證程式庫 (MSAL) 用戶端協助程式,以初始化 MSAL SDK、安裝必要的程式庫並包含映像資源。

在本教學課程中,您將會:

  • 建立 .NET MAUI Shell 應用程式。
  • 使用 MSAL 協助程式類別新增 MSAL SDK 支援。
  • 安裝必要的套件。
  • 新增映像資源。

必要條件

建立 .NET MAUI Shell 應用程式

  1. 在 Visual Studio 2022 的 [開始] 視窗中,選取 [建立新專案]
  2. 在 [建立新專案] 視窗中,在所有專案類型下拉式清單中選取 [MAUI]、選取 [.NET MAUI 應用程式] 範本,然後選取 [下一步]
  3. 在 [設定新的專案] 視窗中,[專案名稱] 必須設定為 SignInMaui。 將 [解決方案名稱] 更新為 sign-in-maui,然後選取 [下一步]
  4. 在 [其他資訊] 視窗中,選擇 [.NET 7.0],然後選取 [建立]

等候專案建立,並還原其相依性。

使用 MSAL 協助程式類別新增 MSAL SDK 支援

MSAL 用戶端可讓開發人員從外部租用戶取得安全性權杖,以驗證及存取安全的 Web API。 在本節中,您會下載構成 MSALClient 的檔案。

將下列檔案下載到電腦上的資料夾中:

  • AzureAdConfig.cs - 此檔案從應用程式組態檔取得並設定 Microsoft Entra 應用程式唯一識別碼。
  • DownStreamApiConfig.cs - 此檔案會取得並設定 Microsoft Graph 呼叫的範圍。
  • DownstreamApiHelper.cs - 此檔案會處理呼叫下游 API 時發生的例外狀況。
  • Exception.cs - 此檔案提供一些與擲回和處理例外狀況相關的擴充方法。
  • IdentityLogger.cs - 此檔案處理顯示如何使用 MSAL.NET 記錄。
  • MSALClientHelper.cs - 此檔案包含初始化 MSAL SDK 的方法。
  • PlatformConfig.cs - 此檔案包含處理特定平台的方法。 例如,Windows。
  • PublicClientSingleton.cs - 此檔案包含單一資料庫實作,以包裝 MSALClient 和相關聯的類別,以支援平台的靜態初始化模型。
  • WindowsHelper.cs - 此檔案包含擷取視窗控制碼的方法。

重要

請勿跳過下載 MSALClient 檔案,必須下載該檔按才能完成本教學課程。

使用 Visual Studio 移動 MSALClient 檔案

  1. 在 [方案總管] 窗格中,以滑鼠右鍵按一下 [SignInMaui] 專案,然後選取 [新增]>[新增資料夾]。 將資料夾命名為 MSALClient
  2. 以滑鼠右鍵按一下 [MSALClient] 資料夾,選取 [新增]>[現有項目...]
  3. 瀏覽至資料夾,其中包含您稍早下載的 MSALClient 檔案。
  4. 選取您下載的所有 MSALClient 檔案,然後選取 [新增]

安裝必要的套件

您需要安裝下列套件:

  • Microsoft.Identity.Client - 此套件包含適用於 .NET 的 Microsoft 驗證程式庫 (MSAL.NET) 二進位檔。
  • Microsoft.Extensions.Configuration.Json - 此套件包含 Microsoft.Extensions.Configuration 的 JSON 組態提供者實作。
  • Microsoft.Extensions.Configuration.Binder - 此套件包含將物件繫結至 Microsoft.Extensions.Configuration 組態提供者中之資料的功能。
  • Microsoft.Extensions.Configuration.Abstractions - 此套件包含索引鍵/值式組態的抽象概念。
  • Microsoft.Identity.Client.Extensions.Msal - 此套件包含適用於 .NET 的 Microsoft 驗證程式庫 (MSAL.NET) 延伸模組。

NuGet 套件管理員

若要使用 NuGet 套件管理員在 Visual Studio 中安裝 Microsoft.Identity.Client 套件,請遵循下列步驟:

  1. 選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件...]
  2. 在 [瀏覽] 索引標籤中,搜尋 Microsoft.Identity.Client
  3. 選取清單中的 Microsoft.Identity.Client
  4. 在 [專案] 清單窗格中選取 [SignInMaui]
  5. 選取 [安裝]。
  6. 如果系統提示您驗證安裝,請選取 [確定]

重複此流程以安裝其餘必要套件。

新增影像資源

在本節中,您會下載在應用程式中用於增強使用者與其互動方式的影像。

請下載下列影像:

使用 Visual Studio 移動影像

  1. 在 Visual Studio 的 [方案總管] 窗格中,展開 [資源] 資料夾,以顯示 [影像] 資料夾。
  2. 以滑鼠右鍵按一下 [影像],然後選取 [新增]>[現有項目...]
  3. 瀏覽至包含已下載影像的資料夾。
  4. 將檔案類型篩選條件變更為 [影像檔案]
  5. 選取下載的影像。
  6. 選取 [新增]。

後續步驟