SwiftUI: Synchronize/Store Files (Documents) with iCloud
Zusammenfassung
Kurz
Der Beitrag zeigt eine SwiftUI-App, die Textdateien in iCloud Drive verwaltet und mithilfe von `NSMetadataQuery` Metadaten sowie Änderungen beobachtet. Der Autor weist darauf hin, dass iOS-Dateiinhalte gegebenenfalls erst heruntergeladen werden müssen, Simulator-Tests der Synchronisierung unzuverlässig gewesen seien und das Beispiel keine vollständige Dokument-basierte App darstellt.
Mittel
Der Artikel beschreibt eine SwiftUI-Beispiel-App, die Textdateien in iCloud Drive speichert und Änderungen über Geräte hinweg beobachtet. Eine `DocumentManager`-Klasse prüft mit `ubiquityIdentityToken`, ob iCloud verfügbar ist, reagiert auf Kontoänderungen und ermittelt die URL des iCloud-Containers. Für die Dateiliste nutzt sie `NSMetadataQuery`: Eine erste Abfrage lädt vorhandene Metadaten, spätere Benachrichtigungen melden Hinzufügen, Ändern oder Löschen. Der Autor rät, die komplette Ergebnisliste nicht bei jeder Änderung neu auszulesen, weil dies Leistung und Speicher belasten könne.
Dateien werden im Beispiel mit üblichen Dateioperationen erstellt, gelesen, geändert und gelöscht. Die Oberfläche wartet laut Konzept auf eine Metadatenbenachrichtigung, bevor sie ihre Liste aktualisiert. Der Beitrag betont, dass auf iOS Metadaten vor den eigentlichen Dateiinhalten verfügbar sein können; Inhalte müssen bei Bedarf heruntergeladen werden. Für `UIDocument`- oder `NSDocument`-Apps empfiehlt er deren eigene Zugriffsverfahren.
Der Autor berichtet, dass Tests der Synchronisierung mit Simulatoren unzuverlässig waren und echte Geräte nahelegt. Das Beispiel lässt außerdem die für eine vollständige Dokument-basierte App nötigen `Info.plist`-Einträge aus und bietet keine systematische Testauswertung.
Ausführlich lesen
Der Artikel von Itsuki zeigt, wie sich eine einfache SwiftUI-App einrichten lässt, die Textdateien in iCloud Drive speichert und deren Metadaten über Geräte hinweg beobachtet. Er ordnet iCloud-Dienste zunächst ein: Schlüssel-Wert-Speicher eigne sich laut Artikel für kleine Datenmengen wie Einstellungen, iCloud-Dokumente für Dateien und CloudKit für strukturierte Daten und Beziehungen. Im Mittelpunkt steht die Option „iCloud Documents“.
Die vorgestellte `DocumentManager`-Klasse prüft mit `FileManager.default.ubiquityIdentityToken`, ob ein iCloud-Konto verfügbar ist. Der Artikel erläutert, dass der Token `nil` ist, wenn iCloud Drive nicht verfügbar oder kein Nutzer angemeldet ist. Änderungen am angemeldeten Konto sollen über `NSUbiquityIdentityDidChange` erkannt werden. Die URL des iCloud-Containers wird mit `url(forUbiquityContainerIdentifier:)` ermittelt. In iOS müsse diese Methode mindestens einmal pro verwendeten Container aufgerufen werden; laut Artikel kann sie eine Weile dauern. Ein Container kann über die App-Entitlements festgelegt werden oder, wenn `nil` übergeben wird, dem ersten dort aufgeführten Container entsprechen.
Zum Auffinden von Dateien und zum Beobachten von Änderungen verwendet das Beispiel `NSMetadataQuery`. Die Abfrage ist auf Dateien mit der Endung `.txt` und festgelegte iCloud-Suchbereiche begrenzt. Der Artikel unterscheidet eine anfängliche Erfassungsphase von anschließenden Live-Aktualisierungen. Nach der ersten Erfassung werden die Ergebnisse aus der Abfrage geladen. Bei späteren Benachrichtigungen verarbeitet der Manager hinzugefügte, geänderte und entfernte Metadateneinträge einzeln und sortiert die Dateiliste nach Änderungsdatum. Der Autor warnt, dass das vollständige Auslesen der Query-Ergebnisse Leistung und Speicher belasten könne; deshalb empfiehlt er, dies auf die erste Erfassung zu begrenzen und spätere Änderungen aus den Benachrichtigungsdaten abzuleiten.
Die eigentlichen Dateifunktionen ähneln laut Artikel gewöhnlichen Dateioperationen: Der Beispielcode erstellt Dateien und Verzeichnisse, schreibt UTF-8-Text, liest Inhalte und löscht Dateien. Eine `processing`-Eigenschaft hält die Oberfläche während einer Operation gesperrt. Der Autor begründet das damit, dass die App ihre angezeigte Liste erst aktualisiert, wenn die Metadatenbenachrichtigung die Änderung bestätigt; dies solle eine zentrale Datenquelle sicherstellen. Der Artikel merkt an, dass dabei eine zusätzliche Zeitüberschreitung sinnvoll sein könnte, falls die Bestätigung zu lange ausbleibt.
Ein wichtiger Vorbehalt betrifft die Dateiinhalte: Auf iOS kann iCloud zunächst nur Metadaten synchronisieren, während die eigentlichen Daten erst auf Anfrage heruntergeladen werden. Der Artikel nennt `startDownloadingUbiquitousItem(at:)` als Möglichkeit, einen Download anzustoßen, und erwähnt `evictUbiquitousItem(at:)` zum Entfernen einer lokalen Kopie. Für Apps auf Basis von `UIDocument` oder `NSDocument` empfiehlt er deren vorgesehene Lese- und Schreibmethoden; bei großen Datenmengen verweist er auf asynchronen Dateizugriff und Koordination.
Als Ergebnis präsentiert der Beitrag eine einfache Dokumentenliste und einen Texteditor mit Erstellen, Öffnen, Ändern und Löschen. Der Autor berichtet, dass die Synchronisierung auf mehreren Geräten mit Simulatoren unzuverlässig gewesen sei und empfiehlt dafür echte Geräte. Der Beispielcode ist keine vollständige Dokument-basierte App: Dafür nötige `Info.plist`-Einträge wurden ausdrücklich ausgelassen. Der Artikel liefert keine systematische Testauswertung oder weitergehenden Konfliktlösungsmechanismen.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Keine Fragen zur Einordnung angegeben; die Zusammenfassungen wurden anhand des Berichts geprüft.
Im Bericht, aber nicht in der Zusammenfassung
- Der Container-Identifier muss in den Entitlements deklariert sein; ohne Angabe wird der erste Eintrag genutzt
- url(forUbiquityContainerIdentifier:) sollte nicht auf dem Hauptthread aufgerufen werden und wird deshalb in einem Task ausgeführt
- Die Initialphase von NSMetadataQuery liefert alle Ergebnisse, Live-Updates werden über die userInfo-Schlüssel nach Art der Änderung unterschieden
- Die Oberfläche wird über processing während laufender Vorgänge gesperrt
In der Zusammenfassung, laut Prüfung nicht im Bericht belegt
- Der Autor biete keine systematische Testauswertung (der Bericht sagt nur, Simulator-Tests seien unzuverlässig)
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.