SwiftUI: Sync User Preferences with iCloud Key-Value Storage
Zusammenfassung
Kurz
Der Bericht beschreibt, wie `NSUbiquitousKeyValueStore` SwiftUI-Einstellungen über iCloud abgleichen kann, und zeigt Einrichtung, Benachrichtigungsverarbeitung sowie einen Beispielmanager. Der Abgleich ist systemgesteuert und nicht sofort garantiert; `synchronize()` erzwingt laut Artikel keinen Upload, auch wenn der Autor berichtet, dass er den Aufruf in seinem Beispiel für zuverlässiges Verhalten benötigte.
Mittel
Der Bericht zeigt, wie SwiftUI-Einstellungen mit `NSUbiquitousKeyValueStore` zwischen Geräten abgeglichen werden können. Der Speicher ähnelt `UserDefaults` und unterstützt unter anderem Bool, String, Datum, Daten, Arrays, Dictionaries und Zahlen. Als Grenzen nennt der Artikel 1 MB Gesamtspeicher, höchstens 1.024 Schlüssel und 64 UTF-8-Bytes je Schlüssel.
Der Abgleich wird vom System gesteuert und erfolgt nicht zwingend sofort; Upload-Anfragen seien auf mehrere pro Minute begrenzt. Werte können zunächst lokal bleiben, wenn kein iCloud-Konto angemeldet ist. `synchronize()` signalisiert laut Bericht verfügbare Änderungen, erzwingt aber keinen unmittelbaren Upload. Die Einrichtung erfolgt über die iCloud-Fähigkeit und Key-Value-Storage in Xcode.
Der Beispielmanager hört auf externe Änderungsbenachrichtigungen, verarbeitet Gründe wie Serveränderung, ersten Abgleich, Quotenüberschreitung und Kontowechsel und aktualisiert betroffene Werte. Der Autor ruft `synchronize()` beim Start und nach einer Änderung auf. Obwohl der Aufruf laut Artikel normalerweise nicht nötig ist, berichtet der Autor, dass die Synchronisierung bei ihm sonst nicht zuverlässig funktionierte. Eine kleine Ansicht mit einem Button demonstriert das Speichern einer zufälligen Ganzzahl.
Ausführlich lesen
Der Bericht erklärt, wie sich mit `NSUbiquitousKeyValueStore` einfache Einstellungen und andere Schlüssel-Wert-Daten zwischen Geräten desselben iCloud-Kontos abgleichen lassen. Die Schnittstelle ähnelt laut Autor `UserDefaults` und unterstützt unter anderem Bool-, String-, Datums-, Daten-, Array- und Dictionary-Werte sowie Zahlen. Als Grenzen nennt der Artikel insgesamt 1 MB Speicher, höchstens 1.024 Schlüssel und Schlüssel mit maximal 64 UTF-8-Bytes.
Eine zentrale Einschränkung: Die Übertragung steuert das System. Neue Werte stehen auf anderen Geräten daher möglicherweise nicht sofort zur Verfügung; Anfragen für Uploads seien auf mehrere pro Minute begrenzt. Ohne angemeldetes iCloud-Konto können Werte zunächst lokal gespeichert werden. Meldet sich die Person später an, gleiche das System lokale Daten automatisch mit iCloud ab. Der Artikel betont außerdem, dass `synchronize()` keinen sofortigen Upload erzwingt, sondern iCloud lediglich auf verfügbare Werte hinweist.
Zur Einrichtung soll in Xcode die iCloud-Fähigkeit samt Key-Value-Storage aktiviert werden. Dadurch werde laut Bericht automatisch das passende Ubiquity-Key-Value-Store-Entitlement ergänzt. Eine separate Prüfung, ob ein iCloud-Konto angemeldet ist, hält der Autor für diesen Speicherweg nicht für nötig, da Daten auch lokal gehalten werden können.
Als Beispiel zeigt der Bericht einen `@Observable`-Manager auf dem Main Actor. Er verwendet den standardmäßigen Store, registriert sich für `didChangeExternallyNotification` und liest beim Start nach einem Synchronisationsversuch eine Int64-Einstellung aus. Bei Benachrichtigungen wertet er den Änderungsgrund und die geänderten Schlüssel aus. Behandelt werden Serveränderungen, ein noch ausstehender erster iCloud-Abgleich, eine Quotenüberschreitung und ein Wechsel des iCloud-Kontos. Ändert sich der relevante Schlüssel, aktualisiert der Manager den angezeigten Wert.
Der Beispielcode ruft `synchronize()` sowohl beim Start als auch nach einer vom Nutzer ausgelösten Änderung auf. Laut Artikel ist der Aufruf nach dem Setzen grundsätzlich nicht erforderlich, wenn das automatische Synchronisieren genügt; der Autor berichtet jedoch, dass es bei ihm ohne diesen Aufruf nicht zuverlässig funktionierte. Als Fehlerfälle führt der Code einen fehlgeschlagenen Synchronisationsaufruf und eine Quotenüberschreitung auf. Eine einfache SwiftUI-Ansicht demonstriert die Funktion, indem ein Button eine zufällige Ganzzahl speichert. Der Bericht beschreibt somit einen grundlegenden Ansatz, liefert aber keine systematische Messung der Synchronisationszeiten oder umfassende Prüfung der Fehlerbehandlung.
Gegengeprüft von Claude Haiku 5.5: kleine Mängel
Beide Zusammenfassungen von Luna wurden gemeinsam geprüft, da der Bericht in beiden korrekt wiedergegeben wird. Es wurden keine Fragen zur Einordnung angegeben, daher bleibt die Einordnung leer.
Im Bericht, aber nicht in der Zusammenfassung
- Eine Kontoprüfung ist nicht nötig: Anders als bei ubiquityIdentityToken oder accountStatus() werden Werte auch ohne angemeldeten iCloud-Account lokal gehalten.
- Bei einem Wechsel des primären iCloud-Kontos werden lokale Schlüssel und Werte unabhängig von den Zeitstempeln ersetzt.
- Setzt man Werte mit einem nicht unterstützten Typ über set(Any?, forKey:), wird der Wert verworfen und nur ein Fehler protokolliert.
Wie die Modelle den Bericht einordnen
Ansicht
Filter
Kein Modell sieht bei diesem Bericht einen Bezug zu einer der 44 Sammelfragen.