SwiftUI: Screenshot Programmatically on MacOS
Zusammenfassung
Kurz
Der vollständige Bericht erklärt anhand von Swift-Beispielen, wie ScreenCaptureKit Screenshots von Bereichen, Displays, Apps oder Fenstern erstellt und wie Ausgabe, Picker und Swift-6-Isolation konfiguriert werden. Der Autor berichtet, dass HDR-Aufnahmen in seinen Versuchen nicht funktionierten, und weist auf Berechtigungs- sowie Absturzrisiken beim Speichern hin.
Mittel
Itsuki zeigt, wie sich mit ScreenCaptureKit unter macOS Screenshots aus SwiftUI erstellen lassen: von rechteckigen Bereichen bis zu Displays, Apps und Fenstern. Der Bericht vergleicht die ältere Methode `captureImage` mit neuen APIs ab Beta 26, die unter anderem eine Konfiguration und das direkte Speichern in eine Datei ermöglichen. Zu den Einstellungen zählen Cursor ausblenden, Ausgabegröße und Umgang mit Fensterteilen. Für bestimmte Inhalte können Entwickler Filter programmatisch erstellen oder Nutzer mit dem Content-Sharing-Picker auswählen lassen.
Der Autor empfiehlt für den Picker, ihn nach Auswahl oder Abbruch samt Observer aufzuräumen. Als Swift-6-Hinweise nennt er `@preconcurrency` für den ScreenCaptureKit-Import und `nonisolated` für Observer-Methoden. Bei Sandbox-Apps seien passende Ordnerrechte nötig; außerdem warnt der Beitrag vor einem Zugriff auf die unsichere `fileURL`-Eigenschaft der Ausgabe, wenn ein Speicherziel gesetzt ist. Eine weitere Einschränkung: In den eigenen Tests des Autors blieb `hdrImage` trotz HDR-Konfiguration leer, während ein SDR-Bild verfügbar war. Er vermutet einen Beta-Fehler, bestätigt dessen Ursache aber nicht.
Ausführlich lesen
Der vollständige Bericht von Itsuki beschreibt, wie sich unter macOS mit Apples ScreenCaptureKit Bildschirmfotos aus SwiftUI heraus erstellen lassen. Er behandelt rechteckige Bereiche, Displays, Apps und Fenster sowie fest programmierte oder vom Nutzer ausgewählte Inhalte. Der Artikel stellt ältere APIs den ab Beta 26 verfügbaren neuen Screenshot-APIs gegenüber und zeigt Konfigurationsmöglichkeiten anhand von Swift-Beispielen.
Für einen rechteckigen Ausschnitt nennt der Bericht die ältere Methode `captureImage(in:)`, deren Rechteck in Punkten des Bildschirmkoordinatensystems angegeben wird. Ab Beta 26 komme `captureScreenshot(rect:configuration:)` hinzu. Dessen Konfiguration ermögliche unter anderem die direkte Ausgabe in eine Datei: Dazu werde ein unterstütztes Bildformat wie PNG, HEIC oder JPEG festgelegt und eine Zielordner-URL angegeben. Bei aktivierter App-Sandbox müsse der App für diesen Ordner Lese- und Schreibzugriff gewährt werden. Der Autor warnt ausdrücklich davor, bei gesetzter `fileURL` auf die `unowned(unsafe) fileURL`-Eigenschaft der Ausgabe zuzugreifen, da die App dadurch abstürzen könne.
Zu weiteren Einstellungen zählen das Ausblenden des Mauszeigers, Optionen zum Umgang mit Fensterzuschnitt und Schatten, das Einbeziehen untergeordneter Fenster sowie Ausgabegröße, Quell- und Zielrechteck und Darstellungsart. Der Bericht weist darauf hin, dass `SCScreenshotConfiguration` nicht `Observable` sei und sich daher nicht wie eine beobachtbare Zustandsvariable für automatische SwiftUI-Aktualisierungen eigne.
Für Screenshots bestimmter Inhalte wird ein `SCContentFilter` verwendet. Der Autor erläutert, dass sich dafür über `SCShareableContent` verfügbare Displays, Fenster und Apps abfragen und programmatisch filtern lassen. Beispiele zeigen die Aufnahme des Bildschirminhalts, das Ausschließen der eigenen App und die Auswahl von Xcode anhand des App-Namens. Alternativ könne der Nutzer mit `SCContentSharingPicker` Display, Fenster oder Anwendung auswählen. Dafür werde ein Observer registriert, der Picker aktiviert und präsentiert. Nach Auswahl oder Abbruch empfiehlt der Beispielablauf, den Picker zu deaktivieren und den Observer zu entfernen; laut Autor verhindert das, dass das Aufnahme- beziehungsweise Freigabesymbol in der Menüleiste sichtbar bleibt.
Als Swift-6-Hinweise nennt der Beitrag `@preconcurrency` beim Import von ScreenCaptureKit, damit ein `SCContentFilter` in eine `Task`-Closure übergeben werden kann, und `nonisolated` für Observer-Methoden, da die App sonst laut Autor abstürzen könne. Vor dem Entwickeln empfiehlt er außerdem, ein Team auszuwählen und das Zertifikat auf „Development“ zu setzen. Bei lokaler Signierung könne die Berechtigungsabfrage wiederholt erscheinen; selbst eine bereits erteilte Systemeinstellung könne dann nicht zur aktuell ausgeführten App-Version passen.
Die wesentliche technische Einschränkung des Berichts betrifft HDR: Der Autor berichtet aus eigenen Versuchen, dass `hdrImage` bei ihm stets `nil` blieb, auch wenn HDR angefordert wurde, während `sdrImage` weiterhin ein Bild lieferte. Er vermutet einen Beta-Fehler, kann das aber nicht bestätigen. Der Beitrag liefert Beispiele und verweist für den vollständigen Democode auf GitHub; er behauptet nicht, die beschriebenen Beta-APIs oder das HDR-Verhalten unabhängig oder umfassend geprüft zu haben.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Es wurden keine Fragen zur Einordnung angegeben (Abschnitte 'Sammelfrage' und 'Teilfrage' sind leer), daher bleibt die Einordnung leer. Die Zusammenfassung wurde gegen den Bericht geprüft; der kurze Text ist knapp und formuliert das Speicher-Risiko ungenau, weil der Bericht vor dem Zugriff auf die fileURL warnt und nicht vor dem Speichern selbst.
Im Bericht, aber nicht in der Zusammenfassung
- Die Empfehlung, ein Development-Team mit Signing-Zertifikat "Development" zu wählen, damit die Berechtigungsabfrage nicht ständig erscheint (nur im mittleren Text nicht erwähnt, im kurzen fehlend)
- Im kurzen Text fehlen Content-Sharing-Picker, Konfigurationsoptionen wie Cursor-Ausblendung und das Aufräumen des Pickers
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.