教學課程：建立 .NET MAUI 應用程式
本教學課程是系列的第 2 部分，示範如何建立 .NET Multi-platform App UI (.NET MAUI) 殼層應用程式。 在此系列的第 1 部分中，您已在外部租用戶中註冊應用程式並設定使用者流程。 本教學課程示範如何建立 .NET MAUI 殼層應用程式、新增自訂 Microsoft 驗證程式庫 (MSAL) 用戶端協助程式來初始化 MSAL SDK、安裝必要的程式庫，以及包括映像資源。
在本教學課程中，您將會：
- 建立 .NET MAUI 殼層應用程式。
- 使用 MSAL 協助程式類別新增 MSAL SDK 支援。
- 安裝必要的套件。
- 新增映像資源。
必要條件
- 教學課程：在外部租用戶中註冊和設定 .NET MAUI 應用程式
- .NET 7.0 SDK
- 已安裝 MAUI 工作負載的 Visual Studio 2022：
建立 .NET MAUI 應用程式
- 在 Visual Studio 2022 的 [開始] 視窗中，選取 [建立新專案]。
- 在 [建立新專案] 視窗中，於所有專案類型下拉式清單中選取 [MAUI]，並選取 [.NET MAUI 應用程式] 範本，然後選取 [下一步]。
- 在 [設定新的專案] 視窗中，[專案名稱] 必須設定為 [SignInMaui]。 將 [解決方案名稱] 更新為 [sign-in-maui]，然後選取 [下一步]。
- 在 [其他資訊] 視窗中，選擇 [.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 檔案
- 在 [方案總管] 窗格中，以滑鼠右鍵按一下 [SignInMaui] 專案，然後選取 [新增] > [新增資料夾]。 將資料夾命名為 MSALClient。
- 以滑鼠右鍵按一下 [MSALClient] 資料夾，然後選取 [新增] > [現有項目...]。
- 導覽至資料夾，而此資料夾包含您稍早下載的 MSALClient 檔案。
- 選取所有 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 套件，請遵循下列步驟：
- 選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件...]。
- 從 [瀏覽] 索引標籤中，搜尋 Microsoft.Identity.Client。
- 選取清單中的 [Microsoft.Identity.Client]。
- 在 [專案] 清單窗格中，選取 [SignInMaui]。
- 選取 [安裝]。
- 如果系統提示您驗證安裝，請選取 [確定]。
重複此程序以安裝其餘必要套件。
新增影像資源
在本節中，您會下載在應用程式中用來增強使用者與其互動方式的影像。
請下載下列影像：
- 圖示：Microsoft Entra ID：此影像用作主頁面中的圖示。
使用 Visual Studio 移動影像
- 在 Visual Studio 的 [方案總管] 窗格中，展開 [資源] 資料夾，以顯示 [影像] 資料夾。
- 以滑鼠右鍵按一下 [影像]，然後選取 [新增] > [現有項目...]。
- 導覽至包含已下載影像的資料夾。
- 將篩選從檔案類型篩選變更為 [影像檔案]。
- 選取您已下載的影像。
- 選取 [新增]。