Xamarin.iOS 迁移至 .NET MAUI 后通知服务扩展问题解析

背景介绍

在从 Xamarin.Forms 迁移到 .NET MAUI 的过程中，开发者遇到了 iOS 平台上的通知服务扩展(Notification Service Extension)功能失效的问题。该扩展原本用于增强推送通知内容，特别是添加图片附件功能。

核心问题分析

迁移后出现的主要问题表现在两个方面：

1. 本地开发环境问题：在 PC 端通过 Mac 构建时出现 "ditto" 命令执行失败的错误
2. 持续集成问题：在 DevOps 流水线中构建时无法找到 Xamarin.iOS 的扩展目标文件

技术根源

问题的根本原因在于项目结构未完全迁移：

1. 项目类型不匹配：通知服务扩展项目仍保留着 Xamarin.iOS 的项目结构，使用了旧的 Xamarin.iOS.AppExtension.CSharp.targets 构建目标
2. 构建系统差异：.NET MAUI 使用新的 SDK 风格项目，而遗留的 Xamarin 扩展项目与新的构建系统不兼容
3. 环境配置问题：PC 端与 Mac 端开发环境存在差异，导致构建行为不一致

解决方案

1. 项目结构迁移

需要将通知服务扩展项目完全迁移到 .NET 风格：

• 移除旧的 ProjectTypeGuids 和 Xamarin.iOS 引用
• 使用新的 SDK 风格项目文件
• 更新构建目标和工具链

2. 构建配置调整

对于持续集成环境：

• 确保使用正确的 .NET 工作负载
• 更新构建代理上的工具链
• 验证构建环境的一致性

3. 开发环境统一

建议采取以下措施：

• 在 Mac 上直接使用 Visual Studio Code 进行验证
• 确保 PC 和 Mac 端的开发环境配置一致
• 检查网络连接和权限设置

最佳实践建议

1. 彻底迁移项目：不要混合使用 Xamarin 和 .NET MAUI 的项目结构
2. 环境标准化：保持开发、测试和生产环境的一致性
3. 渐进式迁移：复杂功能建议分步骤验证
4. 日志收集：完善构建日志记录以便问题诊断

总结

从 Xamarin 迁移到 .NET MAUI 时，需要特别注意扩展项目的完全迁移。通知服务扩展这类平台特定功能更需要对项目结构和构建系统进行彻底更新。通过标准化项目结构和统一开发环境，可以避免此类兼容性问题，确保功能正常运作。