用途:在把 Xamarin.Forms 代码迁移到 .NET MAUI 应用时,安全迁移平台专属代码。仅关注平台相关问题:Android 清单、组件与运行时权限;iOS Info.plist 键、entitlements、URL schemes 与生命周期集成;Windows 目标行为与 UWP 到 Windows 的映射;原生 SDK 启动与生命周期对齐。
建议顺序:先运行 xamarin-maui-framework-migration,再 xamarin-maui-syncfusion-migration,然后本技能,最后 xamarin-maui-renderer-handler-migration。用于基线迁移之后、最终 renderer-handler 清理之前补齐平台差异。
适用场景:存在自定义 AndroidManifest 条目、intent filters 或 exported 组件;iOS ATS 例外、关联域、推送通知或 URL schemes;UWP 专属 API 或 Windows 声明需要映射;AppDelegate、MainActivity 或自定义启动类中的原生 SDK 初始化;深层链接、通知、前台服务、后台任务或依赖生命周期的功能。不适用于仅迁移共享业务逻辑、纯 XAML 命名空间替换、以 renderer 到 handler 重写为主的任务。
输入:必需 MAUI 目标项目根目录、Xamarin 源平台文件或片段;推荐提供 AndroidManifest.xml 及 Android 启动类、Info.plist 与 entitlements、UWP 项目声明与能力条目、平台 SDK 初始化片段;可选行为开关包括 dry run 和 strict parity 模式。
输出:按目标平台生成平台迁移清单、能力对齐报告(保留、替换、缺失、不支持)、带严重级别与理由的人工操作待办;次要输出包括 MAUI 启动/生命周期映射建议、平台变更风险热力图、冒烟测试验证计划。
工作流:平台盘点与基线;Android 映射(清单条目、运行时权限、intent filters、exported 设置、包可见性);iOS 映射(Info.plist 与 ATS、entitlements 与关联域、生命周期钩子与推送/深层链接入口);Windows/UWP 映射(识别 UWP 专属 API,映射到 MAUI Windows 等效项,不支持项给出替换指引);原生 SDK 与生命周期对齐;验证与报告。
安全约束:不得静默丢弃平台能力;缺失能力须报告为阻塞或高风险项;不支持特性须给出替换路径或豁免要求;平台迁移完成前必须有验证证据。参考资料包括 references/platform-checklist.md 及相关技能文档。完成标准:生成 Android、iOS、Windows 范围清单,能力对齐报告无未解决阻塞,缺失或不支持项已修复或明确豁免,启动与生命周期映射已验证,并存在覆盖所有迁移平台入口的冒烟测试计划。缺失事实暂未提供,如具体命令、安装方式、价格与平台支持等。