syncfusion-maui-toolkit-getting-started

Syncfusion® .NET MAUI 工具包简介

Syncfusion® .NET MAUI 工具包提供一套全面的专业 UI 组件，可用于构建现代化的跨平台移动和桌面应用。本指南将带你了解如何开始使用 Syncfusion® .NET MAUI 工具包，从安装和设置，到了解平台功能与组件生态系统。

什么是 Syncfusion® .NET MAUI 工具包？

Syncfusion® .NET MAUI 是一套基于 Microsoft 的 .NET Multi-platform App UI (MAUI) 框架构建的专业高性能 UI 组件，包含 20 多种组件。它支持你通过一个共享代码库编写一次代码，并将应用部署到 Android、iOS、macOS（通过 Mac Catalyst）和 Windows（通过 WinUI 3）。

主要亮点

• 20 多种专业组件： 全面的组件集合，涵盖布局、编辑器、日历等
• 单一代码库： 编写一次代码，即可同时部署到 Android、iOS、macOS 和 Windows
• 原生性能： 针对各平台进行优化，带来流畅、响应迅速的体验
• 现代化设计： 采用 Material Design，并自动支持深色模式
• 满足企业需求： 经过生产环境测试，符合 WCAG 标准，并提供全面的文档

快速概览

方面	详情
支持的平台	Android (API 21+)、iOS (12.2+)、macOS (12+)、Windows (10/11)
组件数量	20 多种专业 UI 控件
代码共享	跨平台代码复用率达 90%+
.NET 支持	.NET 9.0、.NET 10.0
开发工具	Visual Studio 2022、VS Code

文档和导航指南

入门与安装

📄 阅读： references/getting-started-installation.md

从这里开始，了解 Syncfusion® .NET MAUI 工具包包含的内容，查看完整的组件生态系统，并按照分步说明通过 NuGet Package Manager 或 Package Manager Console 安装。

涵盖主题：

• 什么是 Syncfusion® .NET MAUI 工具包，以及为何选择它
• 20 多种组件类别（数据可视化、按钮、布局、编辑器、日历、通知等）
• 通过 NuGet Package Manager 安装
• 主题配置和设置

平台支持与系统要求

📄 阅读： references/platforms-requirements.md

确认目标部署平台的支持情况和系统要求。了解 Android、iOS、macOS 和 Windows 开发的最低及推荐规格。

涵盖主题：

• 支持的平台和版本对照表
• 特定平台的功能与限制
• 硬件要求（最低及推荐配置）
• 开发所需的操作系统要求
• 所需的开发工具和 SDK

框架兼容性与 .NET 版本

📄 阅读： references/framework-compatibility.md

了解 Syncfusion® .NET MAUI 工具包与 .NET 版本的兼容性。了解支持的 .NET 版本以及版本选择的最佳实践。

涵盖主题：

• 支持的 .NET 版本（.NET 9.0、.NET 10.0）
• 版本兼容性对照表
• LTS（长期支持）建议
• 性能和稳定性注意事项

开发环境设置

📄 阅读： references/development-environment-setup.md

为 Windows、macOS 或 Visual Studio Code 配置开发环境。本指南全面介绍所有主要开发工具的安装、配置和验证。

涵盖主题：

• Visual Studio 2022 设置（Windows）
• Visual Studio Code 设置
• .NET SDK 的安装和验证
• Android SDK 与 iOS/Xcode 配置
• 常见设置问题的故障排除

跨平台开发基础

📄 阅读： references/cross-platform-development.md

了解构建跨平台应用的架构和模式。掌握代码共享策略、平台特定代码、资源管理和自适应布局。

涵盖主题：

• 单一代码库架构
• 代码复用模式（共享率达 90% 以上）
• 必要时使用平台特定代码
• 统一资源系统（图像、字体、素材）
• 自适应布局和响应式设计
• 跨平台主题适配

组件生态系统概览

📄 阅读： references/component-ecosystem.md

探索 Syncfusion® .NET MAUI Toolkit 中提供的 20 多个组件。了解组件类别、用途，以及如何根据需求选择合适的组件。

涵盖主题：

• 数据可视化（图表）
• 日历
• 编辑器
• 导航组件
• 按钮
• 布局组件
• 组件选择指南

快速入门清单

按照以下步骤开始使用 Syncfusion® .NET MAUI Toolkit：

• 确认系统要求 - 检查平台和硬件要求
• 安装 Visual Studio 2022 (17.8.0+) 并配置 .NET MAUI 工作负载，或使用其他 IDE
• 安装 .NET SDK - .NET 9.0 或 .NET 10.0
• 安装平台 SDK - Android SDK、Xcode（iOS/macOS）或 WinUI（Windows）
• 安装 Syncfusion® Toolkit NuGet 包 - Syncfusion.Maui.Toolkit 包
• 配置主题 - 应用 MaterialLight、MaterialDark 或自定义主题
• 创建示例项目 - 使用 Syncfusion® 组件构建测试应用
• 在目标平台上测试 - 部署到 Android、iOS、macOS 或 Windows

后续步骤

阅读本简介后：

1. 首次设置： 按照快速入门清单操作，并阅读“入门与安装”和“开发环境设置”指南
2. 探索组件： 查看“组件生态系统概览”，了解可用控件
3. 学习跨平台模式： 阅读“跨平台开发基础”，了解架构指导
4. 开始构建： 创建第一个 Syncfusion® .NET MAUI Toolkit 应用

有关特定组件的指导，请查阅各个 Syncfusion® 组件技能，了解详细的实现模式。