Xamarin iOS部署失败：simctl返回退出码4，求助后续解决方案

三天前应用还能在Mac的iOS模拟器正常运行部署，今日运行时出现错误，Visual Studio报错：

Severity    Code    Description Project File    Line    Suppression State
Error       error HE0046: Failed to install the app 'com.companyname.appname' on the device 'iOS 16.4 (xxxxx) - iPhone 14 Pro': simctl returned exit code 4 

手动执行xcrun simctl install命令后，得到核心错误：

An error was encountered processing the command (domain=IXUserPresentableErrorDomain, code=4):
Simulator device returned an error for the requested operation.
This app needs to be updated by the developer to work on this version of iOS.
Failed to find matching arch for input file: /Users/xxx/Library/Developer/CoreSimulator/Devices/xxx-D7E4-4571-xxx-xxx/data/Library/Caches/com.apple.mobile.installd.staging/temp.iMe6mP/extracted/MaxGoiOS.app/app
Underlying error (domain=IXUserPresentableErrorDomain, code=4):
    “MyApp” Needs To Be Updated
    This app needs to be updated by the developer to work on this version of iOS.

已尝试的操作：

• 通过【Device -> Erase all content and Settings】清除模拟器数据
• 确认Xcode -> Preferences -> Location -> Command Line Tools已设置为Xcode 14.3.1 (14E300c)
• 检查iOS项目属性 -> iOS build -> Supported Architecture已设置为i386 + x86_x64

环境信息：

• Microsoft Visual Studio Enterprise 2022 (64-bit) - Current - Version 17.6.4
• Mac Book Pro 2018 Ventura 13.5 Intel Core

1. 清理构建缓存并重新构建 #

• 关闭Visual Studio，删除项目根目录下的bin和obj文件夹
• 删除Xamarin的MTBS缓存：前往~/Library/Caches/Xamarin/mtbs/builds，找到对应项目的缓存文件夹并删除
• 重新打开Visual Studio，执行「清理解决方案」，再重新构建并部署

2. 修正Build Configuration架构设置 #

• 确保当前选择Debug配置（Ad-Hoc配置针对真机发布，模拟器应使用Debug）
• 进入iOS项目属性 -> iOS Build -> Advanced选项卡：
  • 将Supported architectures改为x86_64（Intel Mac的iOS 16模拟器仅支持64位架构，i386已被废弃）
  • 检查Linker behavior设置，避免因链接器优化导致架构信息丢失
  • 取消勾选「Use incremental builds」，尝试全量构建

3. 验证App包的架构信息 #

• 打开终端，进入构建生成的.app文件夹路径（示例：xxx/bin/iPhone/Debug/MyApp.app）
• 执行命令查看二进制文件架构：

lipo -info MyApp

• 确保输出包含x86_64，若缺失则说明构建未生成对应架构的二进制，需重新核对项目设置

4. 更新Xamarin.iOS与Visual Studio组件 #

• 打开Visual Studio，进入「Tools -> Options -> Xamarin -> iOS Settings」，检查并安装最新兼容的Xamarin.iOS版本
• 确认Visual Studio的iOS相关组件版本与Xcode 14.3.1匹配

5. 切换模拟器版本或设备 #

• 尝试使用iOS 15.x版本的模拟器（需Xcode已安装对应SDK），验证是否为iOS 16.4模拟器的兼容性问题
• 切换到其他模拟器设备（如iPhone 13），测试能否正常部署

6. 重置模拟器服务与环境 #

• 关闭模拟器和Xcode，执行以下命令重置模拟器服务：

killall -9 com.apple.CoreSimulator.CoreSimulatorService
xcrun simctl shutdown all
xcrun simctl erase all

• 重启Xcode和Visual Studio后再次尝试部署

内容的提问来源于stack exchange，提问作者Yohanes AI