Little SwiftUI Tip: Get & Set & Watch Interface Orientation & Orientation Lock
Zusammenfassung
Kurz
Der Beitrag beschreibt das Auslesen und Beobachten der UI-Ausrichtung über `UIWindowScene.effectiveGeometry` sowie das Anfordern einer Ausrichtung mit `requestGeometryUpdate`. Laut Autor kann die gewünschte Orientierung abgelehnt werden; eine Orientierungssperre ließ sich in seinen Versuchen nicht zuverlässig allein mit SwiftUI setzen, und die Laufzeitaussagen beruhen auf eigenen Tests.
Mittel
Der Beitrag zeigt, wie SwiftUI die Orientierung der App-Oberfläche auslesen, Änderungen beobachten und eine neue Orientierung anfordern kann. Der Autor grenzt `UIInterfaceOrientation` von der physischen Geräteausrichtung `UIDeviceOrientation` ab und empfiehlt für die erlaubten Ausrichtungen zunächst `UISupportedInterfaceOrientations` in der `Info.plist`.
Zum Auslesen dient `UIWindowScene.effectiveGeometry`; sie liefert unter anderem aktuelle Orientierung und Sperrstatus. Weil diese Werte beim bloßen Zugriff nicht laufend aktualisiert werden, verwendet das Codebeispiel Combine-KVO, um Änderungen an `effectiveGeometry` in einer Observable-Manager-Klasse zu verfolgen. Zum Ändern der Orientierung wird `requestGeometryUpdate` mit einer passenden Orientierungsmaskierung aufgerufen. Der Autor weist darauf hin, dass eine angeforderte Ausrichtung wie `portraitUpsideDown` trotz allgemeiner Unterstützung abgelehnt werden kann. Seinen Tests zufolge bleibt das normale Folgen der Geräteausrichtung bei aufgehobener Sperre bestehen.
Eine Orientierungssperre lasse sich nach seinen Erfahrungen nicht sinnvoll allein mit SwiftUI setzen. KVC-Versuche hätten Abstürze verursacht. Bei direktem View-Controller-Zugriff nennt er überschreibbare Sperreigenschaften und eine anschließende Aktualisierungsanforderung. Die Laufzeitaussagen beruhen auf den eigenen Tests des Autors.
Ausführlich lesen
Der Beitrag erklärt, wie eine SwiftUI-App die Ausrichtung ihrer Benutzeroberfläche ausliest, Änderungen daran beobachtet und eine gewünschte Ausrichtung anfordert. Dabei unterscheidet der Autor ausdrücklich zwischen `UIInterfaceOrientation` – der Orientierung der App-Oberfläche – und `UIDeviceOrientation`, der physischen Geräteausrichtung. Für eine feste Auswahl unterstützter Oberflächenorientierungen empfiehlt er zunächst den Eintrag `UISupportedInterfaceOrientations` in der `Info.plist`. Das Setzen der Geräteausrichtung über `UIDevice.setValue` beschreibt er als wenig zuverlässig.
Zum Auslesen nutzt der vorgestellte Ansatz `UIWindowScene.effectiveGeometry`. Deren Eigenschaften `interfaceOrientation` und `isInterfaceOrientationLocked` liefern laut Beitrag die aktuelle Oberflächenorientierung und den Sperrstatus. Weitere Geometrieangaben wie Rahmen, Koordinatenraum und Größenbeschränkungen seien ebenfalls lesbar. Ein bloßes Auslesen aktualisiere sich jedoch nicht von selbst, wenn sich die Oberfläche dreht.
Für laufende Änderungen schlägt der Autor eine Observable-Manager-Klasse vor, die über Combine und Key-Value-Observing den Änderungen an `effectiveGeometry` folgt und Orientierung sowie Sperrstatus in SwiftUI bereitstellt. Er bezeichnet diese Beobachtung als den empfohlenen Weg, Änderungen an der Fenstergeometrie zu erhalten.
Eine gewünschte Orientierung soll nicht durch erzwungenes Drehen des Geräts gesetzt werden. Stattdessen ruft die Manager-Klasse `requestGeometryUpdate` mit einer `GeometryPreferences`-Vorgabe auf. Da diese Vorgabe eine `UIInterfaceOrientationMask` erwartet, zeigt der Beitrag Zuordnungen zwischen einzelnen Orientierungen und Masken sowie eine Liste der laut View Controller unterstützten Orientierungen. Bei Fehlern wird der Fehlerzustand gespeichert. Der Autor warnt, dass `portraitUpsideDown` trotz einer auf `.all` gesetzten Unterstützung abgelehnt werden könne: In seinem angeführten Fehler werden nur Hochformat und die beiden Querformate als unterstützt genannt. Die Oberfläche kann laut seinen eigenen Tests weiterhin der tatsächlichen Geräteausrichtung folgen, wenn die Orientierungssperre aus ist – selbst nachdem eine einzelne Maskenorientierung angefordert wurde.
Das Setzen der Orientierungssperre behandelt der Beitrag als Einschränkung: Einen guten Weg allein mit SwiftUI habe der Autor nicht gefunden. Versuche, Sperreigenschaften per KVC über `setValue` zu setzen, hätten die App mit einem Fehler zur fehlenden Key-Value-Coding-Konformität abstürzen lassen. Wenn direkter Zugriff auf View Controller besteht, beschreibt er als allgemeinen Ansatz, `prefersInterfaceOrientationLocked` oder `childForInterfaceOrientationLock` zu überschreiben und anschließend `setNeedsUpdateOfPrefersInterfaceOrientationLocked()` aufzurufen.
Die Darstellung besteht aus einer technischen Anleitung und vollständigen Swift-Codebeispielen. Die Aussagen zur Laufzeit – insbesondere zum Verhalten bei Drehung und zu nicht unterstützten Orientierungen – beruhen laut Autor auf seinen Tests; der Beitrag nennt keine breitere Testbasis oder weitere Plattformbedingungen.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Zusammenfassung-Felder beziehen sich auf die kurze Fassung von Luna. Sie ist sachlich korrekt und enthält nichts Erfundenes, lässt aber mehrere Kernpunkte aus. Die mittlere Fassung ist treu und ohne erfundene Angaben, nennt aber die Empfehlung gegen direkte Bindung des Pickers an interfaceOrientation nicht. Einordnung bleibt leer, weil im Auftrag keine Sammel- oder Teilfragen angegeben wurden.
Im Bericht, aber nicht in der Zusammenfassung
- Unterscheidung zwischen UIInterfaceOrientation und UIDeviceOrientation
- Beobachtung von effectiveGeometry per KVO/Combine
- Empfehlung, erlaubte Ausrichtungen zunächst über UISupportedInterfaceOrientations in der Info.plist festzulegen
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.