SwiftUI: Document-Based App with Launch Scene Customization
Zusammenfassung
Kurz
Der Artikel zeigt, wie man mit `DocumentGroup`, `FileDocument` und `DocumentGroupLaunchScene` eine SwiftUI-Dokumenten-App mit anpassbarer iOS-Startansicht erstellt. Der Autor berichtet von Simulatorfehlern und Problemen beim Öffnen bestimmter Dokumente über externe Apps; die Ursachen vermutet er teilweise, und als Umgehung beschreibt er einen UIKit-`SceneDelegate`.
Mittel
Itsuki erläutert den Aufbau einer einfachen SwiftUI-Dokumenten-App mit `DocumentGroup`. Dazu gehören Einträge in der `Info.plist` für Dokumenttypen und Uniform Type Identifiers, ein eigenes `FileDocument`-Modell zum Lesen und Schreiben sowie eine Editoransicht. `DocumentGroup` stellt laut Artikel unter anderem Dokumenterstellung, Speicherung und Navigation bereit. Der Beitrag warnt davor, Dokumentinhalt oder Metadaten selbst über die Datei-URL auszulesen.
Für iOS 18 beschreibt der Autor `DocumentGroupLaunchScene`, mit der sich Titel, Hintergrund, dekorative Ansichten und bis zu zwei Schaltflächen zum Erstellen von Dokumenten konfigurieren lassen. Die Launch-Scene müsse auf iOS beschränkt werden; Titelbilder und Textformatierungen hätten in seinen Versuchen keine Wirkung.
Der Artikel berichtet außerdem über Probleme: Ein File-Provider-Fehler könne beim Erstellen auftreten, obwohl das Dokument gespeichert werde; eine Erklärung dafür vermutet der Autor. Umbenennungen könnten im Simulator die Navigationsüberschrift unverändert lassen, während dies auf einem echten Gerät funktioniere. Auch das Öffnen eines bestimmten Dokuments über externe Apps habe mit mehreren getesteten SwiftUI-Ansätzen nicht zuverlässig geklappt. Als Umgehung stellt der Autor einen UIKit-`SceneDelegate` vor und hält fest, dass die geschilderten Probleme seine Beobachtungen sind.
Ausführlich lesen
Der Artikel von Itsuki zeigt, wie sich mit SwiftUI eine einfache dokumentbasierte App erstellen und deren Startansicht auf iOS 18 anpassen lässt. Als Grundlage dient `DocumentGroup`, das laut Beitrag unter anderem Dokumente anlegen und speichern, eine Dokumentübersicht bereitstellen und mehrere Dokumente unterstützen kann.
Zunächst beschreibt der Autor die nötigen Einträge in der `Info.plist`: Dokumenttypen und Uniform Type Identifiers, die Rolle als Betrachter oder Editor sowie bei eigenen Dateitypen passende Exportdeklarationen und Vererbung von einem geeigneten Datentyp. Zusätzlich nennt der Beitrag `UISupportsDocumentBrowser` und `LSSupportsOpeningDocumentsInPlace`. Für das Dokumentmodell wird `FileDocument` bei Werttypen wie Strukturen und `ReferenceFileDocument` bei Referenztypen wie Klassen empfohlen. Die gezeigte `FileDocument`-Implementierung liest Dateiinhalte ein und stellt eine Methode zum Speichern bereit. Anschließend verbindet ein `DocumentGroup`-Scene das Dokument mit einer Editoransicht. Für reine Anzeige oder Dokumente auf Grundlage eines persistenten Speichers nennt der Autor weitere Initialisierer. Er warnt außerdem davor, den Dokumentinhalt oder Metadaten selbst über die Dokument-URL auszulesen, da dies mit der Dateiverwaltung von SwiftUI kollidieren könne.
Der zweite Teil behandelt `DocumentGroupLaunchScene` als anpassbare Startansicht hinter dem Dokumentbrowser. Laut Artikel lassen sich Titel, Schaltflächen, Hintergrund sowie dekorative Ansichten konfigurieren. `NewDocumentButton` kann eine vorbereitete Vorlage liefern oder die Dokumenterstellung anderweitig anpassen; bis zu zwei solche Schaltflächen sind vorgesehen. Die Launch-Scene müsse mit `#if os(iOS)` auf iPhone und iPad beschränkt werden, da ihre Nutzung auf dem Mac nach Aussage des Autors zu einem Absturz führe. Formatierungen und Bilder in einem als `Text` gesetzten Titel hätten laut seinen Beobachtungen keine Wirkung.
Abschließend schildert der Autor Probleme, die er vor allem auf Simulatoren beobachtet hat. Beim Anlegen neuer Dokumente könne ein Fehler aus `NSFileProviderErrorDomain` auftreten, obwohl das Dokument erstellt werde; seine Erklärung, dass das Öffnen vor Abschluss des Speicherns versucht werde, ist ausdrücklich eine Vermutung. Auch könne die Navigationsüberschrift nach einer Umbenennung im Simulator veraltet bleiben, während der Autor das auf einem echten Gerät nicht beobachtet habe. Das Öffnen eines konkreten Dokuments über eine externe App funktioniere für ihn entgegen seiner Erwartung nicht zuverlässig. Drei SwiftUI-Ansätze hätten nach seinen Versuchen nicht funktioniert; als Behelf beschreibt er einen UIKit-`SceneDelegate`, der eine URL entgegennimmt und eine SwiftUI-Ansicht in einen Navigationscontroller einfügt. Der Autor bewertet diesen Umweg als unsauber und `DocumentGroup` als noch nicht ausreichend produktionsreif. Die genannten Fehler und Einschränkungen sind Erfahrungsberichte des Autors, keine im Text belegte allgemeingültige Fehleranalyse.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Die Sammelfragen- und Teilfragen-Einordnung ist leer, weil keine Fragen angegeben wurden; daher wurde nur die Zusammenfassung geprüft. Beide Fassungen (kurz und mittel) geben den Bericht sachlich korrekt wieder; die mittlere Fassung ist vollständiger, wobei auch sie einige Details wie die iOS-18-Voraussetzung und den Apple-Beispielcode nicht nennt.
Im Bericht, aber nicht in der Zusammenfassung
- Die Voraussetzung iOS 18 für DocumentGroupLaunchScene fehlt in der kurzen Fassung.
- Die Konfiguration der Info.plist (Dokumenttypen, UTExportedTypeDeclarations, UISupportsDocumentBrowser, LSSupportsOpeningDocumentsInPlace) wird nur allgemein erwähnt.
- Das Umbenennungsproblem (Namensänderung nur in der Dateiliste, nicht in der Navigationsleiste im Simulator) fehlt in der kurzen Fassung.
- Der Hinweis, dass Apples eigener Beispielcode denselben Fehler zeigt, fehlt in beiden Fassungen.
- Die Angabe, dass Titelbilder und Schriftformatierungen in der Launch-Scene nicht wirken, fehlt in der kurzen Fassung.
- Die Einschränkung, dass Launch-Scene-Code nur mit #if os(iOS) verwendet werden darf, fehlt in der kurzen Fassung.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.