使用xcodebuild运行Apple Watch UI测试提示找不到匹配的目标设备

问题核心原因 #

你要运行Apple Watch的测试target，不能仅指定配对的iPhone模拟器ID作为目标，xcodebuild需要显式匹配watchOS平台的运行目标，仅传iPhone ID会被判定为和Watch测试target的平台不兼容。

解决步骤 #

第一步：获取已配对的Watch模拟器ID #

执行以下命令查询当前可用的watchOS模拟器列表，找到与你使用的iPhone 12 Pro（ID: F35DCC98-0F7D-460E-A49F-A446FD5FB4BE）配对的Watch设备UUID：

xcrun simctl list devices watchOS

第二步：执行测试命令，二选一即可 #

方案1：直接指定watchOS模拟器为运行目标

将命令中的destination参数替换为你查到的Watch模拟器ID即可：

xcodebuild test -workspace WatchTesterApp.xcworkspace -scheme 'Watch' -destination 'platform=watchOS Simulator,id=替换为你查到的Watch模拟器ID'

适用场景：独立的Watch App UI测试，不需要依赖iPhone侧联动逻辑

方案2：同时指定配对的iPhone+Watch组合目标

如果你的测试需要iPhone和Watch双端联动，使用双destination参数即可：

xcodebuild test -workspace WatchTesterApp.xcworkspace -scheme 'Watch' -destination 'platform=iOS Simulator,id=F35DCC98-0F7D-460E-A49F-A446FD5FB4BE' -destination 'platform=watchOS Simulator,id=替换为你查到的Watch模拟器ID'

异常排查点 #

• 先检查Watch scheme的测试配置：打开Xcode进入scheme编辑界面，确认Test tab下已经正确添加Watch UI测试target，且目标运行平台设置为watchOS模拟器，系统版本与你使用的模拟器版本一致。
• 执行测试前先启动对应模拟器：运行xcrun simctl boot 模拟器ID分别启动iPhone和Watch模拟器，避免冷启动时xcodebuild识别不到目标设备。
• 清理派生数据重试：如果仍提示找不到目标，执行rm -rf ~/Library/Developer/Xcode/DerivedData清理缓存后再重新运行测试命令。

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