NSUserDefaults 在 iOS 開發中非常好用,既能存放 App 的設定項目,又會被 iTunes 一併備份。如果再搭配一個 Settings.bundle,這些項目還能直接出現在系統的「設定」裡給使用者調整。
要達到這個效果,你得建立 Settings.bundle,並描述清楚想顯示哪些項目、要用什麼樣式顯示。接下來就示範如何加入一個名為 bounces 的 Bool 值。
可以透過 Xcode 的 New File → Resources → Settings Bundle 範本建立,然後編輯 Root.plist:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
"https://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>StringsTable</key>
<string>Root</string>
<key>PreferenceSpecifiers</key>
<array>
<dict>
<key>Type</key>
<string>PSToggleSwitchSpecifier</string>
<key>Title</key>
<string>Bounces</string>
<key>Key</key>
<string>bounces</string>
<key>DefaultValue</key>
<true/>
</dict>
</array>
</dict>
</plist>
注意這裡把預設值設為 true。
bounces 採單例形式存取,讀寫各一個方法:
-(BOOL)bounces {
return [[NSUserDefaults standardUserDefaults] boolForKey:@"bounces"];
}
-(void)setBounces:(BOOL)bounces {
[[NSUserDefaults standardUserDefaults] setBool:bounces forKey:@"bounces"];
[[NSUserDefaults standardUserDefaults] synchronize];
}
寫到這裡看起來一切正常,但這段程式碼其實藏著兩個 bug。
只要存在預設值,除了要在 Settings.bundle/Root.plist 中描述,還必須在程式碼裡再註冊一次。
也就是說,當你第一次用 NSUserDefaults 讀取屬性時,Root.plist 裡寫的 DefaultValue 是不作用的。這一點未必能在文件裡找到明確說明,但實測確實如此。
解法是在 helper 類中加入 initialize:
+(void)initialize {
[[NSUserDefaults standardUserDefaults] registerDefaults:
[NSDictionary dictionaryWithObjectsAndKeys:
[NSNumber numberWithBool:YES], @"bounces", nil]];
}
第二個問題更讓人困惑。操作步驟是這樣的:App 切到背景 → 打開系統「設定」改掉屬性值 → 切回 App。此時你會發現,App 讀到的仍然是舊值。
解法是在回到前景時明確呼叫一次同步:
-(void)applicationWillEnterForeground:(UIApplication *)application {
[[NSUserDefaults standardUserDefaults] synchronize];
// ...
}
這個問題未必會被使用者察覺,但一個講究品質的 App 應該處理掉。再次說明:以上內容並非依據官方文件,而是實測過程中所碰到的現象,值得在自己的專案裡驗證一遍。
摘自 kmyhy的專欄