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

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

在本教學課程中，您將會：

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

必要條件

• 教學課程：在外部租用戶中註冊及設定 .NET MAUI 行動應用程式
• .NET 7.0 SDK
• 已安裝 MAUI 工作負載的 Visual Studio 2022：
  • 適用於 Windows 的指示
  • macOS 的指示

建立 .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. 如果系統提示您驗證安裝，請選取 [確定]。

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

新增影像資源

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

請下載下列影像：

• 圖示：Microsoft Entra ID - 此影像會作為主頁面中的圖示使用。

使用 Visual Studio 移動影像

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

後續步驟

第3部分：教學課程：使用外部租用戶在 .NET MAUI Shell 應用程式中登入使用者