mcpField
S
syncfusion-maui-getting-started

syncfusion-maui-getting-started

github.com/syncfusion開発61207 回インストール2 週間前に更新
リポジトリ

syncfusion-maui-getting-started について

Syncfusion .NET MAUI 開発者向けの入門スキルです。コンポーネントの導入、ライセンス、テーマ、ツール、アップグレードに加え、Smart Components の AI サービス設定とトラブルシューティングを扱います。

主な機能

  1. 01インストールと環境設定
  2. 02ライセンス登録と問題解決
  3. 03テーマと色のカスタマイズ
  4. 04IDE 拡張機能とプロジェクトテンプレート
  5. 05AI サービス設定
  6. 06NuGet の更新と移行

活用シーン

  1. 01NuGet の導入や復元エラーの調査
  2. 02MAUI アプリへのライセンス登録
  3. 03テーマとライト・ダークモードの設定
  4. 04Smart Components 用 AI サービスの設定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/syncfusion/maui-ui-components-skills --skill syncfusion-maui-getting-started

インストール後、Claude Code で/syncfusion-maui-getting-startedを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
framework-compatibility.md
icons-reference.md
installation-errors.md
installation-installers.md
installation-nuget.md
installation-offline.md
introduction-overview.md
liquid-glass-ui.md
system-requirements.md
upgrade-packages.md
visual-studio-integration.md
vscode-integration.md

詳細

Syncfusion .NET MAUI の概要

Syncfusion .NET MAUI コンポーネントのインストール、構成、開発環境のセットアップに関する包括的なガイドです。

このスキルを使用するタイミング

以下のニーズがある場合は、必ずすぐにこのスキルを使用してください。

  • インストールまたはセットアップ: NuGet パッケージ、インストーラー(Web、オフライン、Mac)、インストール時のトラブルシューティング
  • ライセンス: ライセンスキーの生成、アプリケーションへのキーの登録、ライセンスエラーの解決、トライアル版から有料版へのアップグレード
  • テーマ: Material/Cupertino テーマ、ライト/ダークモードの適用、テーマの色のカスタマイズ、テーマキーのオーバーライド
  • AI 連携: Smart Components 向けの Azure OpenAI、Claude、Gemini、DeepSeek、Groq、またはカスタム AI サービスの構成
  • ツール: Visual Studio または VS Code の拡張機能、プロジェクトテンプレート、コードスニペット、Essential UI Kit の使用
  • 高度な機能: Liquid Glass UI の実装、NuGet パッケージのアップグレード、重大な変更への対応
  • トラブルシューティング: インストールエラー、ライセンスの問題、テーマの問題、AI サービスの構成

このスキルには、すべての Syncfusion .NET MAUI コンポーネントとアプリケーションに適用される、分野横断的な考慮事項が含まれています。


Syncfusion .NET MAUI の概要

Syncfusion .NET MAUI(マルチプラットフォームアプリ UI)は、ネイティブのクロスプラットフォームアプリケーションを構築するための、高性能で豊富な機能を備えた UI コンポーネントの包括的なコレクションです。Microsoft の .NET MAUI フレームワーク上に構築されており、単一のコードベースで次のプラットフォームを対象とした、モダンで美しいアプリケーションを開発できます。

  • Windows(デスクトップアプリケーション)
  • macOS(デスクトップアプリケーション)
  • iOS(モバイルアプリケーション)
  • Android(モバイルアプリケーション)
主な機能
  • 70 以上のコンポーネント: グリッド、チャート、ゲージ、エディター、カレンダー、スケジューラーなど
  • ネイティブのパフォーマンス: スムーズな UX を実現するプラットフォーム固有の最適化
  • 一貫性のある API: 単一のコードベースがすべてのプラットフォームで動作
  • テーマのサポート: Material Design および Cupertino(iOS スタイル)テーマとライト/ダークモード
  • AI 対応: AI サービスとの連携に対応した Smart Components
  • アクセシビリティ: スクリーンリーダーをサポートする WCAG 準拠
  • ローカライズ: RTL および多言語のサポート
コンポーネントのカテゴリ

Syncfusion .NET MAUI には、複数のカテゴリにわたるコンポーネントが含まれています。

  • データの可視化(チャート、ゲージ、ツリーマップ)
  • グリッドとデータ(DataGrid、ListView、TreeView)
  • エディターと入力(TextBox、ComboBox、DatePicker、Autocomplete)
  • カレンダーとスケジューリング(Calendar、Scheduler、DateRangePicker)
  • ナビゲーション(TabView、TreeView、Accordion、Carousel)
  • レイアウト(Cards、Chips、Avatar、Backdrop)
  • ボタンとインジケーター(Button、Checkbox、RadioButton、Badge、Busy Indicator)
  • ファイル形式(PDF、Excel、Word、PowerPoint)

プラットフォームのサポートと要件

サポート対象のプラットフォーム
プラットフォーム最小バージョン推奨バージョン
WindowsWindows 10 version 1809+Windows 11
macOSmacOS 10.15+macOS 12+
iOSiOS 11+iOS 15+
AndroidAndroid 5.0 (API 21)+Android 12+ (API 31+)
フレームワークの互換性

Syncfusion .NET MAUI は次をサポートしています。

  • .NET 6(初期の MAUI サポート)
  • .NET 7(機能強化)
  • .NET 8(すべての機能を備えた LTS)
  • .NET 9(最新機能) .NET 10(最新機能)
開発環境

Windows での開発:

  • .NET 9 では Visual Studio 2022(v17.3+)、または .NET 10 では Visual Studio 2026
  • .NET MAUI ワークロードのインストール
  • Android SDK(Android 開発用)

