SwiftUI/MacOS: Custom Dock Icon PRIMARY Action
Zusammenfassung
Kurz
Der vollständige Bericht schlägt vor, den Dock-Klick über `applicationShouldHandleReopen` im `NSApplicationDelegate` abzufangen und mit `OpenWindowAction` ein bestimmtes SwiftUI-Fenster zu öffnen. Laut Autor verhindern die Rückgabe `false`, `.moveToActiveSpace` und ein einmaliges Öffnen mit anschließendem Schließen, dass das erste Fenster erscheint und das Ziel-Fenster im falschen Arbeitsbereich landet.
Mittel
Der vollständige Bericht erklärt, wie eine SwiftUI-macOS-App beim primären Dock-Klick ein bestimmtes Fenster öffnet, ohne das zuerst definierte Fenster zusätzlich anzuzeigen. Laut Autor öffnet macOS standardmäßig das erste Fenster, wenn keines sichtbar ist. Die vorgeschlagene Lösung verwendet `NSApplicationDelegate` und `applicationShouldHandleReopen`, um über eine gespeicherte `OpenWindowAction` das gewünschte Fenster anzufordern.
Die `OpenWindowAction` wird im Beispiel beim Erscheinen des Menüleisten-Elements übergeben, weil ein Zugriff auf `@Environment(\.openWindow)` im App-Initializer laut Beitrag nicht zuverlässig verfügbar ist. Die Methode gibt `false` zurück, damit nicht auch das erste Fenster geöffnet wird. Für das Ziel-Fenster setzt der Code `.moveToActiveSpace`, damit es im aktiven Arbeitsbereich erscheint. Es wird beim Start einmal geöffnet und gleich wieder geschlossen, damit diese Fenstereigenschaft greift. Der Autor sagt außerdem, ein nie zuvor geöffnetes Fenster sei nicht in `sender.windows` enthalten. Der Beitrag nennt keine Swift- oder macOS-Version; die Hinweise beruhen auf dem vorgestellten Beispiel.
Ausführlich lesen
Der vollständige Bericht von Itsuki beschreibt, wie eine macOS-App mit SwiftUI beim primären Klick auf ihr Dock-Symbol ein bestimmtes Fenster öffnet, ohne zusätzlich das zuerst definierte Fenster anzuzeigen. Als Ausgangspunkt zeigt der Beitrag eine App mit zwei Fenstern und einem Menüleisten-Element. Laut Autor öffnet macOS standardmäßig beim Dock-Klick das zuerst definierte Fenster, wenn gerade keines sichtbar ist. Ist bereits ein Fenster offen, wechselt das System stattdessen zu dessen Arbeitsbereich.
Als Lösung empfiehlt der Autor, einen `NSApplicationDelegate` einzubinden und `applicationShouldHandleReopen` zu implementieren. Dort wird über eine gespeicherte `OpenWindowAction` das Fenster mit der gewünschten ID angefordert. Die Aktion wird laut Beitrag im `onAppear` des Menüleisten-Elements in den App-Delegate übertragen, weil der Zugriff auf `@Environment(\.openWindow)` in `init()` außerhalb einer installierten View nur den Standardwert liefere und sich nicht aktualisiere. Gibt es kein Menüleisten-Element, schlägt der Autor vor, die Einrichtung an ein Fenster zu hängen, das beim App-Start sicher erscheint.
Der Delegate gibt aus `applicationShouldHandleReopen` den Wert `false` zurück. Der Autor erklärt, dass bei `true` neben dem Ziel- auch das zuerst definierte Fenster geöffnet würde. Für das Ziel-Fenster setzt der Beitrag außerdem `.moveToActiveSpace`, damit es im gerade aktiven Arbeitsbereich erscheint und nicht im Arbeitsbereich, in dem die App ursprünglich gestartet wurde.
Damit diese Fenstereigenschaft laut Autor wirksam wird, muss das Ziel-Fenster zunächst mindestens einmal geöffnet werden. Der Beispielcode öffnet und schließt es deshalb beim Erscheinen des Menüleisten-Elements direkt wieder. Der Beitrag begründet auch, warum ein direkter Zugriff auf `sender.windows` nicht genügt: Ein Fenster, das noch nie geöffnet wurde, sei dort nicht enthalten, sodass `makeKeyAndOrderFront` es nicht hervorholen könne.
Die Aussagen und der Lösungsvorschlag beziehen sich auf das gezeigte SwiftUI-/macOS-Beispiel. Der Bericht nennt keine macOS- oder Swift-Version und enthält keinen unabhängigen Vergleich oder systematischen Test; seine Empfehlungen werden anhand des Beispielcodes und der beschriebenen Beobachtungen erläutert.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es wurden keine Fragen angegeben, daher ist die Einordnung leer. Die Prüfung gilt für beide von Luna gelieferten Zusammenfassungen (kurz und mittel), da das Schema nur ein Urteil vorsieht. Beide geben den Bericht sachlich korrekt wieder, es wurden keine Angaben erfunden. Die fehlenden Punkte betreffen vor allem die Einbindung ohne Menüleisten-Element und die Begründung der Rückgabe false.
Im Bericht, aber nicht in der Zusammenfassung
- Ohne Menüleisten-Element müssen openWindow und dismissWindow am ersten Fenster angebracht werden, sonst wird der Code nicht ausgeführt
- Die Ausgabe von true würde auch das erste Fenster öffnen, was der Grund für die Rückgabe false ist
- Die Lösung ist nur eine Antwort auf den primären Klick, ein sekundäres Menü ist davon nicht betroffen
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.