Github Actions中Xcodebuild无法找到指定iOS Simulator构建目标

错误原因拆解 #

• 构建失败的核心原因：你指定的iOS Simulator, OS=18.1, name=iPhone 16 Pro不在GitHub Runner的可用目标列表里，当前Runner只有macOS相关的构建目标，xcodebuild找不到匹配项所以报错退出。
• 关于iOS 18.2的提示：这是真实设备占位符的不合格提示，和你要的Simulator完全无关，只是Xcode输出的额外信息，不用理会。

具体修复步骤 #

1. 修正xcodebuild命令语法错误 #

你的构建命令末尾缺少闭合双引号，会导致参数解析异常：
原错误命令：

xcodebuild -scheme "MyApp Demo" -destination "platform=iOS Simulator,name=iPhone 16 Pro,OS=18.1

修正后：

xcodebuild -scheme "MyApp Demo" -destination "platform=iOS Simulator,name=iPhone 16 Pro,OS=18.1"

2. 在Action中安装指定的iOS Simulator #

GitHub Hosted Runner默认不会预装所有版本的Simulator，需要手动添加安装步骤：
在你的build步骤前添加：

- name: 安装iOS 18.1 Simulator
  run: |
    xcode-select -s /Applications/Xcode.app
    # 列出已安装的运行时，方便调试
    xcrun simctl list runtimes
    # 创建指定的iPhone 16 Pro + iOS18.1模拟器
    xcrun simctl create "iPhone 16 Pro" com.apple.CoreSimulator.SimDeviceType.iPhone-16-Pro com.apple.CoreSimulator.SimRuntime.iOS-18-1

3. 可选：指定Xcode版本（确保支持iOS18.1） #

如果Runner默认的Xcode版本不支持iOS18.1，需要先切换到对应版本：

- name: 选择支持iOS18.1的Xcode版本
  uses: maxim-lobanov/setup-xcode@v1
  with:
    xcode-version: '15.4' # Xcode15.4对应支持iOS18.1

4. 可选：使用更灵活的destination匹配 #

如果不需要严格指定OS版本，可以用更宽松的匹配规则，避免版本不一致问题：

# 匹配最新可用的iPhone 16 Pro Simulator
xcodebuild -scheme "MyApp Demo" -destination "platform=iOS Simulator,name=iPhone 16 Pro,OS=latest"

# 或者直接匹配任意iOS Simulator
xcodebuild -scheme "MyApp Demo" -destination "platform=iOS Simulator"

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