你在远程 Mac 桌面里测试“恢复默认设置”,开关却仍有值;换一条测试执行顺序,结果又变了。先别加等待或强制同步:UserDefaults 的读取结果可能来自注册默认值,并不代表持久数据还在。下面先在云端 Mac 上运行一份独立 Swift 脚本,再把同样的契约迁入 iOS 测试,定位默认值、显式覆盖与重置边界。
先定义设置的读取契约
把“显示提示”约定为默认开启,把“重试次数”约定为默认三次。用户明确关闭提示或选择零次重试,必须覆盖默认值;删除设置键后,应重新使用默认值。
register(defaults:) 提供注册域中的回退值,不会把这些值写进应用的持久域。普通读取会搜索多个域,而 persistentDomain(forName:) 只检查指定持久域。两者回答的问题不同,验收时要分别断言。
“读得到”不等于“已经持久保存”。
dictionaryRepresentation()是搜索域合并后的视图,不能当作落盘证明。
先把这四个状态写进用例:初始回退、显式覆盖、单键删除、整域重置。不要只检查界面开关的位置。
用独立 suite 跑通基础验证
在终端执行 xcrun swift --version 确认工具可用,把下面内容保存为 defaults-contract.swift,再运行 xcrun swift defaults-contract.swift。脚本没有输出且退出码为零,表示全部前置条件成立;失败时会停止执行。
随机 suite 名避免命中长驻机器里的旧数据,键名也单独生成,减少注册域在同一进程内产生冲突。脚本只操作自己的持久域,不触碰真实应用配置。
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)
这份脚本验收的是当前进程中的 Foundation 行为,不是跨进程写盘时序。不要据此宣称应用重启后的读取已经通过,更不能代替 iOS 沙盒内的执行。
把存储注入业务层
业务代码如果直接使用 UserDefaults.standard,测试就很难隔离。让设置仓库接收一个 UserDefaults 实例,生产环境传入约定的存储,测试传入新建 suite。仓库初始化时统一注册默认值,不要散落在不同页面的生命周期里。
显式关闭不能被回退覆盖
避免写出“读取为 false 就改成 true”的逻辑。bool(forKey:) 在缺失键时也可能返回 false,不能用真假判断键是否存在;注册默认值后,正常读取即可获得约定的回退结果。
同理,零次重试是有效设置,不能把零当成“未配置”。需要判断用户是否保存过某个选项时,检查目标持久域中的键;object(forKey:) 也会搜索注册域,不能完成这个判断。
重置全部设置还是只重置界面偏好,也要在仓库接口里写清楚。如果同一持久域存放了其他业务标记,生产代码应按允许清单删除,不能照搬测试里的整域清理。
在 iOS 测试里补齐生命周期边界
将上述前置条件改成 XCTest 断言,放入 iOS 测试目标执行。每个用例使用自己的 suite,在结束阶段清理;随机键名不是应用业务键的替代品,业务测试仍应通过仓库接口操作真实键。
并行用例还要注意:注册域并非每个 suite 都拥有一份完全独立的副本。相同进程中的同名注册键可能互相影响,不能仅凭 suite 名不同就认定彻底隔离。可让同名键用例串行执行,或在测试仓库中注入键前缀。
涉及应用重启时,另建集成用例:写入设置、正常退出、重新启动,再核对值。测试进程的 suite 不会自动成为应用进程使用的 suite,需要明确的测试入口。不要用固定睡眠时间包装一个没有完成条件的流程,也不要靠 synchronize() 掩盖存储选错的问题。
用失败特征收口排查
重置后仍读到默认值,先检查持久域是否已清空;这往往是正确回退。显式 false 被改回 true,则检查是否存在基于真假值的初始化逻辑。单独运行通过、整组运行失败,优先检查注册键冲突和共享 standard。
记录失败时只保留 suite 名、测试键和预期类型,不要导出完整偏好字典。最终验收应同时覆盖“删除了什么”和“删除后读到什么”,再增加一个重复重置用例,确认第二次执行仍然安全。这样你得到的是可复用的设置契约,而不是一次碰巧正确的界面状态。
常见问题
register(defaults:) 会把默认值写入持久存储吗?
不会。它提供注册域中的回退值。检查持久数据应读取 persistentDomain(forName:),不能用 dictionaryRepresentation() 判断是否落盘。
删除整个持久域后,为什么仍能读到设置值?
读取会继续回退到注册默认值。重置测试应同时断言持久域中业务键已经消失,以及读取结果回到了约定的默认值。