App für das iPhone Duo anpassen: eine priorisierte Checkliste

Das iPhone Duo ist am 23. Oktober 2026 mit iOS 27.1 in den Verkauf gegangen. Wenn Sie Ihre App für das iPhone Duo vorbereiten müssen, passen Sie sie an zwei Displays, ein Scharnier, eine Kamera an der Seite und Bars an, die an den Rand wandern. Das ist eine Menge Angriffsfläche, daher bringt diese Checkliste die Arbeit in eine Reihenfolge: zuerst die Korrekturen, die jeder App helfen, dann der gerätespezifische Feinschliff.

Dieser Beitrag ist der Ausgangspunkt unserer Entwicklerserie zum iPhone Duo. Jeder Schritt verweist auf einen ausführlicheren Leitfaden. Er basiert auf Apples Tech Talks, Apples iPhone Duo Seiten, den Apple Developer Forums und Berichten von Entwicklern. Das AppleDuo-Team hat diese APIs nicht auf echter Hardware getestet, und die meisten sind neu in iOS 27 oder iOS 27.1, daher können sich Details zwischen Releases ändern.

Was passiert auf dem iPhone Duo mit Apps, die mit älteren SDKs gebaut wurden?

Ihre App läuft bereits auf dem iPhone Duo. Wie sie aussieht, hängt vom SDK ab, mit dem Sie sie gebaut haben. Apples Seite zur iPhone Duo Vorbereitung beschreibt drei Stufen:

Apples Empfehlung lautet, sicherzustellen, dass sich Ihr Inhalt an vertikale Bars anpasst, bevor Sie mit dem 27.1 SDK ausliefern. Abwarten ist aber auch keine Dauerlösung: Laut Apple müssen App-Store-Uploads ab April 2027 das iOS 27 SDK oder neuer verwenden.

Wie sieht die Checkliste aus, um eine App an das iPhone Duo anzupassen?

Hier ist die Reihenfolge, die wir empfehlen, basierend darauf, wie viel jeder Schritt im Verhältnis zum Aufwand behebt. Die ersten drei sind das, was Sarun Wongpatcharapakorn vorschlägt, wenn Sie wenig Zeit haben, Ihre App anzupassen.

Wie behebe ich zuerst Size Classes, Layout Margins und Safe Areas?

Size Classes bestimmen den Großteil des Layouts auf dem iPhone Duo. Apples Tech Talk Prepare your app for iPhone Duo listet sie auf: Das äußere Display hat im Hochformat kompakte Breite und reguläre Höhe und ist im Querformat in beide Richtungen kompakt. Das innere Display ist in beide Richtungen regular. Sarun bringt es auf den Punkt: Gefaltet ist es ein iPhone, aufgeklappt ein iPad.

Der Haken: Viele Apps interpretieren eine Breite von regular als „das ist ein iPad“. Apples Vorbereitungsseite rät davon ab: iPhone-Apps können jetzt jede Kombination von Size Classes haben, verzweigen Sie also nach der Size Class selbst, nicht nach Geräte-Idiom, Ausrichtung oder einer fest codierten Höhe. Diese SwiftUI-View liest das Environment aus und wählt ein Layout:

struct LibraryView: View {
    @Environment(\.horizontalSizeClass) private var horizontalSizeClass

    var body: some View {
        if horizontalSizeClass == .regular {
            TwoColumnLibrary()
        } else {
            SingleColumnLibrary()
        }
    }
}

Safe Areas sind die zweite Korrektur. Auf dem iPhone Duo fügen vertikale Bars führende und nachfolgende Insets hinzu, und Apple warnt, dass gegenüberliegende Insets nicht gleich sind. Auch Layout Margins sind asymmetrisch. Sarun merkt an, dass die Margins auf einer Seite 20 Punkte und neben der Bar 0 betragen können. Dieses UIKit-Muster aus dem Tech Talk behandelt jede Seite für sich:

