用途:将 Xamarin.Forms 基于渲染器的 UI 定制迁移到 .NET MAUI 的 Handler 架构。它适合在完成基础命名空间/API 迁移与平台迁移之后使用,用于处理渲染器与效果转换。
主要能力:检测自定义渲染器、效果和平台原生视图定制;将渲染器职责映射到 Handler 的属性映射与命令映射;生成 Handler 类及平台分部实现模板;为高风险原声映射生成人工处理待办清单;输出渲染器清单与分类报告、按控件/效果的映射方案、风险热力图与验证测试矩阵。
使用方式:推荐按顺序运行相关技能:xamarin-maui-framework-migration、xamarin-maui-syncfusion-migration、xamarin-maui-platform-specific-migration,最后运行本技能。输入需要 MAUI 目标项目根目录,以及来自 Xamarin.Forms 的渲染器/效果源文件;建议提供控件 API、可绑定属性定义、现有 MAUI 自定义控件抽象、平台渲染行为说明与截图。可选标志包括 dry run(仅分析)、scaffold only(仅生成模板)、strict mode(存在未解决的关键映射项时失败)。
适用场景:存在 ExportRenderer 属性或渲染器注册;存在继承 ViewRenderer、PageRenderer、ShellRenderer 等的自定义渲染器类;存在 Android、iOS、Windows/UWP 平台效果;在 OnElementChanged、OnElementPropertyChanged 或生命周期回调中操作原生控件;以及原生绘图、手势、无障碍或输入处理逻辑。
限制:不适用于纯命名空间替换、无自定义 UI 层的依赖迁移、或没有渲染器与效果逻辑的平台能力迁移。默认采用增量迁移(先脚手架后替换接线);存在高风险渲染器时须有明确验证场景;未解决的原生 API 调用必须记录为人工操作;须显式验证无障碍行为一致性;在渲染器接线移除且一致性检查通过前,迁移不算完成。资料未提供具体收费、价格与平台支持细节。