请求将Xamarin.iOS降级至14.17以适配Xcode12.4并解决构建错误

问题背景 #

• 开发环境：Windows 10 + Visual Studio 2022，连接Mac构建主机（MacOS 10.15.7 + Xcode 12.4，因硬件限制无法升级系统及Xcode）
• 连接Mac时，Visual Studio提示Xamarin与Xcode 12.4不兼容，建议升级Xcode至12.5或更高版本，且旧版本可能引发异常警告或错误
• 构建项目时出现文件缺失错误：
  1. 初始错误：找不到路径/Users/xxxx/Library/Caches/Xamarin/mtbs/builds/RetailApplication.iOS/d967d3a2c8371f3518eeb13eb0586ef2298912b5e49700e0a350cef56add41d4/Assets.xcassets/AppIcon.appiconset/Icon1024.png
  2. 添加对应资源后，新错误：找不到路径/Users/xxxx/Library/Caches/Xamarin/mtbs/builds/RetailApplication.iOS/d967d3a2c8371f3518eeb13eb0586ef2298912b5e49700e0a350cef56add41d4/Assets.xcassets/AppIcon.appiconset/_/114.png，未在项目中指定过该路径及文件，怀疑由Xcode版本过低导致
• 核心需求：将Xamarin.iOS降级至14.17版本（该版本兼容Xcode 12.4，而Xamarin.iOS 14.19要求最低Xcode 12.5）

降级Xamarin.iOS至14.17版本步骤 #

Windows端操作 #

1. 卸载当前Xamarin.iOS版本

   • 打开「控制面板 > 程序和功能」
   • 找到「Xamarin.iOS」，右键选择卸载，按提示完成操作

2. 下载并安装Xamarin.iOS 14.17

   • 从微软Xamarin版本存档中获取与Visual Studio 2022匹配的Xamarin.iOS 14.17安装包（需对应VS版本：社区版/专业版/企业版）
   • 关闭Visual Studio 2022，运行安装包，按向导完成安装

Mac端操作 #

1. 卸载当前Xamarin.iOS版本

   • 打开终端，执行命令：

     sudo /Library/Frameworks/Xamarin.iOS.framework/Versions/Current/uninstall
     

   • 输入管理员密码确认执行

2. 安装Xamarin.iOS 14.17

   • 从微软Xamarin版本存档中下载Mac版Xamarin.iOS 14.17安装包
   • 运行安装包，按提示完成安装

验证与收尾 #

1. 打开Visual Studio 2022，重新连接Mac设备
2. 检查「工具 > iOS > 查看Xamarin.iOS版本」，确认Windows与Mac端版本均为14.17
3. 重新构建项目，验证之前的文件缺失错误是否消除

版本兼容性说明 #

• Xamarin.iOS 14.17官方支持Xcode 12.4，适配当前Mac环境
• Xamarin.iOS 14.19要求最低Xcode 12.5，与当前Mac环境不兼容，这是引发兼容性提示及构建错误的根本原因

内容的提问来源于stack exchange，提问作者0brine