教學課程：建立 .NET MAUI 應用程式
本教學課程是一系列的第 2 部分，示範如何建立 .NET 多平臺應用程式 UI （.NET MAUI） 殼層應用程式。 在此系列第 部分，您已在外部租戶中註冊應用程式並設定使用者流程。 本教學課程示範如何建立 .NET MAUI 殼層應用程式、新增自定義Microsoft驗證連結庫 （MSAL） 客戶端協助程式，以初始化 MSAL SDK、安裝必要的連結庫，以及包含映像資源。
在本教學課程中，您將：
- 建立 .NET MAUI Shell 應用程式。
- 使用 MSAL 協助類別來新增 MSAL SDK 支援。
- 安裝必要的套件。
- 新增映像資源。
- 在 Visual Studio 2022 的 [開始] 視窗中，選取 [[建立新專案]。
- 在 [建立新專案] 視窗中，選取 [所有專案類型] 下拉式清單中的 [MAUI]，選取 [.NET MAUI 應用程式 範本]，然後選取 [下一步]。
- 在 [設定新專案] 視窗中，[項目名稱] 必須設定為 SignInMaui。 將 [方案名稱 更新為 sign-in-maui，然後選取 [下一步]。
- 在 [其他資訊] 視窗中，選擇 [.NET 7.0]，然後點選 [建立]。
等候專案建立，以及還原其相依性。
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 檔案，它們是完成此教學課程所必需的。
- 在 [方案總管] 窗格中，以滑鼠右鍵點擊 [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 套件管理員 在 Visual Studio 中安裝 Microsoft.Identity.Client 套件，請遵循下列步驟：
- 選取 [工具]>[NuGet 套件管理員]>[管理解決方案的 NuGet 套件...]。
- 從 [瀏覽] 索引標籤，搜尋 Microsoft.Identity.Client。
- 選取清單中的 Microsoft.Identity.Client。
- 在 [ 專案] 清單窗格中，選取 [SignInMaui]。
- 選擇 [安裝]。
- 如果出現驗證安裝的提示，請選擇 確定。
重複此程式以安裝其餘必要套件。
在本節中，您會下載您在應用程式中使用的映像，以增強使用者與其互動的方式。
下載下圖：
- 圖示：Microsoft Entra ID - 此影像會作為主頁面中的圖示使用。
- 在 Visual Studio 的 [方案總管] 窗格中，展開 [Resources] 資料夾，其中顯示 [Images] 資料夾。
- 以滑鼠右鍵點擊 影像，然後選取 新增>現有專案...。
- 流覽至包含所下載影像的資料夾。
- 將篩選條件更改為檔案類型篩選至 圖片檔案。
- 選取您下載的映像。
- 選取 新增。