WDA build fails on physical iOS device: "Please supply only supported device specifier options"

[VictorGTdaCruz]

Summary

On a physical iPhone, the WebDriverAgent build fails with Please supply only supported device specifier options. — even though the device appears in the list of valid destinations that the error itself prints.

Environment

• maestro-runner 1.1.27
• macOS 15.4.1, Intel (MacBook Pro 2018)
• Xcode 16.4
• iPhone XS, iOS 16.1.2

Command

maestro-runner --platform ios --team-id <TEAM> --app-file /tmp/app.ipa \
  -e APP_ID=<bundle-id> test flow.yaml

What happens

Device discovery and app install both succeed. The failure is in the WDA build:

  ✓ Found device: 00008020-001671A036F1002E
  ✓ App installed
  ⏳ Building WDA...
Error: failed to create driver: WDA build failed: build failed:
 Please supply only supported device specifier options.

 Available destinations for the "WebDriverAgentRunner" scheme:
  ...
  { platform:iOS, id:00008020-001671A036F1002E, name:iPhone de Amanda }
  { platform:iOS Simulator, arch:x86_64, id:B0E86748-..., OS:18.6, name:iPhone 16 }

Likely cause

The target device is present in that list, so the destination exists. Note that its entry carries no arch: and no OS:, unlike every simulator entry. xcodebuild rejects arch= and OS= for a physical-device destination, so a specifier built for simulators would produce exactly this error.

Also

--no-driver-install does not work around it. With the flag, the run skips the ✓ WDA installed check but still enters ⏳ Building WDA... and fails the same way. A previous run had already reported ✓ WDA installed, so the rebuild appears unnecessary in this case.

Happy to test a patch — the device is available.