SwiftUI + QuickLook: Preview & Edit Files In App! Generate Thumbnails For Files! On the fly!
Zusammenfassung
Kurz
Der Bericht zeigt, wie Quick Look in SwiftUI einzelne oder mehrere Dateien vorschaut und Thumbnails erzeugt. Für eigene Dateiformate beschreibt er die Registrierung eines UTI sowie Preview- und Thumbnail-Erweiterungen, weist aber darauf hin, dass Aussagen zu Caching und einigen Implementierungsdetails auf persönlichen Beobachtungen beruhen.
Mittel
Der Bericht erklärt, wie SwiftUI und Quick Look Vorschauen und Miniaturbilder für Dateien bereitstellen. Für eine Datei wird `quickLookPreview(_:)` mit einer gebundenen URL verwendet; für eine Sammlung dient `quickLookPreview(_:in:)`, sodass Nutzer zwischen Dateien wechseln können. Der Autor nennt gängige unterstützte Formate wie Bilder, Dokumente, Text, PDFs sowie Audio und Video. `QLThumbnailGenerator` kann bestmögliche oder schrittweise verbesserte Thumbnails erzeugen oder sie auf Disk speichern; gespeicherte Dateien müssen später entfernt werden.
Eigene Dateiformate werden zunächst als exportierte UTI in der Haupt-App registriert. Für einen bereits vorschaufähigen UTI kann Quick Look laut Bericht automatisch funktionieren. Andernfalls beschreibt der Autor eine Preview-Erweiterung, deren `QLSupportedContentTypes` den exakten UTI enthalten muss. Im Beispiel wird der Inhalt eines eigenen Textformats in eine temporäre `.txt`-Datei geschrieben und über `QLPreviewReply` angezeigt. HTML-Anhänge können über `cid:` eingebunden werden. Eine Thumbnail-Erweiterung zeichnet eigene Vorschaubilder und kann eine Mindestgröße festlegen.
Der Autor vermutet automatisches Thumbnail-Caching, hat dazu aber keine Dokumentation gefunden. Auch seine Empfehlung zur Datei-URL-Antwort und seine Beobachtung, dass Änderungen an Thumbnails teils erst nach Zurücksetzen der App sichtbar werden, sind Erfahrungsberichte, keine systematischen Tests.
Ausführlich lesen
Der Bericht ist eine Anleitung dazu, Quick Look in SwiftUI für Dateivorschauen und Miniaturbilder zu verwenden und eigene Dateiformate dafür zu unterstützen. Der Autor zeigt Beispiele für einzelne und mehrere Dateien sowie für selbst programmierte Vorschau- und Thumbnail-Erweiterungen.
Für gängige Dateiformate lässt sich eine einzelne Datei laut Anleitung mit `quickLookPreview(_:)` anzeigen, dem eine an eine URL gebundene Zustandsvariable übergeben wird. Quick Look bietet dabei eine systemeigene Vorschau mit einfachen Funktionen wie Teilen und Umbenennen; auf iOS sind laut Bericht auch einfache Bearbeitungen wie Markierungen auf Bildern möglich. Die Vorschau wird durch Setzen der URL auf `nil` geschlossen oder der Wert wird beim Schließen durch den Nutzer automatisch zurückgesetzt. Für eine Dateiauswahl dient `quickLookPreview(_:in:)`: Die Bindung bezeichnet die aktuell angezeigte Datei, die übergebene Sammlung ermöglicht das Wechseln zwischen den Dateien, ohne die Vorschau zu schließen. Als unterstützte Formate nennt der Bericht unter anderem iWork- und Office-Dokumente, Bilder, Live Photos, Text, PDFs, Audio und Video sowie USDZ-Objekte auf iOS und iPadOS.
Miniaturbilder erzeugt `QLThumbnailGenerator`. Der Autor unterscheidet zwischen einer bestmöglichen Darstellung, einer Folge von zunächst schnell verfügbaren und später höher aufgelösten Darstellungen sowie einer Variante, die ein Bild in einer Datei speichert. Bei letzterer müsse die gespeicherte Datei später entfernt werden. Der Autor vermutet, dass Quick Look Thumbnails automatisch zwischenspeichert; er kennzeichnet das als eigene Beobachtung, da er dafür keine Dokumentation gefunden habe.
Für ein eigenes Format beschreibt der Bericht zunächst die Registrierung des Dateityps als exportierten Uniform Type Identifier (UTI) in der Haupt-App. Wenn der UTI einem bereits vorschaufähigen Typ wie einfachem UTF-8-Text entspricht, könne Quick Look den Inhalt laut Autor ohne eigene Vorschauerweiterung darstellen. Für einen allgemeinen Datentyp wie `public.data` richtet man dagegen eine Quick-Look-Preview-Erweiterung ein. Deren `Info.plist` muss als datenbasierte Vorschau konfiguriert werden und den exakten UTI in `QLSupportedContentTypes` aufführen; ein übergeordneter UTI reiche laut Anleitung nicht aus.
Die Erweiterung implementiert `providePreview(for:)` und liefert eine `QLPreviewReply`. Im Textbeispiel liest sie die Datei, schreibt deren Inhalt in eine temporäre Datei mit der Endung `.txt` und lässt Quick Look diese anzeigen. Der Autor berichtet aus eigener Erfahrung, dass die Antwort mit einer Datei-URL bei ihm am besten funktioniert habe; andere Varianten hätten bei ihm gehangen. Für HTML-Vorschauen lassen sich zusätzliche Inhalte wie Bilder als Anhänge bereitstellen und über `cid:` referenzieren.
Für eigene Miniaturbilder wird analog eine Thumbnail-Erweiterung mit dem exakten UTI eingerichtet. Optional legt `QLThumbnailMinimumDimension` fest, unter welcher Größe Quick Look die Erweiterung nicht aufrufen soll. `provideThumbnail` kann etwa Bild, Dateinamen und weitere grafische Elemente in den Thumbnail-Kontext zeichnen. Als Hinweis auf Caching nennt der Autor, dass Änderungen an dieser Methode bei ihm erst nach dem Löschen der App-Daten oder einer Neuinstallation sichtbar wurden. Die Darstellung ist ein Tutorial mit Codebeispielen und persönlichen Beobachtungen; sie liefert keine systematische Prüfung der Versions-, Plattform- oder Fehlergrenzen und verweist für weitere Einzelheiten auf ein Demo-Projekt.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Im Auftrag sind keine Fragen angegeben, daher gibt es keine Einordnung nach Skala. Die Zusammenfassung 'mittel' gibt den Bericht im Kern treu wieder; die Zusammenfassung 'kurz' ist ebenfalls korrekt, aber noch knapper. Die im Bericht genannten Caching-Vermutungen und Erfahrungsberichte werden von Luna richtig als solche gekennzeichnet.
Im Bericht, aber nicht in der Zusammenfassung
- Der Autor vermutet, dass Quick Look unterstützte Dateitypen anhand der Dateiendung erkennt, und hat dazu keine Dokumentation gefunden.
- Der Autor hält init(fileURL:) für den einzig zuverlässig funktionierenden Weg, die anderen QLPreviewReply-Initialisierer blieben beim Erzeugen hängen; das ist eine persönliche Beobachtung.
- Der Hinweis, dass die Preview-Erweiterung nur greift, wenn der UTI exakt übereinstimmt und ein übergeordneter UTI wie public.data nicht reicht, fehlt ebenfalls.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.