SwiftUI/MacOS: Full Screen Cover / Overlay
Zusammenfassung
Kurz
Der Autor beschreibt einen SwiftUI-Ansatz für ein bildschirmfüllendes macOS-Overlay: Das Fenster wird zunächst einmal geöffnet und geschlossen, dann vor dem späteren Öffnen über `NSApplication.shared.windows` angepasst. Er berichtet über empfindliche Konfigurationszeitpunkte und schlägt einen eigenen Schließweg vor; Fragen zu Vollbild-Apps und mehreren Monitoren bleiben offen.
Mittel
Itsukis Bericht zeigt, wie sich in einer SwiftUI-macOS-App ein bildschirmfüllendes Overlay über eine eigene `Window`-Szene einrichten lässt, ohne `NSWindow` zu unterklassen. Der Autor berichtet von Abstürzen und unwirksamen Fensterbefehlen bei seinem früheren Ansatz und vermutet, dass eine Beta-Version beteiligt gewesen sein könnte; belegt wird das nicht.
Der vorgeschlagene Ablauf öffnet das Fenster beim Erscheinen der Steueransicht einmal und schließt es sofort wieder. Laut Autor muss es so zunächst erzeugt werden, damit es in `NSApplication.shared.windows` auffindbar ist. Beim späteren Öffnen werden vorab Fensterebene, Position, Rahmen, Fensterknöpfe, Verhalten über virtuellen Schreibtischen und Hintergrund konfiguriert. Die Ansicht legt die Größe fest. Der Autor betont, dass manche Eigenschaften am falschen Zeitpunkt nicht wirksam werden oder wiederholte `onAppear`-Aufrufe auslösen können. Weil die üblichen Fensterknöpfe verborgen sind, bietet das Beispiel einen Tipp zum Schließen an. Der Artikel empfiehlt den Ansatz etwa für Bildschirmschoner oder Sichtschutz, behandelt aber offene Leserfragen zu Vollbild-Apps und mehreren Bildschirmen nicht; eine Reaktion meldet ein Mehrbildschirmproblem.
Ausführlich lesen
Der Bericht beschreibt Itsukis Ansatz, in einer SwiftUI-macOS-App ein bildschirmfüllendes Overlay-Fenster zu öffnen, ohne `NSWindow` zu unterklassen. Der Autor berichtet, dass sein vorheriger Versuch mit einer eigenen `NSWindow`-Unterklasse Probleme verursachte: Die App stürzte beim Schließen ab, `setFrameOrigin` verschob das Fenster nicht, `orderOut` blendete es nicht aus, und aktivierte er `canBecomeKey` sowie `canBecomeMain`, kam es nach dem Öffnen zu einem Absturz. Er vermutet als mögliche Ursache auch einen Fehler in einer damaligen Beta-Version; einen Nachweis dafür liefert der Artikel nicht. Zusätzlich berichtet er von Abstürzen seines Computers beim Vorschau-Aufruf in Xcode.
Der vorgeschlagene Aufbau verwendet eine eigene SwiftUI-`Window` mit festgelegter ID. Eine Steueransicht öffnet sie über `openWindow`, während die Overlay-Ansicht sich mit `dismiss` schließen kann. Der Autor erklärt, dass ein Fenster erst in `NSApplication.shared.windows` auftaucht, nachdem es mindestens einmal geöffnet wurde. Deshalb öffnet die Steueransicht das Overlay beim Erscheinen einmal und die Overlay-Ansicht schließt es sofort wieder. So soll die Fensterinstanz für spätere Konfigurationen vorhanden sein.
Beim späteren Öffnen sucht die Schaltfläche das Fenster in der Fensterliste und verändert dessen Eigenschaften vor dem Aufruf von `openWindow`: Sie setzt die Fensterebene auf `.screenSaver` oder alternativ `.popUpMenu`, positioniert das Fenster mit `setFrameOrigin`, entfernt den Titelrahmen, versteckt die Standardfensterknöpfe, aktiviert `canJoinAllSpaces` und setzt die Hintergrundfarbe auf transparent. Die Größe legt der Bericht über den SwiftUI-`frame` der Overlay-Ansicht fest. Der Autor sagt, die erhöhten Ebenen ließen das Fenster über Menüleiste und Dock erscheinen und `canJoinAllSpaces` lasse es beim Wechsel virtueller Schreibtische folgen.
Als wichtige Einschränkung beschreibt der Autor, dass Zeitpunkt und Ort der Konfiguration entscheidend seien: Einstellungen in `onAppear` könnten erneut Aufrufe auslösen; das Setzen von `window.level` direkt nach `openWindow` in der Schaltflächenaktion greife laut ihm nicht, während es in `onAppear` funktioniere. `setFrameOrigin` werde nach seiner Erfahrung in diesen Varianten nicht zuverlässig übernommen. Der veröffentlichte Code konfiguriert das Fenster daher vor dem erneuten Öffnen. Von `UtilityWindow` und `WindowGroup` rät der Autor für dieses Overlay ab, weil deren Voreinstellungen schwer zu ändern seien.
Da Titel und Schaltflächen verborgen sind, braucht das Overlay einen eigenen Schließweg. Im Beispiel schließt ein Tipp auf die Ansicht das Fenster; der Autor nennt eine Tasteneingabe als weitere mögliche Lösung. Der Bericht präsentiert den Code als Lösung für Anwendungsfälle wie Bildschirmschoner oder Sichtschutz. Er belegt jedoch keine allgemeine Zuverlässigkeit und behandelt Fragen aus den Leserreaktionen – etwa Verhalten über anderen Vollbild-Apps oder bei mehreren Bildschirmen – nicht. Eine Reaktion berichtet dort von einer Größen- und Bildschirmabweichung unter Sequoia 15.6.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Im Auftrag wurden keine Fragen angegeben, deshalb gibt es keine Einordnung; Lunas Angaben „(keine)“ sind korrekt. Beide Zusammenfassungen wurden geprüft: Die mittlere ist im Wesentlichen treu, die kurze lässt die Motivation des Autors (Abstürze, Beta-Verdacht) aus und gibt die Empfehlung zu Window-Typen nicht wieder. Die offenen Fragen zu Vollbild-Apps und mehreren Bildschirmen stammen aus Leserkommentaren, nicht vom Autor, und sind im Bericht unbeantwortet.
Im Bericht, aber nicht in der Zusammenfassung
- Der Autor nennt die konkreten Fehler seines früheren Ansatzes (Absturz beim Schließen, wirkungslose setFrameOrigin- und orderOut-Aufrufe) nicht ausdrücklich.
- Der Bericht warnt davor, UtilityWindow oder WindowGroup für das Overlay zu verwenden, weil deren eingebaute Konfigurationen sich schwer entfernen lassen.
- Der Autor beschreibt Abstürze beim Vorschauen in Xcode, bei denen der gesamte Rechner neu startet; das fehlt in beiden Zusammenfassungen.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.