SuperAPI AI 工具集

xamarin-maui-syncfusion-migration

通用与其它

查看项目

更新于 10-16 07:28

技能介绍

用途:在将 Xamarin.Forms 应用迁移到 .NET MAUI 时,专门处理 Syncfusion 控件的迁移,按控件给出精确的 API、事件与方法映射。技能自包含,依赖其文件夹内捆绑的参考文件,控件级映射位于 references/controls/*.md。建议的技能顺序为:xamarin-maui-framework-migration、本技能、xamarin-maui-platform-specific-migration、xamarin-maui-renderer-handler-migration;应在基线 MAUI 项目迁移完成后使用。

主要能力:检测 XAML 与 C# 中的 Syncfusion 控件、命名空间、枚举与 API;按控件和功能区域分组,分类为直接映射、拆分映射、重命名映射或过时映射;执行命名空间替换与 API 重命名;识别不支持或已过时控件并给出替代方案;生成带风险标签的迁移待办清单;校验 MauiProgram 中的 Syncfusion 核心与控件依赖注册;输出控件清单、重命名清单、人工待办、就绪评分、启动注册清单、按控件风险热力图与视觉一致性检查表。

使用方式:输入为目标 MAUI 项目根目录、源 Xamarin.Forms 代码及本技能内参考文件;可选输入包括按功能区域划分的控件列表、影响 Syncfusion 控件的样式/主题资源、用于视觉一致性检查的截图。可选行为开关有 dry run(仅分析输出)、strict 模式(存在未解决映射时失败)、控件过滤(限定迁移范围)。

命名空间迁移:XAML 声明模式为 xmlns:prefix="clr-namespace:Syncfusion.Maui.ControlNamespace;assembly=Syncfusion.Maui.ControlNamespace",例如 Popup 用 xmlns:sfPopup="clr-namespace:Syncfusion.Maui.Popup;assembly=Syncfusion.Maui.Popup",Charts 用 xmlns:sfChart="clr-namespace:Syncfusion.Maui.Charts;assembly=Syncfusion.Maui.Charts",DataGrid 用 xmlns:sfGrid="clr-namespace:Syncfusion.Maui.DataGrid;assembly=Syncfusion.Maui.DataGrid"。C# 需添加 using Syncfusion.Maui.Core.Hosting;(提供 ConfigureSyncfusionCore())、using Syncfusion.Maui.Core; 及控件专属命名空间。注册规则要求 MauiProgram 调用 builder.ConfigureSyncfusionCore(),安装 Syncfusion.Maui.Core 作为基线依赖;即使只使用部分控件,注册仍为必需(除非文档明确说明例外)。

适用场景:XAML 或 C# 中出现 Syncfusion.*.XForms 命名空间、Syncfusion Xamarin 控件出现在页面/模板/自定义控件中、迁移后出现 API 或枚举重命名问题、拆分控件迁移(如 Xamarin SfChart 到 MAUI 各图表家族)。

限制:不用于非 Syncfusion 为主的迁移、纯平台清单/plist 能力迁移、与 Syncfusion 控件无关的自定义渲染器到处理器的重写。不得在文档已有明确映射时推断未记录映射;未解决的映射须报告为阻塞或高风险项;图表、网格、调度器、编辑器等高影响控件必须做行为一致性检查。迁移未完成,直到所有 Syncfusion 用法被映射、替换或明确延后,且 MauiProgram 启动注册已验证、代码中不残留 Xamarin Syncfusion 命名空间。参考文件包括 common-migration-summary.md、control-doc-index.md、nuget-package-map.md。