跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

iphone-duo

Implementation guide for adapting apps to Apple's iPhone Duo, an iPhone with multiple displays and a fold. Covers size class, safe area asymmetry, reserved regions, vertical bars, arrangement, hinge, scene accessories, and dual front cameras. Always use this skill when iPhone Duo, a foldable iPhone, inner/outer displays, vertical toolbars, hinge angle, reserved region, ArrangementView, CameraCaptureAccessory, or AVCaptureDeviceDirectionCoordinator is mentioned. Also consult it for requests such as "adapt my app to iPhone Duo", "my layout breaks when folded", "the bars become vertical", or "switch cameras when opening or closing", and for any iOS discussion of multiple displays, folds, or pose changes even when iPhone Duo is not named.

d-date · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add d-date/iphone-duo-skill --skill iphone-duo

技能说明


name: iphone-duo description: Implementation guide for adapting apps to Apple's iPhone Duo, an iPhone with multiple displays and a fold. Covers size class, safe area asymmetry, reserved regions, vertical bars, arrangement, hinge, scene accessories, and dual front cameras. Always use this skill when iPhone Duo, a foldable iPhone, inner/outer displays, vertical toolbars, hinge angle, reserved region, ArrangementView, CameraCaptureAccessory, or AVCaptureDeviceDirectionCoordinator is mentioned. Also consult it for requests such as "adapt my app to iPhone Duo", "my layout breaks when folded", "the bars become vertical", or "switch cameras when opening or closing", and for any iOS discussion of multiple displays, folds, or pose changes even when iPhone Duo is not named.

Adapting apps to iPhone Duo

An implementation guide based on six Apple Tech Talks, the Human Interface Guidelines, Apple Developer Documentation, and two iPhone Duo Group Labs (2026-09-16 and 2026-09-17) as primary sources.

App Store Connect accepts optimized apps starting on 2026-10-05. iPhone Duo screenshots are required for submissions from 2027-04 onward.

Start here

iPhone Duo launches on 2026-10-23 with iOS 27.1. The SDK with iPhone Duo support and Device Hub are included in Xcode 27.1 (beta released on 2026-09-18, Release Candidate on 2026-10-05).

iPhone Duo has two displays, inner and outer, and opens and closes around a central hinge. Your app remains an iPhone app; opening and closing cause a resize. There is no dedicated user interface idiom: it returns phone. The only new aspect is that the inner display has regular size classes on both the horizontal and vertical axes, a first for iPhone.

An app running full screen on the inner display moves to the outer display when the device closes and keeps running. It does not enter the background. Split View is the exception: with two apps side by side, the most recently used app moves to the outer display and the other enters the background. If you reopen immediately, both return; after a delay, the app that was on the outer display fills the inner display.

The foundation is a layout that handles resizing. Existing support for resizing on iPad or through iPhone Mirroring carries over directly.

Behavior by SDK

Build SDKBehavior
Before iOS 27 (Xcode 26)Runs letterboxed. On the outer display, the aspect ratio is close to iPhone mini, with a black strip on the vertical bars side. On the inner display, it is centered at the same aspect ratio and does not respond to pose changes.
iOS 27Resizing support is enabled (no opt-out). Uses almost the entire inner display, but a black strip remains along the side below the status bar.
iOS 27.1Extends to the display edges, with standard bars placed vertically below the status bar.

You do not need to build a tailored experience for every pose from the start. Apple recommends shipping resizing support and following best practices for launch, then improving the experience afterward.

Test with the iPhone Duo simulator in Xcode 27.1's Device Hub. You can change the hinge angle and select closed, open, book, laptop, and tent poses. Check transitions between poses as well as each pose itself. The simulator also returns reserved regions: partially fold it and draw the regions to check custom layouts that avoid the fold or cameras (see "Testing in the simulator" in references/layout.md). The simulator cannot reproduce both the inner and outer displays being on at once, because this requires a camera. The iOS 27.1 simulator can now launch apps that use cameras. It shows no video and reports that no camera is available, but you can check the rest of the UI.

You can also use Device Hub's iOS resizable simulator to check resizing support. Run on iPad and resize the window, or, for iPhone-only apps, use iPhone Mirroring on macOS 27 and resize to extreme sizes in both directions. The iPhone Duo simulator is the best way to test the full native experience. iPhone Mirroring uses an aspect ratio close to the inner display and retains the iPhone interface idiom. It reproduces many issues. Problems caused by safe area and margin asymmetry from vertical bars are harder to find without the iPhone Duo simulator.

Which references to read

Read only the references needed for the task.

ReferenceCoverage
references/layout.mdsize class, safe area asymmetry, display corners, reserved regions, arrangement
references/bars.mdvertical bars, item ordering, axis control, badges, overflow, sheets, disabling vertical bars
references/scenes.mdhinge, multitasking, multiple windows, scene accessories, camera accessories, Core Motion, Web
references/camera.mddual front cameras, camera direction, previews, rotation
references/checklist.mdMigration and validation for existing apps, and an App Store checklist

General principles

These principles apply across all areas. Keep them in mind to make decisions more quickly.

Use size class to make decisions. Do not infer screen size or device capabilities from user interface idiom, or branch layouts on UIDevice.current.orientation, statusBarOrientation, or interfaceOrientation (including windowScene.effectiveGeometry.interfaceOrientation). Compare the width and height of bounds to determine whether the layout is tall or wide, and remove device-size comparisons such as bounds.height == 844. The inner display does not rotate according to the app's declared supported interface orientations; it scales instead. Checking orientation will not produce the intended result. Even portrait-only apps have regular/regular size classes on the inner display. You can read the current orientation from the environment or traits, but base decisions on available width. Moving away from settings that lock orientation or size, such as UIRequiresFullScreen, is recommended.

**Do not rebuild the view hierar

阅读完整来源 ↗