在雲端 Mac 驗收 iOS UserDefaults 預設值與重設行為

在雲端 Mac 驗收 iOS UserDefaults 預設值與重設行為

在雲端 Mac 驗收 iOS UserDefaults 預設值與重設行為

你在遠端 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() 判斷是否寫入。

刪除整個持久網域後,為什麼仍能讀到設定值?

讀取會繼續回退到註冊預設值。重設測試應同時斷言持久網域中的業務鍵值已經消失,以及讀取結果回到約定的預設值。

用一台獨享 Mac 驗證你的工作流程

先確認機型、節點與租用期間,再按天試用。實際可用狀態請以控制台即時回報為準。