Xcode 27.1 and the iPhone Duo simulator
Status · checked 2026-10-05
Xcode 27.1 beta is out. Apple released it on 18 September 2026 (build 27A9269) with the iOS 27.1 SDK and the iPhone Duo simulator. Apple’s announcement.
Release timeline
We update this page whenever Apple ships something that changes it. If the date above is old, nothing has changed.
Free evaluation
Want us to test your app on the iPhone Duo simulator?
What you need
- A Mac running macOS Tahoe 26.6 or later. Apple’s release notes make this a hard requirement — check your CI machines too.
- Xcode 27.1 beta, installed alongside your release Xcode. Download it from Apple’s developer downloads.
- An iPhone Duo run destination. If Xcode does not offer one, check Xcode > Settings > Components, where Xcode lists the simulator runtimes it can download.
What ships with it
- The iPhone Duo simulator, which runs inside Device Hub. Apple’s Tech Talks describe on-screen controls to open, close, rotate and fold the device, so you can check a layout in every pose.
- The iOS 27.1 SDK and Swift 6.4 — the SDK is the tier at which your app reaches the screen edge and bar buttons lay out vertically. What that changes.
- A Display group in Previews. The canvas overrides picker can now preview content on a device’s alternative display, so you can compare the outer and inner displays without launching the simulator.
- App Resizability, the app modernization skill, which Apple’s Tech Talks describe as extended to cover SwiftUI and iPhone Duo. What it is for.
- The new APIs:
ReservedRegion,ArrangementView, the vertical bar behaviours and the camera coordinators, now documented in Apple’s written Preparing your app for iPhone Duo guide.
Known issues in the beta
Apple’s release notes list these, with workarounds where there is one:
- The first simulator launch can take several minutes. It has not hung.
- Most app extensions cannot run or be debugged in the iPhone Duo simulator. Test widgets, share extensions and the rest on a device.
- StandBy is unavailable in the iPhone Duo simulator runtime.
- Mac Catalyst builds fail on iOS 27.1 APIs with “undeclared identifier” and similar errors. Wrap that code in
#if !targetEnvironment(macCatalyst). - Targets set to iOS 27.1 show no Mac Catalyst run destination. Add a Mac Catalyst 27.0 minimum deployment target.
Checks that do not need the simulator
The simulator shows you what is wrong. Most of the fixes are old code making assumptions that stopped being true on 9 September, and you can find them with a search — including on a CI machine that cannot run the beta yet:
| Check | Why it needs no new tooling |
|---|---|
| Find hard-coded widths | A grep. The inner display is 626 points wide, not ~400. |
Replace UIScreen.main | A grep, then read scale from the trait collection. |
| Fix symmetric safe-area maths | Search for insets.left * 2 and similar. |
| Audit idiom checks | iPhone Duo reports the phone idiom at regular width. |
| Run your iPad target | The inner display is regular-width in both dimensions — your iPad layout is often the right one. |
Snapshot tests at 626 × 890 and 466 × 678 points catch regressions cheaply in CI. They will not exercise the fold or the poses — keep a manual pass in Device Hub for those.
Common questions
Is Xcode 27.1 available to download yet?
How do I get the iPhone Duo simulator?
What is Device Hub?
What can the iPhone Duo simulator not do yet?
What screen sizes should I test against?
Before the device ships on 23 October
The checklist covers what the simulator will show you, plus the items it will not. Run it, send us the report, and we will come back with your outstanding items prioritised and a realistic effort estimate — free, one written reply.