syncfusion-maui-getting-started

Name: syncfusion-maui-getting-started
Author: syncfusion

github.com/syncfusion开发61207 次安装2 周前更新

代码仓库

关于 syncfusion-maui-getting-started

面向 Syncfusion .NET MAUI 开发者的入门技能，汇总组件安装、授权、主题、工具链与升级配置。它还涵盖 Smart Components 的 AI 服务设置及常见问题排查。

主要功能

01安装与环境配置
02许可证注册与故障排查
03主题与颜色定制
04IDE 扩展和项目模板
05AI 服务配置
06NuGet 更新与迁移

适用场景

01排查 NuGet 安装或还原问题
02为 MAUI 应用注册许可证
03配置主题和深浅色模式
04设置 Smart 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 包、安装程序（在线、离线、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 包含多个类别的组件：

数据可视化（图表、仪表、TreeMap）
网格与数据（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 开发：

Visual Studio 2022（v17.3+）用于 .NET 9，或 Visual Studio 2026 用于 .NET 10
已安装 .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