教學課程：建立 .NET MAUI 殼層應用程式
本教學課程是系列的第 2 部分，示範如何建立 .NET 多平臺應用程式 UI （.NET MAUI） 殼層應用程式，並準備使用 Microsoft Entra 系統管理中心進行驗證。 在 本系列的第 1 部分中，您已在外部租戶中註冊應用程式並設定使用者流程。 在本教學課程中，您將新增自定義Microsoft驗證連結庫 （MSAL） 客戶端協助程式，以初始化 MSAL SDK、安裝必要的連結庫並包含映像資源。
在本教學課程中，您將;
- 建立 .NET MAUI 介殼應用程式。
- 使用 MSAL 輔助類別新增 MSAL SDK 支援。
- 安裝必要的套件。
- 新增映像資源。
先決條件
建立 .NET MAUI 外殼應用程式
- 在 Visual Studio 2022 的 [開始] 視窗中，選取 [建立新專案]。
- 在 [建立新專案] 視窗中，選取 [所有專案類型] 下拉式清單中的 [MAUI]，選取 [.NET MAUI 應用程式 範本]，然後選取 [下一步]。
- 在 [設定新專案] 視窗中，[專案名稱] 必須設定為 SignInMaui。 將 方案名稱 更新為 sign-in-maui 並選取 下一步。
- 在 [附加資訊] 視窗中，選擇最新的 .NET SDK，然後選取 [建立]。
請等候專案建立完成並還原其相依性。
使用 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 的 [方案總管] 窗格中，展開 [Resources] 資料夾，其中顯示 [Images] 資料夾。
- 以滑鼠右鍵點擊 圖片，然後選取 加入>現有項目...。
- 流覽至包含所下載影像的資料夾。
- 將篩選條件變更為檔案類型的篩選器，選擇 影像檔。
- 選取您下載的映像。
- 選取 ，新增。