macOS での開発:

  • .NET MAUI 拡張機能を含む Visual Studio Code
  • Xcode 13+(iOS/macOS 開発用)
  • .NET MAUI ワークロードのインストール

クロスプラットフォーム開発:

  • .NET MAUI 拡張機能を含む Visual Studio Code
  • .NET SDK 9.0+(.NET 10 の機能を使用する場合は 10.0+)
システム要件

📄 システム要件の詳細については、こちらをご覧ください: references/introduction-overview.md


はじめに

クイックスタート(3 ステップ)

ステップ 1:NuGet パッケージをインストールする

dotnet add package Syncfusion.Maui.Core
# Or install specific component packages as needed

ステップ 2:ライセンスキーを登録する(v20.2.0.x 以降では必須)

MauiProgram.cs で、CreateMauiApp() の前に追加します。

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        // Register Syncfusion license
        string licenseKey = Environment.GetEnvironmentVariable("SYNCFUSION_LICENSE_KEY");
        if (!string.IsNullOrEmpty(licenseKey))
        {   
            Syncfusion.Licensing.SyncfusionLicenseProvider.RegisterLicense(licenseKey);
        }
        
        var builder = MauiApp.CreateBuilder();
        // ... rest of configuration
    }
}

ステップ 3:テーマを適用する(任意ですが、推奨)

App.xaml で:

<Application xmlns:syncTheme="clr-namespace:Syncfusion.Maui.Themes;assembly=Syncfusion.Maui.Core">
    <Application.Resources>
        <ResourceDictionary>
            <ResourceDictionary.MergedDictionaries>
                <syncTheme:SyncfusionThemeResourceDictionary VisualTheme="MaterialLight"/>
            </ResourceDictionary.MergedDictionaries>
        </ResourceDictionary>
    </Application.Resources>
</Application>

📄 詳しいインストール手順については、こちらをご覧ください: references/installation-nuget.md


ドキュメントとナビゲーションガイド

1. はじめにとインストール

これらのファイルを読むタイミング: Syncfusion のインストール、インストールに関する問題のトラブルシューティング、またはプラットフォーム要件の確認が必要な場合。

📄 references/introduction-overview.md

  • Syncfusion .NET MAUI とは
  • クロスプラットフォーム機能とアーキテクチャ
  • コンポーネントエコシステムの全体概要
  • サポート対象プラットフォーム(Windows、macOS、iOS、Android)
  • システム要件の詳細
  • フレームワークの互換性(.NET 6、7、8、9、10)
  • 開発環境のセットアップ

📄 references/installation-nuget.md

  • パッケージ マネージャー UI を使用した NuGet パッケージのインストール
  • .NET CLI(dotnet add package)を使用したインストール
  • パッケージ マネージャー コンソールのコマンド
  • パッケージ依存関係の管理
  • バージョン管理と更新
  • パッケージのインストール確認

📄 references/installation-installers.md

  • Web インストーラー:ダウンロードとインストール手順
  • オフライン インストーラー:ダウンロードとインストール手順
  • Mac インストーラー:ダウンロードとインストール手順
  • インストーラーの比較(それぞれの用途)
  • インストーラーと NuGet パッケージの比較
  • インストール後の確認

📄 references/installation-errors.md

  • よくあるインストールエラーと解決方法
  • パッケージの復元に関する失敗
  • バージョンの競合
  • プラットフォーム固有のインストールに関する問題
  • トラブルシューティングの手順
2. ツールと IDE の統合

これらのファイルを読むタイミング: Visual Studio または VS Code の拡張機能、プロジェクトテンプレート、コードスニペット、またはツール機能が必要な場合。

📄 references/visual-studio-integration.md

  • Syncfusion .NET MAUI Visual Studio 拡張機能の概要
  • 拡張機能のダウンロードとインストール
  • プロジェクトテンプレートと Template Studio
  • ドラッグ&ドロップ用のツールボックスコントロール
  • Essential UI Kit の統合
  • コードスニペットライブラリ
  • Syncfusion の通知と更新
  • プロジェクト作成ウィザードの使用

📄 references/vscode-integration.md

  • Syncfusion .NET MAUI VS Code 拡張機能の概要
  • マーケットプレースからの拡張機能のダウンロードとインストール
  • VS Code 拡張機能を使ったプロジェクトの作成
  • MAUI コンポーネント用のコードスニペット
  • VS Code 用 Essential UI Kit
  • コマンドパレットとの統合
  • VS Code での MAUI アプリのデバッグ

📄 references/icons-reference.md

  • MAUI 用 Syncfusion アイコンライブラリ
  • アプリケーションでの組み込みアイコンの使用
  • Material アイコンのサポート
  • アイコンフォントのリソース
  • アイコンのサイズ設定とスタイル設定
  • カスタムアイコンの統合
3. 高度な機能

これらのファイルを読むタイミング: Liquid Glass UI エフェクトやパッケージのアップグレードに関するガイダンスが必要な場合。

📄 references/liquid-glass-ui.md

  • Liquid Glass UI の概要と設計理念
  • Liquid Glass UI の使用開始
  • 利用可能なガラス調コントロール(Button、Card、Entry など)
  • スタイル設定とぼかし効果
  • 透明効果とすりガラス効果
  • 実装例とパターン
  • カスタマイズオプション

📄 references/upgrade-packages.md

  • Syncfusion MAUI NuGet パッケージのアップグレード方法
  • パッケージ マネージャー UI を使用したアップグレード
  • .NET CLI を使用したアップグレード
  • バージョン互換性に関する考慮事項
  • バージョン間の破壊的変更への対応
  • メジャーアップデートの移行ガイド
  • アップグレード後のテスト
  • ロールバック戦略

コメント