使用Fastlane+Github Actions运行Swift Xcode项目测试时找不到匹配目标设备

Github Actions中报错信息 #

xcodebuild: error: Unable to find a destination matching the provided destination specifier:
        { platform:iOS Simulator, id:983B36D8-0EF5-4C71-BA8B-64D908B7DD14 }
[08:17:33]: Exit status: 70

Fastlane配置 #

desc "Run tests"
lane :tests do
  scan(scheme: "ProjName Dev")
end

本地命令行复现情况 #

执行的测试命令：

xcodebuild build -project "ProjName.xcodeproj" -scheme "ProjName Dev" -configuration "Debug Dev" -destination "platform=iOS Simulator,name=iPhone 15,OS=17.5" test

终端报错：

xcresult
xcodebuild: error: Unable to find a destination matching the provided destination specifier:
        { platform:iOS Simulator, OS:17.5, name:iPhone 15 }

已确认的本地环境 #

MacBook已安装对应iOS模拟器：iPhone 15，OS 17.5

解决步骤 #

1. 核对模拟器的准确标识 #

先通过命令列出所有可用模拟器，确认目标设备的名称、版本或ID完全匹配：

xcrun simctl list devices

复制输出中iPhone 15模拟器的完整名称、系统版本或设备ID，避免因格式、大小写或空格差异导致匹配失败。

2. 明确Fastlane的scan目标配置 #

修改tests lane，手动指定模拟器参数，避免自动匹配出错：

desc "Run tests"
lane :tests do
  scan(
    scheme: "ProjName Dev",
    destination: "platform=iOS Simulator,name=iPhone 15,OS=17.5"
    # 也可直接用设备ID：destination: "id=983B36D8-0EF5-4C71-BA8B-64D908B7DD14"
  )
end

3. 修正本地xcodebuild命令 #

去掉冗余的build参数（test命令已包含编译步骤），并确保destination格式正确：

xcodebuild test -project "ProjName.xcodeproj" -scheme "ProjName Dev" -configuration "Debug Dev" -destination "platform=iOS Simulator,name=iPhone 15,OS=17.5"

4. 确保Github Actions环境安装对应模拟器 #

在Workflow文件中添加模拟器安装步骤，或指定匹配的Xcode版本（Xcode 15.4对应iOS 17.5模拟器）：

- name: 安装iOS 17.5模拟器
  run: |
    xcodebuild -downloadPlatform iOS
    xcrun simctl create "iPhone 15" com.apple.CoreSimulator.SimDeviceType.iPhone-15 com.apple.CoreSimulator.SimRuntime.iOS-17-5

# 或者指定Xcode版本
- name: 设置Xcode环境
  uses: actions/setup-xcode@v2
  with:
    xcode-version: '15.4'

5. 本地调试时重置模拟器服务 #

如果本地仍报错，尝试重置模拟器相关服务：

xcrun simctl shutdown all
xcrun simctl erase all
killall Simulator
killall com.apple.CoreSimulator.CoreSimulatorService

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