Xcode: How to Handle “iPhone Duo’s iOS Simulator platform doesn’t match App.app’s supported platforms.”

When you run an app on the iPhone Duo Simulator in Xcode 27.1 beta, the build may finish but Xcode can reject the product with “iPhone Duo’s iOS Simulator platform doesn’t match App.app’s supported platforms.” This guide separates what Apple has officially confirmed from troubleshooting steps that remain provisional because Apple has not yet published a root cause for the reported case.

Representative error

iPhone Duo’s iOS Simulator platform doesn’t match App.app’s supported platforms.

You can change App.app’s Base SDK or Supported Platforms to support iPhone Duo.

The Apple Developer Forums report describes this diagnostic in Xcode 27.1 even though the target’s Supported Platforms setting already identifies iOS.

Cause

The immediate meaning is that Xcode could not match the platforms recorded in the built App.app with the selected iPhone Duo Simulator runtime. The comparison can involve the Base SDK, Supported Platforms, the SDK actually used for the active configuration, and generated bundle metadata such as CFBundleSupportedPlatforms.

As of September 30, 2026, Apple has not replied to the specific forum report and has not published a root cause or fixed version for this exact failure. It is therefore not justified to claim that adding an undocumented platform token to Supported Platforms is a confirmed fix.

Affected conditions and versions

• Xcode 27.1 beta with iPhone Duo selected as the run destination
• The iOS 27.1 Simulator runtime supplied for iPhone Duo
• A target or configuration whose Base SDK or Supported Platforms is not reflected as expected in the built product
• A stale product or DerivedData created with another Xcode or SDK
• Command-line tools pointing to a different Developer Directory than the Xcode GUI

The final three items are troubleshooting hypotheses, not causes Apple has confirmed for the forum report.

Recommended troubleshooting

1. Use the Xcode build that officially supports iPhone Duo

Download Xcode 27.1 beta from Apple Developer and open the project with that application. For Duo testing, do not assume Xcode 27.2 beta is preferable simply because its version number is higher.

xcodebuild -version
xcode-select -p
xcrun simctl list runtimes | grep -i "iOS 27.1"

If several Xcode versions are installed, also verify the Developer Directory used by Terminal. Point it to the 27.1 beta installation when necessary.

sudo xcode-select -s /Applications/Xcode-27.1-beta.app/Contents/Developer

2. Restore Base SDK and Supported Platforms to standard values

1. Select the app target and open Build Settings.
2. Set Base SDK to “Latest iOS.”
3. If Supported Platforms contains hand-written overrides, remove them and restore the standard or inherited values for an iOS app.
4. Check Debug, Release, and every custom build configuration for configuration-specific overrides.
5. Repeat the check for app extensions and frameworks that are embedded in the runnable product.

Inspect the effective settings rather than relying only on what the Xcode editor displays:

xcodebuild -showBuildSettings   -scheme App   -configuration Debug   -sdk iphonesimulator   | egrep 'SDKROOT|SUPPORTED_PLATFORMS|PLATFORM_NAME|EFFECTIVE_PLATFORM_NAME'

3. Rebuild specifically for iPhone Simulator

Choose Product → Clean Build Folder, reselect the iPhone Duo Simulator, and build again. If the error remains, quit Xcode and move aside or delete only this project’s DerivedData before rebuilding.

4. Inspect the product Xcode actually generated

Confirm that the product is in a simulator build directory and inspect its generated metadata.

plutil -p "/path/to/Build/Products/Debug-iphonesimulator/App.app/Info.plist"   | grep -A 4 CFBundleSupportedPlatforms

file "/path/to/Build/Products/Debug-iphonesimulator/App.app/App"

The product should come from Debug-iphonesimulator or the corresponding simulator configuration. Do not patch the built app’s Info.plist directly. Correct the target’s build settings and let Xcode regenerate the bundle.

Alternatives

• Continue non-Duo work on a standard iPhone or iPad Simulator.
• Test resizable layouts with iPad window resizing and ordinary size classes while Duo execution is blocked.
• Pin Xcode and DEVELOPER_DIR in CI, and isolate Duo tests in a job that uses Xcode 27.1 beta.
• If a minimal project reproduces the error, submit it through Feedback Assistant with Xcode diagnostics and a sysdiagnose.

Until Apple documents a fix, avoid inserting guessed or undocumented values into SUPPORTED_PLATFORMS.

How to verify the result

1. Confirm that Xcode 27.1 beta lists the iPhone Duo Simulator as a destination.
2. Use xcodebuild -showBuildSettings to confirm that the active configuration uses the iPhone Simulator SDK.
3. Clean and rebuild, then verify that the output path contains *-iphonesimulator.
4. Run the app and confirm that the platform-mismatch diagnostic no longer appears.
5. Run the same target on a standard iPhone Simulator to check for regressions.

Important notes

• Xcode 27.1 beta is pre-release software. Check the current App Store Connect requirements separately before archiving or submitting a production build.
• The iPhone Duo Simulator has documented limitations: StandBy is unavailable, and running or debugging most app extensions is unavailable. Do not confuse those limitations with this platform mismatch.
• Xcode 27.2 beta is not Apple’s download for the iPhone Duo SDK and simulator; Apple specifically points developers to Xcode 27.1 beta.
• Because the forum report has no Apple response yet, keep a possible tooling defect in scope if standard settings and a clean build still reproduce the error.

Summary

iPhone Duo’s iOS Simulator platform doesn’t match App.app’s supported platforms. means Xcode rejected the built app during destination compatibility checking. Start with the officially supported Xcode 27.1 beta, restore Base SDK and Supported Platforms to their standard values, remove stale build output, and rebuild for the simulator. Apple has not yet published the case-specific root cause or a fixed version, so verify effective settings and generated metadata instead of relying on an undocumented workaround.

Official references

• Apple Developer Forums: iPhone Duo’s iOS Simulator supported platforms
• Xcode 27.1 Beta Release Notes
• Xcode 27.2 Beta Release Notes
• Get ready for iPhone Duo