iOS UserDefaults auf einem Cloud-Mac prüfen: Standardwerte und Reset
Sie testen auf einem entfernten Mac-Desktop die Funktion „Standardeinstellungen wiederherstellen“, doch der Schalter hat weiterhin einen Wert. Ändern Sie die Reihenfolge der Tests, fällt das Ergebnis plötzlich anders aus. Fügen Sie nicht vorschnell Wartezeiten oder eine erzwungene Synchronisierung hinzu: Ein aus UserDefaults gelesener Wert kann aus den registrierten Standardwerten stammen und bedeutet nicht, dass noch persistente Daten vorhanden sind. Zunächst führen wir ein eigenständiges Swift-Skript auf einem Cloud-Mac aus. Anschließend übertragen wir denselben Verhaltensvertrag in iOS-Tests, um Standardwerte, explizite Überschreibungen und die Grenzen des Resets zu prüfen.
Zuerst den Vertrag für das Lesen von Einstellungen festlegen
Wir legen fest: „Hinweise anzeigen“ ist standardmäßig aktiviert, die Anzahl der Wiederholungsversuche beträgt standardmäßig drei. Deaktiviert der Nutzer die Hinweise ausdrücklich oder wählt null Wiederholungsversuche, muss diese Auswahl Vorrang vor dem Standardwert haben. Wird der Einstellungsschlüssel gelöscht, soll wieder der Standardwert gelten.
register(defaults:) stellt Rückfallwerte in der Registrierungsdomäne bereit, schreibt sie aber nicht in die persistente Domäne der App. Reguläre Lesezugriffe durchsuchen mehrere Domänen, während persistentDomain(forName:) ausschließlich die angegebene persistente Domäne prüft. Beide Zugriffe beantworten unterschiedliche Fragen und müssen bei der Verifikation getrennt geprüft werden.
„Lesbar“ bedeutet nicht „persistent gespeichert“.
dictionaryRepresentation()liefert eine zusammengeführte Ansicht der durchsuchten Domänen und ist kein Nachweis dafür, dass Werte auf die Festplatte geschrieben wurden.
Nehmen Sie zunächst diese vier Zustände in die Testfälle auf: anfänglicher Rückfall auf Standardwerte, explizite Überschreibung, Löschen eines einzelnen Schlüssels und Zurücksetzen der gesamten Domäne. Prüfen Sie nicht nur die Stellung des Schalters in der Oberfläche.
Die grundlegenden Prüfungen mit einer eigenen Suite durchführen
Führen Sie im Terminal xcrun swift --version aus, um die Verfügbarkeit des Werkzeugs zu prüfen. Speichern Sie den folgenden Inhalt als defaults-contract.swift und starten Sie ihn mit xcrun swift defaults-contract.swift. Wenn das Skript ohne Ausgabe mit Exit-Code null endet, sind alle Vorbedingungen erfüllt. Schlägt eine Prüfung fehl, wird die Ausführung abgebrochen.
Ein zufälliger Suite-Name verhindert, dass alte Daten auf einer länger genutzten Maschine die Prüfung beeinflussen. Auch die Schlüsselnamen werden separat erzeugt, um Konflikte in der Registrierungsdomäne innerhalb desselben Prozesses zu reduzieren. Das Skript arbeitet ausschließlich mit seiner eigenen persistenten Domäne und greift nicht auf die Konfiguration der eigentlichen App zu.
import Foundation
let token = UUID().uuidString
let suite = "local.defaults.contract." + token
guard let defaults = UserDefaults(suiteName: suite) else {
fatalError("Unable to create defaults suite")
}
let enabled = token + ".hintsEnabled"
let retries = token + ".retryCount"
defer {
defaults.removePersistentDomain(forName: suite)
}
defaults.register(defaults: [
enabled: true,
retries: 3
])
precondition(defaults.bool(forKey: enabled))
precondition(defaults.integer(forKey: retries) == 3)
precondition(defaults.persistentDomain(forName: suite)?[enabled] == nil)
defaults.set(false, forKey: enabled)
defaults.set(0, forKey: retries)
precondition(!defaults.bool(forKey: enabled))
precondition(defaults.integer(forKey: retries) == 0)
precondition(
defaults.persistentDomain(forName: suite)?[enabled] as? Bool == false
)
defaults.removeObject(forKey: enabled)
precondition(defaults.bool(forKey: enabled))
precondition(defaults.persistentDomain(forName: suite)?[enabled] == nil)
precondition(defaults.integer(forKey: retries) == 0)
defaults.removePersistentDomain(forName: suite)
precondition(defaults.bool(forKey: enabled))
precondition(defaults.integer(forKey: retries) == 3)
precondition(defaults.persistentDomain(forName: suite)?[retries] == nil)
Dieses Skript prüft das Verhalten von Foundation im aktuellen Prozess, nicht den Zeitpunkt von Schreibvorgängen auf die Festplatte über Prozessgrenzen hinweg. Daraus lässt sich weder ableiten, dass das Lesen nach einem App-Neustart bereits erfolgreich getestet wurde, noch ersetzt es die Ausführung in der iOS-Sandbox.
Den Speicher in die Geschäftslogik injizieren
Wenn die Geschäftslogik direkt auf UserDefaults.standard zugreift, lassen sich Tests nur schwer isolieren. Lassen Sie das Einstellungsrepository eine UserDefaults-Instanz entgegennehmen: In der Produktion übergeben Sie den vorgesehenen Speicher, im Test eine neu angelegte Suite. Registrieren Sie die Standardwerte zentral bei der Initialisierung des Repositorys, statt dies über die Lebenszyklusmethoden verschiedener Ansichten zu verteilen.
Explizites Deaktivieren darf nicht durch einen Standardwert überschrieben werden
Vermeiden Sie eine Logik nach dem Muster „Wenn der gelesene Wert false ist, setze ihn auf true“. bool(forKey:) kann auch bei einem fehlenden Schlüssel false zurückgeben. Der Wahrheitswert allein sagt daher nicht aus, ob der Schlüssel existiert. Nach dem Registrieren der Standardwerte liefert ein regulärer Lesezugriff bereits den vereinbarten Rückfallwert.
Ebenso sind null Wiederholungsversuche eine gültige Einstellung; null darf nicht als „nicht konfiguriert“ gelten. Wenn Sie feststellen müssen, ob ein Nutzer eine Option bereits gespeichert hat, prüfen Sie den Schlüssel in der betreffenden persistenten Domäne. Auch object(forKey:) durchsucht die Registrierungsdomäne und eignet sich deshalb nicht für diese Prüfung.
Definieren Sie außerdem in der Schnittstelle des Repositorys klar, ob ein Reset sämtliche Einstellungen oder nur die Oberflächenpräferenzen zurücksetzt. Enthält dieselbe persistente Domäne weitere Kennzeichen der Geschäftslogik, darf der Produktionscode nur Schlüssel aus einer Positivliste löschen. Übernehmen Sie nicht einfach das vollständige Löschen der Domäne aus dem Test.
Lebenszyklusgrenzen in iOS-Tests ergänzen
Ersetzen Sie die obigen Vorbedingungen durch XCTest-Assertions und führen Sie sie in einem iOS-Test-Target aus. Jeder Testfall verwendet seine eigene Suite und räumt sie zum Abschluss auf. Zufällige Schlüsselnamen sind kein Ersatz für die tatsächlichen Schlüssel der App: Tests der Geschäftslogik sollten weiterhin über die Repository-Schnittstelle mit den echten Schlüsseln arbeiten.
Bei parallelen Testfällen ist zusätzlich zu beachten: Nicht jede Suite besitzt eine vollständig unabhängige Kopie der Registrierungsdomäne. Gleichnamige registrierte Schlüssel im selben Prozess können sich gegenseitig beeinflussen. Unterschiedliche Suite-Namen allein garantieren daher keine vollständige Isolation. Sie können Testfälle mit gleichnamigen Schlüsseln sequenziell ausführen oder ein Schlüsselpräfix in das Testrepository injizieren.
Für einen App-Neustart legen Sie einen separaten Integrationstest an: Einstellungen schreiben, die App regulär beenden, erneut starten und anschließend die Werte prüfen. Die Suite des Testprozesses wird nicht automatisch zur Suite des App-Prozesses; dafür ist ein expliziter Test-Einstiegspunkt nötig. Ergänzen Sie einen Ablauf ohne definierte Abschlussbedingung nicht um feste Wartezeiten, und verwenden Sie synchronize() nicht, um die Wahl des falschen Speichers zu kaschieren.
Die Fehlersuche anhand typischer Symptome eingrenzen
Wenn nach einem Reset weiterhin Standardwerte gelesen werden, prüfen Sie zunächst, ob die persistente Domäne geleert wurde. Häufig ist das lediglich der korrekte Rückfall auf die Standardwerte. Wird ein explizit gespeichertes false wieder zu true, suchen Sie nach Initialisierungslogik, die sich am Wahrheitswert orientiert. Besteht ein Test einzeln, schlägt aber in der gesamten Testsuite fehl, prüfen Sie zuerst Konflikte zwischen registrierten Schlüsseln und die gemeinsame Nutzung von standard.
Halten Sie bei einem Fehler nur den Suite-Namen, die Testschlüssel und die erwarteten Typen fest. Exportieren Sie nicht das vollständige Einstellungs-Dictionary. Die abschließende Verifikation muss sowohl „Was wurde gelöscht?“ als auch „Was wird nach dem Löschen gelesen?“ abdecken. Ergänzen Sie außerdem einen Testfall mit wiederholtem Reset, um sicherzustellen, dass auch die zweite Ausführung unbedenklich ist. So erhalten Sie einen wiederverwendbaren Vertrag für das Verhalten Ihrer Einstellungen statt eines zufällig korrekten Zustands der Oberfläche.
Häufig gestellte Fragen
Speichert register(defaults:) die Standardwerte auf der Festplatte?
Nein. Die Methode liefert Rückfallwerte aus der Registrierungsdomäne. Prüfen Sie gespeicherte Daten mit persistentDomain(forName:), nicht mit dictionaryRepresentation().
Warum bleibt ein Wert nach dem Löschen der persistenten Domäne lesbar?
Der Lesezugriff fällt auf registrierte Standardwerte zurück. Prüfen Sie sowohl das Fehlen der fachlichen Schlüssel in der persistenten Domäne als auch die erwarteten Rückfallwerte.
Workflow auf einem dedizierten Mac testen
Prüfen Sie zuerst Modell, Standort und Mietdauer und testen Sie Ihren Workflow anschließend tageweise. Maßgeblich ist der aktuelle Verfügbarkeitsstatus in der Konsole.