MAUI iOS部署旧版模拟器遇问题：Xcode与运行时版本不匹配

问题背景 #

使用最新maui-ios workload，同时通过XcodesApp保留了Xcode 15.2和15.4两个版本。Xcode 15.2自带iOS 17.2模拟器运行时，Xcode 15.4中能看到该模拟器，但构建简单MAUI应用时失败，系统会搜索Xcode 15.4自带的iOS 17.5运行时。错误日志如下：

<key>com.apple.actool.errors</key>
<array>
  <dict>
    <key>description</key>
    <string>The operation couldn’t be completed. Failed to locate any simulator runtime matching options: {BuildVersionString = 21F77;Platforms =     ("com.apple.platform.iphonesimulator");VersionString = "17.5";}</string>
    <key>failure-reason</key>
    <string>Failed to locate any simulator runtime matching options: {BuildVersionString = 21F77;Platforms =     ("com.apple.platform.iphonesimulator");VersionString = "17.5";}</string>
  </dict>
</array>

不想安装iOS 17.5，同时疑问：测试旧版iOS系统时，是否必须安装对应版本的Xcode？是否存在操作错误？

核心原因 #

MAUI的iOS构建依赖当前活跃Xcode版本的默认SDK。Xcode 15.4捆绑了iOS 17.5 SDK，因此构建系统默认会尝试使用该版本的模拟器运行时，即便旧版本模拟器可见，也不会自动降级使用。

旧版iOS测试的必要性说明 #

不需要强制安装对应Xcode版本。只要已安装目标iOS版本的模拟器运行时，通过配置项目或切换活跃Xcode版本，即可实现旧版iOS测试。

具体解决方法 #

1. 显式指定项目目标iOS版本 #

修改MAUI项目的.csproj文件，将TargetFrameworks设置为目标旧版本（如iOS 17.2），覆盖Xcode默认的SDK版本：

<TargetFrameworks>net8.0-ios17.2;net8.0-android;net8.0-windows10.0.19041.0</TargetFrameworks>

同时可设置最低兼容版本：

<MinimumOSVersion>17.2</MinimumOSVersion>

2. 切换活跃Xcode版本 #

使用终端命令切换到Xcode 15.2（对应iOS 17.2运行时）：

sudo xcode-select -s /Applications/Xcode_15.2.app

验证当前活跃Xcode路径：

xcode-select -p

后续需要使用Xcode 15.4时，再切换回去：

sudo xcode-select -s /Applications/Xcode_15.4.app

3. 确认模拟器运行时注册状态 #

检查已安装的模拟器运行时列表：

xcrun simctl list runtimes

如果iOS 17.2运行时已列出，可通过项目的调试目标选择对应的模拟器，强制构建使用该运行时。

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