// Vermeiden: setzt voraus, dass führende und nachfolgende Insets gleich sind
let width = view.bounds.width - view.safeAreaInsets.left * 2

// Bevorzugt: rückt jede Kante um ihren eigenen Wert ein
let width = view.bounds.inset(by: view.safeAreaInsets).width

Halten Sie interaktive Inhalte innerhalb der Safe Area und lassen Sie Hintergründe darüber hinausreichen. Unser Leitfaden zu Size Classes auf dem iPhone Duo enthält die vollständige Tabelle der Haltungen, und Safe Areas und Content Margins auf dem iPhone Duo behandelt die neuen Margin-APIs.

Wie bekomme ich das Vollbilderlebnis auf dem iPhone Duo?

Kompilieren Sie mit Xcode 27.1 neu, das Entwicklungsunterstützung für das iPhone Duo und das iOS 27.1 SDK mitbringt. Apples Tech Talk sagt, dass Xcode 27.1 für das Vollbilderlebnis erforderlich ist. Räumen Sie vorher die Muster auf, die Apples Vorbereitungsseite auflistet:

• Ersetzen Sie UIScreen.main.bounds durch view.bounds oder window.bounds. Apple bezeichnet UIScreen.main auf einem Gerät mit zwei Displays als mehrdeutig und sagt, dass es als veraltet markiert wird. Lesen Sie die Skalierung aus traitCollection.displayScale aus.
• Ersetzen Sie UIWindow(frame: UIScreen.main.bounds) durch UIWindow(windowScene:). Blake Crosley und Adapty berichten beide, dass Apps, die mit dem neuesten SDK gebaut werden, den Scene-basierten Lebenszyklus brauchen.
• Entfernen Sie Layout-Logik, die auf UIDevice.current.orientation oder interfaceOrientation basiert. Vergleichen Sie stattdessen Breite und Höhe des verfügbaren Platzes.
• Prüfen Sie randlose Bilder und Videos mit Aspect Fill. Die Form des inneren Displays kann mehr abschneiden, als Sie erwarten.

Und UIRequiresFullScreen? Laut Apple berücksichtigt das iPhone Duo es weiterhin, aber Ihre App ändert trotzdem ihre Größe, wenn das Gerät geöffnet oder geschlossen wird. Es ist kein Notausgang. Auf dem inneren Display ignoriert das System außerdem Ihre unterstützten Interface-Ausrichtungen und skaliert die App.

In den Apple Developer Forums gab ein Apple Evangelist in Thread 848047 denselben Rat: Size Classes statt Geräteprüfungen verwenden und alle Ausrichtungen unterstützen, da iPhone-Apps ihre Größe jetzt auf dem iPad und auf dem Mac über iPhone Mirroring ändern können.

Wie verändern sich Toolbars, die vertikale Bar und Sheets?

Mit dem iOS 27.1 SDK wandern Navigationsleisten, Toolbars und Tab Bars auf dem äußeren Display und auf dem inneren Display im Querformat in eine vertikale Bar entlang einer Kante. Apples Tech Talk Raise the bar with iPhone Duo erklärt die Regeln. Nur Bars, die zu Navigations-Containern gehören, wandern mit; eigene UIToolbar-, UINavigationBar- oder UITabBar-Instanzen bleiben, wo sie sind.

Die vertikale Bar hat eine feste Breite und bevorzugt daher Symbole. Elemente mit Icon wandern auf die vertikale Achse, reine Text-Elemente bleiben horizontal. Saruns Zusammenfassung ist einfach: Geben Sie Toolbar-Elementen sowohl ein Icon als auch einen Titel, dann sind Sie wahrscheinlich bereit. Der Titel wird weiterhin in Überlaufmenüs verwendet. Die Platzierungen und der Modifier unten sind so geschrieben, wie Apples Tech Talk sie zeigt. .topBarPinnedTrailing ist neu in iOS 27:

