Vous testez la restauration des réglages par défaut dans un bureau Mac distant, mais l’interrupteur conserve une valeur. Vous changez l’ordre d’exécution des tests, et le résultat change à nouveau. Avant d’ajouter une attente ou de forcer la synchronisation, vérifiez l’origine de la valeur lue : UserDefaults peut renvoyer une valeur par défaut enregistrée, sans que des données persistantes soient encore présentes. Nous allons d’abord exécuter un script Swift autonome sur un Mac cloud, puis reprendre le même contrat dans les tests iOS pour cerner les valeurs par défaut, les remplacements explicites et le périmètre de la réinitialisation.
Définir d’abord le contrat de lecture des réglages
Convenons que l’affichage des conseils est activé par défaut et que le nombre de nouvelles tentatives est fixé à trois. Si l’utilisateur désactive explicitement les conseils ou choisit zéro nouvelle tentative, ce choix doit prévaloir sur la valeur par défaut. Une fois la clé supprimée, la valeur par défaut doit de nouveau s’appliquer.
register(defaults:) fournit des valeurs de repli dans le domaine d’enregistrement, sans les écrire dans le domaine persistant de l’application. Une lecture ordinaire parcourt plusieurs domaines, tandis que persistentDomain(forName:) examine uniquement le domaine persistant indiqué. Ces deux opérations répondent à des questions différentes : il faut donc les vérifier avec des assertions distinctes.
« La valeur est lisible » ne signifie pas « la valeur a été enregistrée dans le stockage persistant ».
dictionaryRepresentation()est une vue fusionnée des domaines de recherche, pas une preuve d’écriture sur disque.
Commencez par couvrir ces quatre états dans les tests : repli initial, remplacement explicite, suppression d’une seule clé et réinitialisation de tout le domaine. Ne vérifiez pas uniquement la position de l’interrupteur dans l’interface.
Valider le comportement de base avec une suite isolée
Dans le terminal, exécutez xcrun swift --version pour vérifier que l’outil est disponible. Enregistrez le contenu ci-dessous dans defaults-contract.swift, puis lancez xcrun swift defaults-contract.swift. Si le script ne produit aucune sortie et se termine avec un code de sortie nul, toutes les préconditions sont satisfaites. En cas d’échec, l’exécution s’arrête.
Un nom de suite aléatoire évite de retrouver d’anciennes données sur une machine utilisée depuis longtemps. Les noms de clés sont eux aussi générés séparément afin de limiter les conflits dans le domaine d’enregistrement au sein d’un même processus. Le script ne manipule que son propre domaine persistant et ne touche pas à la configuration réelle de l’application.
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)
Ce script valide le comportement de Foundation dans le processus courant, pas la chronologie des écritures sur disque entre plusieurs processus. Il ne permet pas d’affirmer que la lecture après un redémarrage de l’application a été validée, et remplace encore moins une exécution dans le bac à sable iOS.
Injecter le stockage dans la couche métier
Lorsque le code métier utilise directement UserDefaults.standard, les tests sont difficiles à isoler. Faites accepter une instance de UserDefaults au dépôt de réglages : en production, fournissez le stockage prévu ; dans les tests, une suite nouvellement créée. Centralisez l’enregistrement des valeurs par défaut lors de l’initialisation du dépôt, au lieu de le disperser dans les méthodes du cycle de vie des différents écrans.
Une désactivation explicite ne doit pas être écrasée par la valeur de repli
Évitez toute logique du type « si la lecture renvoie false, remplacer par true ». bool(forKey:) peut aussi renvoyer false lorsqu’une clé est absente : une valeur booléenne ne permet donc pas de déterminer si la clé existe. Une fois les valeurs par défaut enregistrées, une lecture normale suffit pour obtenir la valeur de repli prévue.
De même, zéro nouvelle tentative est un réglage valide, pas un synonyme de « non configuré ». Pour déterminer si l’utilisateur a enregistré une option, vérifiez la présence de sa clé dans le domaine persistant concerné. object(forKey:) parcourt lui aussi le domaine d’enregistrement et ne permet pas de faire cette distinction.
L’interface du dépôt doit également préciser si la réinitialisation concerne tous les réglages ou seulement les préférences de l’interface. Si le même domaine persistant contient d’autres indicateurs métier, le code de production doit supprimer les clés selon une liste autorisée. Ne reprenez pas telle quelle la suppression de tout le domaine utilisée dans le test.
Couvrir les limites du cycle de vie dans les tests iOS
Remplacez les préconditions ci-dessus par des assertions XCTest et exécutez-les dans la cible de tests iOS. Chaque cas de test doit utiliser sa propre suite et la nettoyer à la fin. Les noms de clés aléatoires ne remplacent pas les clés métier de l’application : les tests métier doivent toujours manipuler les vraies clés via l’interface du dépôt.
En cas d’exécution parallèle, gardez aussi à l’esprit que chaque suite ne dispose pas nécessairement d’une copie entièrement indépendante du domaine d’enregistrement. Des clés enregistrées sous le même nom dans un même processus peuvent interférer. Des noms de suite différents ne suffisent donc pas à garantir une isolation complète. Vous pouvez exécuter séquentiellement les tests qui utilisent les mêmes noms de clés, ou injecter un préfixe de clés dans le dépôt de test.
Si le scénario implique un redémarrage de l’application, créez un test d’intégration distinct : écrivez les réglages, quittez normalement l’application, relancez-la, puis vérifiez les valeurs. La suite du processus de test ne devient pas automatiquement celle du processus de l’application ; un point d’entrée de test explicite est nécessaire. Ne remplacez pas une condition de fin manquante par une temporisation fixe, et n’utilisez pas synchronize() pour masquer le choix d’un mauvais stockage.
Cibler le diagnostic à partir des symptômes d’échec
Si les valeurs par défaut restent lisibles après la réinitialisation, vérifiez d’abord que le domaine persistant a bien été vidé : il s’agit souvent du comportement de repli attendu. Si un false explicite redevient true, cherchez une logique d’initialisation fondée sur la valeur booléenne. Si un test passe seul mais échoue avec l’ensemble de la suite de tests, vérifiez en priorité les conflits entre clés enregistrées et le partage de standard.
Lors de la consignation d’un échec, ne conservez que le nom de la suite, les clés de test et les types attendus ; n’exportez pas le dictionnaire complet des préférences. La validation finale doit couvrir à la fois « ce qui a été supprimé » et « ce qui est lu après la suppression ». Ajoutez ensuite un test de réinitialisation répétée pour vérifier qu’une deuxième exécution reste sans risque. Vous obtenez ainsi un contrat de réglages réutilisable, plutôt qu’un état d’interface correct par hasard lors d’une seule exécution.
Questions fréquentes
register(defaults:) écrit-il les valeurs sur disque ?
Non. Il fournit des valeurs de repli dans le domaine d’enregistrement. Inspectez persistentDomain(forName:) pour les données persistantes, pas dictionaryRepresentation().
Pourquoi une valeur reste-t-elle lisible après la suppression du domaine persistant ?
La lecture retombe sur la valeur enregistrée par défaut. Vérifiez à la fois l’absence des clés métier dans le domaine persistant et le retour aux valeurs de repli attendues.
Testez votre workflow sur un Mac dédié
Vérifiez d’abord le modèle, le centre de données et la durée de location, puis faites un essai d’une journée. L’état réel de disponibilité est indiqué en temps réel dans la console.