Share via


.NET マルチプラットフォーム アプリ UI (.NET MAUI) Community Toolkit の概要

この記事では、.NET MAUI Community Toolkit プロジェクトの一部として提供されるパッケージの使用を開始する方法について説明します。

NuGet パッケージの追加

ツールキットは、NuGet パッケージのセットとして入手可能で、Visual Studio を使用して既存または新規の任意のプロジェクトに追加できます。

  1. 既存のプロジェクトを開くか、.NET MAUI セットアップ ドキュメントに従って新しいプロジェクトを作成します

  2. [ソリューション エクスプローラー] パネルで、プロジェクト名を右クリックし、[NuGet パッケージの管理] を選択します。 CommunityToolkit.Maui を検索し、一覧から目的の NuGet パッケージを選択します。

    NuGet パッケージの管理...

  3. 次のオプションから、ニーズに最も適したツールキットを選択します:

このパッケージは、.NET MAUI を使用した開発用のアニメーション、ビヘイビアー、コンバーター、およびカスタム ビューのコレクションです。 .NET MAUI を使用して iOS、Android、macOS、Windows アプリを構築する一般的な開発者タスクを簡略化し、デモンストレーションします。

パッケージ名:CommunityToolkit.Maui

パッケージ URL:https://www.nuget.org/packages/CommunityToolkit.Maui

パッケージを初期化しています

まず、ステートメントの使用を MauiProgram.cs ファイルの先頭に追加する必要があります

using CommunityToolkit.Maui;

ツールキットを正しく使用するには、MauiProgram.cs ファイルをアプリケーションにブートストラップするときに、MauiAppBuilder クラスで UseMauiCommunityToolkit メソッドを呼び出す必要があります。 次の例は、これを実行する方法を示します。

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

ツールキットの機能を使用するには、各機能のドキュメント ページを参照してください。

NuGet パッケージの使用

  1. 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);
});
  1. 特定の機能の実装の詳細については、ドキュメントの残りの部分を参照してください。

その他のリソース

.NET MAUI Community Toolkit GitHub リポジトリ には、ツールキットを使用して .NET MAUI アプリケーションをビルドする方法を示すために設計されたサンプル アプリケーションのソース コードが含まれています。 サンプル アプリケーションを実行するには、リポジトリを複製またはダウンロードし、ソース コードをコンパイルする必要があることに注意してください。

.NET MAUI を初めて使用する開発者は、.NET MAUI ドキュメントにアクセスすることをお勧めします。

.NET MAUI Community Toolkit GitHub リポジトリ にアクセスして、現在のソース コード、今後の予定を確認して、リポジトリを複製します。 コミュニティへの投稿も歓迎します。