SwiftUI/MacOS: Detect/Listen To Global Key Events Two Ways!
Zusammenfassung
Kurz
Der Artikel stellt `NSEvent`-Monitor und `CGEventTap` als zwei Wege vor, globale Tastaturereignisse in macOS-Apps zu behandeln: Der erste lässt Ereignisse an andere Apps weiterlaufen, der zweite kann sie abfangen. Er beschreibt Beispiele und Berechtigungen, lässt aber ungeklärt, warum das `CGEventTap`-Beispiel zusätzlich Bedienungshilfen-Zugriff prüft, obwohl der Text Input Monitoring als erforderlich nennt.
Mittel
Der vollständige Artikel von Itsuki beschreibt zwei Möglichkeiten, globale Tastaturereignisse in einer macOS-App mit SwiftUI zu erfassen: einen `NSEvent`-Monitor und einen `CGEventTap`. Laut Autor funktionieren beide auch bei inaktiver App. Der `NSEvent`-Monitor erhält Kopien von Ereignissen, die an andere Apps gehen, sodass diese sie weiterhin verarbeiten können. Das Beispiel registriert und entfernt den Monitor passend zum Lebenszyklus einer Ansicht. Für diesen Weg nennt der Artikel Code-Signierung, deaktivierte App-Sandbox und Bedienungshilfen-Zugriff; Berechtigungen lassen sich demnach programmatisch prüfen und anfordern.
Ein `CGEventTap` erlaubt laut Beitrag, Ereignisse weiterzugeben oder durch Rückgabe von `nil` zu unterdrücken. Das Beispiel erkennt Command-S und fängt die Kombination nur bei vollständiger Übereinstimmung ab. Modifier sollen mit `deviceIndependentFlagsMask` gefiltert werden; für reine Modifier-Kombinationen ist auch `flagsChanged` nötig. Als erforderliche Berechtigung nennt der Autor Input Monitoring. Allerdings prüft der gezeigte vollständige Manager zusätzlich die Bedienungshilfen-Berechtigung, ohne diesen Unterschied zu erklären. Für Swift 6 empfiehlt der Artikel `@preconcurrency` beim Import von `ApplicationServices`. Unabhängige Verifikation enthält der Text nicht.
Ausführlich lesen
Der Bericht ist ein vollständiger Technikartikel von Itsuki darüber, wie eine SwiftUI-App für macOS globale Tastaturereignisse ohne zusätzliche Bibliothek erfassen kann. Der Autor stellt zwei Wege vor: `NSEvent.addGlobalMonitorForEvents` und einen niedrigeren `CGEventTap`. Nach seiner Darstellung funktionieren beide auch bei inaktiver App und in Menüleisten-Apps. Der zentrale Unterschied ist, ob die Ereignisse weiterhin an die gerade aktive andere App gelangen oder von der eigenen App abgefangen werden, sowie welche Berechtigungen erforderlich sind.
Beim globalen `NSEvent`-Monitor erhält die App Kopien von Tastaturereignissen, die das System an andere Apps sendet. Das SwiftUI-Beispiel registriert den Monitor beim Erscheinen der Ansicht, behandelt Modifier-, Tastendruck- und Loslassereignisse und entfernt den Monitor beim Verschwinden der Ansicht. Für wiederholte Tastendrücke verweist der Autor auf die Eigenschaft `isARepeat`. Die Ereignisse bleiben dabei auch für die ursprüngliche App verfügbar; als Anwendungsfall nennt der Autor eine App, die auf Kopieren reagiert und dem Nutzer anbietet, den Inhalt in die eigene Anwendung zu übernehmen.
Für diesen Weg nennt der Artikel Code-Signierung, das Deaktivieren der App-Sandbox und die Freigabe unter „Bedienungshilfen“ in den Systemeinstellungen. Die Berechtigung lasse sich mit `AXIsProcessTrustedWithOptions` prüfen und optional anfordern. Änderungen könnten über eine `NSWorkspace`-Benachrichtigung beobachtet werden. Als Swift-6-Besonderheit beschreibt der Autor den Import von `ApplicationServices` mit `@preconcurrency`, um eine Nebenläufigkeitswarnung bei `kAXTrustedCheckOptionPrompt` zu vermeiden; bei Swift 5 sei der explizite Import laut Artikel nicht erforderlich.
Der zweite Ansatz verwendet `CGEventTap`. Dafür beschreibt der Beitrag die Einrichtung eines Event-Taps, einer Run-Loop-Quelle und deren Aktivierung. Ein Callback erhält Zugriff auf den Manager über `userInfo`. Die Ereignisse werden in `NSEvent` umgewandelt und anhand von Typ, Tastencode und Modifiern ausgewertet. Gibt der Callback das Ereignis zurück, kann es zur aktiven App weiterlaufen; `nil` unterdrückt es. Im Beispiel wird Command-S erkannt und nur bei vollständiger Übereinstimmung abgefangen. Der Autor betont, dass Modifier mit `deviceIndependentFlagsMask` gefiltert und Ereignisse nicht vor Erkennung der gesamten Tastenkombination verschluckt werden sollen. Für Kombinationen nur aus Modifiern müsse auch `flagsChanged` überwacht werden.
Als Berechtigung für den Event-Tap nennt der Artikel Input Monitoring und `CGRequestListenEventAccess()`. Zugleich prüft der gezeigte vollständige `HotkeyManager` die Bedienungshilfen-Berechtigung und reagiert auf deren Änderungen. Der Beitrag erklärt diese Abweichung zwischen Berechtigungsbeschreibung und Beispielcode nicht näher. Die Aussagen und Beispiele stammen aus dem Artikel; eine unabhängige Prüfung oder weitere Einschränkungen werden im bereitgestellten Text nicht ausgewiesen.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es waren keine Fragen zur Einordnung angegeben, daher bleibt die Einordnung leer. Bewertet wurde die mittlere Zusammenfassung; die kurze ist ebenfalls treu. Der Satz, der Text enthalte keine unabhängige Verifikation, ist eine Aussage über den Text und kein Befund aus dem Bericht.
Im Bericht, aber nicht in der Zusammenfassung
- Anwendungsbeispiel des NSEvent-Monitors (Chat-App, das Kopieren von Inhalten als Auslöser)
- Hinweis, dass ab Swift 5 ApplicationServices beim Import von Cocoa automatisch mitgeladen wird
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.