.toolbar {
    ToolbarItem(placement: .cancellationAction) {
        Button("Close", systemImage: "xmark") { dismiss() }
    }
    ToolbarItem(placement: .topBarPinnedTrailing) {
        Button("Done", systemImage: "checkmark") { save() }
    }
    ToolbarItem {
        Button("Share", systemImage: "square.and.arrow.up") { share() }
    }
    .visibilityPriority(.high)
}

Zurück oder Schließen kommt nach oben, dann die prominente Aktion, dann der Rest. Wenn der Platz ausgeht, laufen Elemente von unten nach oben über, und .visibilityPriority entscheidet, welche bleiben. Ein einseitiges, nach unten gewichtetes Layout wie der Taschenrechner kann sich mit .toolbarVerticalBehavior(.disabled) abmelden. Unser Leitfaden zur vertikalen Toolbar auf dem iPhone Duo behandelt Überlauf, eigene Views und die UIKit-Entsprechungen.

Auch Sheets ändern sich. Auf dem äußeren Display ist die Toolbar eines Sheets vertikal. Auf dem inneren Display sind Sheets standardmäßig zentriert und können auf der führenden oder nachfolgenden Seite sitzen. Lesen Sie Sheets und presentationPlacement auf dem iPhone Duo für die Details.

Welche Container und APIs kümmern sich für mich um den Falz?

Beginnen Sie mit System-Containern. NavigationSplitView und UISplitViewController fallen im geschlossenen Zustand zu einem einzelnen Stack zusammen und zeigen im aufgeklappten Zustand Spalten. TabView passt sich an jede Haltung an, und auf dem inneren Display können Sie mit .defaultTabBarPlacement(.sidebar) eine Seitenleiste aktivieren. List und ScrollView passen sich automatisch an den Falz an.

Für eigene Layouts mit zwei Views führt iOS 27.1 ArrangementView in SwiftUI und UIArrangementViewController in UIKit ein, vorgestellt in Strike a pose with adaptive layouts on iPhone Duo. Der Stil .split teilt den Platz zwischen zwei Views auf, und .overlay stapelt sie, bis das Gerät gefaltet wird. Setzen Sie keine ArrangementView in eine List, eine ScrollView oder einen anderen Navigations-Container. Siehe unseren Leitfaden zu ArrangementView.

Für Steuerelemente, die Sie manuell platzieren, fragen Sie die Reserved Regions ab, ebenfalls neu in iOS 27.1. Eine Division-Region markiert den Falz, und eine Occlusion-Region markiert die innere FaceTime-Kamera, solange sie aktiv ist. Apple zeigt den SwiftUI-Aufruf als proxy.reservedRegions(kind: .division) innerhalb eines GeometryReader. Unser Beitrag zu Reserved Regions und dem Falz erklärt aktive und inaktive Regionen.

Das Scharnier selbst ist für Effekte da, nicht für das Layout. onHingeChange in SwiftUI und UIHingeInteraction in UIKit, beide in Apples Dokumentation als iOS 27.1 geführt, melden die Zustände geschlossen, teilweise geöffnet und vollständig geöffnet sowie einen kontinuierlichen Winkel. Auf Geräten ohne Scharnier ist der Hinge-Wert nil, prüfen Sie ihn also immer. Als Inspiration sehen Sie sich an, wie Marbles Unhinged den Falz in eine Rampe verwandelt, und lesen Sie dann Hinge-Zustände und onHingeChange.

Wie teste ich iPhone Duo Haltungen und nutze die Agent Skills von Xcode?

Wählen Sie in Xcode 27.1 den iPhone Duo Simulator und führen Sie Ihre App in Device Hub aus. Nutzen Sie die Steuerelemente auf dem Bildschirm, um das Gerät zu öffnen, zu schließen, zu drehen und zu falten, und prüfen Sie jede Haltung: geschlossen im Hochformat, geschlossen im Querformat, aufgeklappt im Hochformat und aufgeklappt im Querformat. Apple schlägt außerdem vor, die App auf einer Seite in Split View zu ziehen und dann auf der anderen, um zu bestätigen, dass vertikale Inhalte auf beiden funktionieren. Prüfen Sie auch Rechts-nach-links-Sprachen, da die vertikale Bar auf derselben Hardware-Seite bleibt.

