iPhone开发之使用NSUserDefaults存储数据
NSUserDefaults是什么,有什么用处
对于应用来说,每个用户都有自己的独特偏好设置,而好的应用会让用户根据喜好选择合适的使用方式,把这些偏好记录在应用包的plist
文件中,通过NSUserDefaults
类来访问,这是NSUserDefaults
的常用姿势。如果有一些设置你希望用户即使升级后还可以继续使用,比如玩游戏时得过的最高分、喜好和通知设置、主题颜色甚至一个用户头像,那么你可以使用NSUserDefaults
来存储这些信息,如果有更多需求,可以了解数据持久化
相关的知识。
具体来说NSUserDefaults
是iOS系统提供的一个单例类(iOS提供了若干个单例类),通过类方法standardUserDefaults
可以获取NSUserDefaults
单例。如:
1 | NSUserDefaults *defaults = [ NSUserDefaults standardUserDefaults]; |
NSUserDefaults
单例以key-value
的形式存储了一系列偏好设置,key
是名称,value
是相应的数据。存/取数据时可以使用方法objectForKey:
和setObject:forKey:
来把对象存储到相应的plist
文件中,或者读取,既然是plist
文件,那么对象的类型则必须是plist
文件可以存储的类型,
正如官方文档中提到的——
NSData
NSString
NSNumber
NSDate
NSArray
NSDictionary
而如果需要存储plist
文件不支持的类型,比如图片,可以先将其归档为NSData
类型,再存入plist
文件,需要注意的是,即使对象是NSArray
或NSDictionary
,他们存储的类型也应该是以上范围包括的。
存/读不同类型数据
比如存/读一个整数、字符串和一张图片:
###存
1 2 3 4 5 6 7 8 9 | NSUserDefaults *defaults = [ NSUserDefaults standardUserDefaults]; [defaults setObject:@”jack“ forKey:@ "firstName" ]; [defaults setInteger:10 forKey:@ "Age" ]; UIImage *image =[UIImage imageNamed:@ "somename" ]; NSData *imageData = UIImageJPEGRepresentation(image, 100); //把image归档为NSData [defaults setObject:imageData forKey:@ "image" ]; [defaults synchronize]; |
其中,方法synchronise
是为了强制存储,其实并非必要,因为这个方法会在系统中默认调用,但是你确认需要马上就存储,这样做是可行的。
###读
1 2 3 4 5 6 | NSUserDefaults *defaults = [ NSUserDefaults standardUserDefaults]; NSString *firstName = [defaults objectForKey:@ "firstName" ] NSInteger age = [defaults integerForKey:@ "Age" ]; NSData *imageData = [defaults dataForKey:@ "image" ]; UIImage *image = [UIImage imageWithData:imageData]; |
我们通过为三个数据设置key
的方式把NSInteger
、NSString
和UIImage
三种数据存储下来,其中图片是通过归档为NSData
的方式进行存储的,除此之外,还可以被转为NSNumber
或NSString
类型。顺便提一句,这里NSInteger
没有星号,因为NSInteger
根据系统是64位还是32位来判断自身是long
还是int
类型,并且它也不是一个标准Objective-C对象。
简便方法存取不同类型数据
由上边的例子可以看到一个方法-setInteger:
,这跟常用的-setObject:
相比设置类型更明确。其实,NSUserDefaults
提供了若干简便方法可以存储某些常用类型的值,例如:
1 2 3 4 5 | - setBool:forKey: - setFloat:forKey: - setInteger:forKey: - setDouble:forKey: - setURL:forKey: |
这将使某些值的设置更简单。
NSUserDefaults域
考虑这么一种情况:
BOOL showTutorialOnLaunch = [[NSUserDefaults standardUserDefaults] boolForKey:@"ShowTutorial"];
这种情况下,当key值@“ShowTutorial”
已设置后会运行正确。但如果默认数据库没有这个key的默认值时,将会返回NO
,这或许就不一定是你需要的值了,因为无法区分NO
和no value
,前一段所提到的简便方法大多有这种问题。
解决方式:使用registerDefaults:
方法
首先创建一个包含用户偏好设置信息的DefaultPreferences.plist
文件,添加到target
中。在运行时,app就可以加载这个文件并且把内容传到registerDefaults :
1 2 3 4 | NSURL *defaultPrefsFile = [[ NSBundle mainBundle] URLForResource:@ "DefaultPreferences" withExtension:@ "plist" ]; NSDictionary *defaultPrefs = [ NSDictionary dictionaryWithContentsOfURL:defaultPrefsFile]; [[ NSUserDefaults standardUserDefaults] registerDefaults:defaultPrefs]; |
注意需要在每次启动app并且没有在user defaules中读取数据的时候调用以上方法,因为registerDefaults:
不能把这些默认数据存储到硬盘上,所以application:didFinishLaunchingWithOptions
是最合适的地方。
这样做的原因是:默认情况下,应用域是空的,没见键也没有值。当应用第一次设置某项用户偏好设置的值时,相应的值会通过指定的键加入应用域。当通过NSUserDefaults
获取某项用户偏好设置的值时,NSUserDefaults
会先在应用域中查找,如果找到了值,NSUserDefaults
就会返回这个值。如果没有找到,NSUserDefaults
就会在注册域中查找并返回默认值。
域
user defaults数据库中其实是由多个层级的域组成的,当你读取一个键值的数据时,NSUserDefaults
从上到下透过域的层级寻找正确的值,不同的域有不同的功能,有些域是可持久的,有些域则不行。
- 应用域(application domain)是最重要的域,它存储着你app通过
NSUserDefaults set...forKey
添加的设置。 - 注册域(registration domain)仅有较低的优先权,只有在应用域没有找到值时才从注册域去寻找。
- 全局域(global domain)则存储着系统的设置
- 语言域(language-specific domains)则包括地区、日期等
- 参数域( argument domain)有最高优先权
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· AI与.NET技术实操系列:向量存储与相似性搜索在 .NET 中的实现
· 基于Microsoft.Extensions.AI核心库实现RAG应用
· Linux系列:如何用heaptrack跟踪.NET程序的非托管内存泄露
· 开发者必知的日志记录最佳实践
· SQL Server 2025 AI相关能力初探
· winform 绘制太阳,地球,月球 运作规律
· AI与.NET技术实操系列(五):向量存储与相似性搜索在 .NET 中的实现
· 超详细:普通电脑也行Windows部署deepseek R1训练数据并当服务器共享给他人
· 【硬核科普】Trae如何「偷看」你的代码?零基础破解AI编程运行原理
· 上周热点回顾(3.3-3.9)