syncfusion-maui-getting-started について
Syncfusion .NET MAUI 開発者向けの入門スキルです。コンポーネントの導入、ライセンス、テーマ、ツール、アップグレードに加え、Smart Components の AI サービス設定とトラブルシューティングを扱います。
主な機能
- 01インストールと環境設定
- 02ライセンス登録と問題解決
- 03テーマと色のカスタマイズ
- 04IDE 拡張機能とプロジェクトテンプレート
- 05AI サービス設定
- 06NuGet の更新と移行
活用シーン
- 01NuGet の導入や復元エラーの調査
- 02MAUI アプリへのライセンス登録
- 03テーマとライト・ダークモードの設定
- 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.mdicons-reference.mdinstallation-errors.mdinstallation-installers.mdinstallation-nuget.mdinstallation-offline.mdintroduction-overview.mdliquid-glass-ui.mdsystem-requirements.mdupgrade-packages.mdvisual-studio-integration.mdvscode-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)
プラットフォームのサポートと要件
サポート対象のプラットフォーム
| プラットフォーム | 最小バージョン | 推奨バージョン |
|---|---|---|
| Windows | Windows 10 version 1809+ | Windows 11 |
| macOS | macOS 10.15+ | macOS 12+ |
| iOS | iOS 11+ | iOS 15+ |
| Android | Android 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 を使用したアップグレード
- バージョン互換性に関する考慮事項
- バージョン間の破壊的変更への対応
- メジャーアップデートの移行ガイド
- アップグレード後のテスト
- ロールバック戦略