Sarun berichtet, dass Device Hub in Xcode 27.2 zusätzlich Speicherdruck, Zeitlupen-Animationen, ein Schütteln und einen Sturz simulieren kann. Das ist nützlich, um zu prüfen, ob der Zustand ein Falten unter Last übersteht.

Xcode 27 enthält außerdem Agent Skills für moderne Best Practices und neue APIs. Laut Apples Vorbereitungsseite können Sie den Coding-Assistenten von Xcode bitten: „get my app ready for iPhone Duo“. Um die Skills mit einem anderen Coding Agent zu nutzen, exportieren Sie sie mit dem Befehl, den Sarun geteilt hat:

xcrun agent skills export --output-dir ~/Downloads/xcode-skills

Wenn Sie die Skills vor Xcode 27.1 exportiert haben, exportieren Sie sie erneut. Der Skill uikit-app-modernization heißt jetzt app-resizability und bringt Unterstützung für SwiftUI und das iPhone Duo mit. Apple weist darauf hin, dass der Skill nicht alles erkennt, prüfen Sie die obigen Muster also auch von Hand.

Welche App-Store-Assets brauche ich für das iPhone Duo?

App Store Connect hat einen Screenshot-Platz für das iPhone Duo mit separaten Größen für das äußere und das innere Display. Wenn Sie iPhone Duo Screenshots einreichen, zeigt Ihre Produktseite ein Badge, das die App als für das iPhone Duo optimiert kennzeichnet. Laut Apple werden die Screenshots ab April 2027 verpflichtend. Unser Leitfaden zu App Store Screenshot-Größen für das iPhone Duo enthält jede Slot-Größe und was Sie in den ersten drei Bildern zeigen sollten.

Zwei weitere Punkte runden einen Launch ab. Apple schlägt vor, in App Store Connect eine Featuring-Nominierung einzureichen und die Unterstützung für das iPhone Duo einschließlich aller Gerätehaltungen zu vermerken. Apadmi empfiehlt außerdem, die Abdeckung Ihrer App Intents zu überprüfen. Angesichts der neuen Fähigkeiten von Siri in iOS 27 ist unser Leitfaden zu App Intents und dem semantischen Index in iOS 27 ein gutes nächstes Projekt. Zur Inspiration stöbern Sie in den Spielen unter Built for the fold, die das Scharnier als Teil des Spiels nutzen.

Die wichtigsten Punkte

• Apps, die mit dem iOS 26 SDK oder früher gebaut wurden, laufen, wirken aufgeklappt aber wie mit Rand versehen. Nur das iOS 27.1 SDK in Xcode 27.1 füllt das Display.
• Beheben Sie zuerst Size Classes, Layout Margins und Safe Area Insets. Gehen Sie nie davon aus, dass reguläre Breite iPad bedeutet oder dass gegenüberliegende Insets gleich sind.
• Geben Sie jedem Toolbar-Element ein Icon und einen Titel und verwenden Sie System-Bars, damit sie in die vertikale Bar wandern können.
• Verwenden Sie NavigationSplitView, TabView und ArrangementView für das Layout, Reserved Regions für manuell platzierte Steuerelemente und das Scharnier nur für Effekte.
• Testen Sie jede Haltung in Device Hub, exportieren Sie die Agent Skills von Xcode nach 27.1 erneut und fügen Sie vor April 2027 iPhone Duo Screenshots hinzu.

Beginnen Sie mit Size Classes auf dem iPhone Duo und machen Sie dann mit der vertikalen Toolbar weiter. Wenn Ihre App bereit ist, erklärt die About-Seite, wie Ihr iPhone Duo Spiel vorgestellt werden kann.