用途:把 Xamarin.Forms 代码迁移到 .NET MAUI 项目,提供可重复、可审计的流程;既支持整个解决方案迁移,也支持把代码逐模块复制到已有或新建 MAUI 应用中。依据微软指南:先将 Xamarin.Forms 升级到最新 5.x 基线,再新建 .NET MAUI 项目,随后复制并转换代码、资源、依赖和平台资源,替换不兼容 API 并现代化架构,最后验证并报告迁移就绪度和剩余手工工作。
主要能力:多项目到单项目转换;命名空间与 API 现代化;依赖兼容性分类;渲染器到处理器的迁移规划;迁移就绪度与风险分析。执行流程包括预检分析(识别弃用 API、DependencyService、MessagingCenter、自定义渲染器及平台配置)、生成 MAUI 目标骨架、代码与 XAML 转换、资源与平台迁移、依赖与 API 现代化、渲染器到处理器转换、验证与报告。规则示例:Xamarin.Forms 改为 Microsoft.Maui.Controls,Xamarin.Essentials 改为 Microsoft.Maui,DependencyService 改为 MAUI DI,图片放入 Resources/Images。
使用方式:输入为 Xamarin.Forms 解决方案根目录、含复制源文件的文件夹或指定源文件列表;可选 dry run、Shell 迁移建议、增量模式。输出为转换后的 .NET MAUI 单项目结构、迁移报告 JSON、手工修复待办、风险热力图和平台迁移清单。建议按顺序运行本技能及其配套技能:先本技能,再 Syncfusion 迁移、平台特定迁移、渲染器与处理器迁移。
限制:默认采用新建项目迁移而非就地升级;不适用于非 Xamarin 移动技术栈;高级自定义渲染器不能全自动转换,须人工验证。仓库目前仅提供技能定义与参考指南,自动化脚本暂未提供。