開始使用 .NET 多平臺應用程式 UI （.NET MAUI） 社群工具組

本文說明如何開始使用作為 .NET MAUI Community Toolkit 專案的一部分所提供的套件。

新增 NuGet 套件（s）

此工具組可作為一組 NuGet 套件，可使用 Visual Studio 新增至任何現有或新的專案。

1. 開啟現有的專案，或根據 .NET MAUI 安裝檔建立新的專案

2. 在 [方案總管] 面板中，以滑鼠右鍵按一下專案名稱，然後選取 [管理 NuGet 套件]。 搜尋 CommunityToolkit.Maui，然後從清單中選擇所需的 NuGet 套件。

   

3. 從下列選項中選擇最適合您需求的工具組：

CommunityToolkit.Maui

此套件是使用 .NET MAUI 進行開發的動畫、行為、轉換器和自定義檢視的集合。 它簡化並示範使用 .NET MAUI 建置 iOS、Android、macOS 和 Windows 應用程式的常見開發人員工作。

套件名稱：CommunityToolkit.Maui

套件 URL： https://www.nuget.org/packages/CommunityToolkit.Maui

初始化封裝

首先，using 語句必須新增至MauiProgram.cs檔案的頂端

using CommunityToolkit.Maui;

若要正確地使用工具組， UseMauiCommunityToolkit 必須在類別上 MauiAppBuilder 呼叫 方法，才能在啟動應用程式 MauiProgram.cs 檔案時呼叫。 下列範例示範如何執行此動作。

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkit()

若要使用工具組的功能，請參閱每個特定功能的文件頁面。

CommunityToolkit.Maui.Markup

此套件是一組 Fluent Helper 方法和類別，可簡化在 C# 中建置宣告式 .NET MAUI 使用者介面。

套件名稱：CommunityToolkit.Maui.Markup

套件 URL： https://www.nuget.org/packages/CommunityToolkit.Maui.Markup

初始化封裝

首先，using 語句必須新增至MauiProgram.cs檔案的頂端

using CommunityToolkit.Maui.Markup;

若要正確地使用工具組， UseMauiCommunityToolkitMarkup 必須在類別上 MauiAppBuilder 呼叫 方法，才能在啟動應用程式 MauiProgram.cs 檔案時呼叫。 下列範例示範如何執行此動作。

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMarkup()

若要使用工具組的功能，請參閱每個特定功能的文件頁面。

CommunityToolkit.Maui.Maps

此套件可讓您在 .NET MAUI Windows 應用程式中顯示地圖。

重要

Bing 地圖服務已停止提供此控制項運作所需的新 API 金鑰。 我們目前決定是否應該更新此控件，以使用使用 Azure 地圖服務 的 WinUI 控件，或我們將等候正式 .NET MAUI 第一方實作。 目前，這表示如果您還沒有 Bing 地圖服務 API 金鑰，就無法使用此控件。 Bing 地圖服務整體將完全停止於 2025 年 6 月 30 日。

套件名稱：CommunityToolkit.Maui.Maps

套件 URL： https://www.nuget.org/packages/CommunityToolkit.Maui.Maps

初始化封裝

首先，using 語句必須新增至MauiProgram.cs檔案的頂端

using CommunityToolkit.Maui.Maps;

若要正確使用 方法Map，.UseMauiCommunityToolkitMaps在啟動載入應用程式時，必須在 類別上MauiAppBuilder呼叫 方法MauiProgram.cs檔案。 此方法需要有效的 Bing 地圖服務 API 金鑰，您可以透過 Bing 地圖服務入口網站取得此金鑰。

下列範例示範如何執行此動作。

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")

一起使用適用於 Windows 的 .NET MAUI 社群工具組對應和一般 .NET MAUI 地圖時，您必須確定每個初始化呼叫只會針對相關平台進行。 下列範例顯示如何執行這項工作。

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
#if ANDROID || IOS
    .UseMauiMaps()
#elif WINDOWS
    .UseMauiCommunityToolkitMaps("YOUR_API_KEY")
#endif

如需如何在 iOS 和 Android 上初始化地圖的詳細資訊，以及如何使用地圖控件 API，請參閱 .NET MAUI 地圖服務檔。

CommunityToolkit.Maui.MediaElement

此套件可讓您在 .NET MAUI 應用程式中播放音訊和視訊。

套件名稱：CommunityToolkit.Maui.MediaElement

套件 URL： https://www.nuget.org/packages/CommunityToolkit.Maui.MediaElement

初始化封裝

首先，using 語句必須新增至MauiProgram.cs檔案的頂端

using CommunityToolkit.Maui;

若要正確使用 方法MediaElement，UseMauiCommunityToolkitMediaElement在啟動載入應用程式時，必須在 類別上MauiAppBuilder呼叫 方法MauiProgram.cs檔案。 下列範例示範如何執行此動作。

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitMediaElement()

若要使用工具組的功能，請參閱每個特定功能的文件頁面。

CommunityToolkit.Maui.Camera

此套件可讓您連線到相機、顯示相機的預覽並拍照。

套件名稱：CommunityToolkit.Maui.Camera

套件 URL： https://www.nuget.org/packages/CommunityToolkit.Maui.Camera

初始化封裝

首先，using 語句必須新增至MauiProgram.cs檔案的頂端

using CommunityToolkit.Maui;

若要正確使用 CameraView ， UseMauiCommunityToolkitCamera 必須在類別上 MauiAppBuilder 呼叫 方法，以啟動應用程式 MauiProgram.cs 檔案。 下列範例示範如何執行此動作。

var builder = MauiApp.CreateBuilder();
builder
    .UseMauiApp<App>()
    .UseMauiCommunityToolkitCamera()

若要使用工具組的功能，請參閱每個特定功能的文件頁面。

使用 NuGet 套件（s）

4. 在 中 MauiProgram.cs啟用工具群組：

var builder = MauiApp.CreateBuilder();
builder.UseMauiApp<App>();
builder.UseMauiCommunityToolkit();

4.1. 針對進階設定設定 CommunityToolkit.Maui.Options：

builder.UseMauiCommunityToolkit(options =>
{
    options.SetShouldSuppressExceptionsInConverters(false);
    options.SetShouldSuppressExceptionsInBehaviors(false);
    options.SetShouldSuppressExceptionsInAnimations(false);
});

5. 請參閱文件的其餘部分，以深入瞭解如何實作特定功能。

其他資源

.NET MAUI 社群工具組 GitHub 存放庫包含範例應用程式的原始程式碼，其設計目的是示範如何使用工具組來建置 .NET MAUI 應用程式。 請注意，您必須複製或下載存放庫並編譯原始程式碼，才能執行範例應用程式。

我們建議不熟悉 .NET MAUI 的開發人員流覽 .NET MAUI 檔。

請流覽 .NET MAUI Community Toolkit GitHub 存放庫，以查看目前的原始程式碼、接下來的內容，以及複製存放庫。 我們非常歡迎社群參與！