NSUserDefaults 類別用來保存 App 設定、屬性以及各類輕量級的資料。舉例來說,你可以用它存使用者上次選的配色方案、某個開關的狀態,或一些小型設定。
這些物件被存放在 iOS 所稱的「defaults 系統」中。該系統在整個 App 內都是可存取的,因此放進去的資料在整個應用生命週期裡都有效——不論使用者關掉 App 或關機,重新開啟後資料仍然存在。
NSUserDefaults 能儲存的型別有限:
· NSData · NSString · NSNumber · NSDate · NSArray · NSDictionary
若要保存其他型別(例如 UIImage),必須先編碼(archive),或轉換成上述幾種型別之一。
特別提醒:密碼不該存在 NSUserDefaults。若基於某些原因必須存,至少要用 AES/DES 加密,更安全的做法是改用鑰匙圈(Keychain)。把密碼明文放進 NSUserDefaults 或 plist,等同於寫在沙盒裡讓人撿。
它其實存在 App 沙盒內的一個 plist 檔案裡。以模擬器為例,路徑大致如下:
/Users/<你的帳號>/Library/Application Support/iPhoneSimulator/<版本>/Applications/<App UUID>/Library/Preferences/
這個 App UUID 目錄下的 Library/Preferences 裡,那個 plist 存的就是你的 user defaults。
如果 App 意外終止,standardUserDefaults 中的資料可能還沒被系統寫入檔案。這時可以呼叫 synchronize 強制立刻寫入,降低資料遺失的風險:
[[NSUserDefaults standardUserDefaults] synchronize];
補充:synchronize 並非效能考量下的常態操作,不該每次變更都呼叫。它比較像是「即將進入背景」或「關鍵設定寫入後」這種時機的保險動作。
用 removeObjectForKey: 刪除單一鍵值;或直接刪掉 App 重新安裝,整個 defaults 系統就會重置。
做一個簡單示範:兩個文字輸入框加一顆按鈕,在左邊輸入文字後按按鈕,內容會被存進 NSUserDefaults,再讀出來顯示在右邊。
// 寫入 NSUserDefaults *savePtb = [NSUserDefaults standardUserDefaults]; [savePtb setObject:self.textField.text forKey:@"input"]; // 讀取 NSUserDefaults *readPtb = [NSUserDefaults standardUserDefaults]; NSString *pstr = [readPtb objectForKey:@"input"]; self.inputText.text = pstr;
我們常需要在 App 第一次開啟時做一些事情(例如顯示引導頁)。做法是在啟動時檢查某個鍵值是否存在:
NSUserDefaults *userDF = [NSUserDefaults standardUserDefaults];
NSNumber *number = [userDF objectForKey:@"H"];
if (number == nil) {
// 第一次執行
[userDF setValue:[NSNumber numberWithBool:YES] forKey:@"H"];
[userDF synchronize];
// 其他初始化程式碼
} else {
// 非首次執行
}
這個類別的定位是「小量、非關鍵」的設定資料。以下情況該換工具:
· 敏感資料(密碼、權杖、金鑰)→ 用 Keychain。
· 大量或結構化資料 → 用 SQLite/Core Data/FMDB。
· 大檔案(圖片、影片)→ 直接寫到 Documents 或 Caches 目錄,NSUserDefaults 只存路徑。
原因很實際:defaults 系統每次變更都會整份重新寫入 plist,資料一多,讀寫成本與啟動延遲都會跟著上升。