6.AUserDefaults 使用指南

大家好，我是K哥。一名独立开发者，同时也是Swift开发框架【Aquarius】的作者，悦记和爱寻车app的开发者。
Aquarius开发框架旨在帮助独立开发者和中小型团队，完成iOS App的快速实现与迭代。使用框架开发将给你带来简单、高效、易维护的编程体验。

本文将详细介绍 AUserDefaults 的使用方式，帮助开发者更高效地进行本地数据存储

核心功能说明

AUserDefaults 是对系统 UserDefaults 的封装，提供更简洁的 API 接口。支持三种核心操作：

• 设置值：使用 forKey + setValue 组合
  
• 获取值：直接调用类型转换方法（如 getStringValue）
  
• 分组存储：通过 appGroups 参数实现多应用数据共享
  

使用方式

初始化单例

1. // 使用默认分组
3. let userDefaults = AUserDefaults.shared
5.   
7. // 自定义分组（适用于多应用共享数据）
9. AUserDefaults.shared(appGroups: "group.com.example.shared")

复制代码

设置数据

1. // 设置整数
3. userDefaults.forKey("userAge")
5. userDefaults.setValue(25)
7.   
9. // 设置字符串
11. userDefaults.forKey("userName")
13. userDefaults.setValue("张三")

复制代码

获取数据

1. // 获取基础类型
3. let age = userDefaults.getIntValue("userAge") // 返回 Int
5. let name = userDefaults.getStringValue("userName") // 返回 String
7.   
9. // 获取复杂类型
11. if let savedArray = userDefaults.getArrayValue("history") as? [String] {
13.     print(savedArray)
15. }

复制代码

注意事项

• 类型安全：类型转换方法（如 getBoolValue）若数据类型不匹配会直接崩溃
  
• 分组设置：appGroups 参数需在应用注册时预先配置
  
• 数据持久化：修改后需主动调用 userDefaults.synchronize() 确保数据写入
  

总结

AUserDefaults 通过封装简化了本地存储操作，特别适合：

• 需要频繁设置/获取基础类型数据的场景
  
• 跨应用数据共享需求
  
• 需要类型安全的开发场景
  

立即体验Aquarius：
第一步：探索资源

• ⭐ Star & Fork 框架源码： GitHub - JZXStudio/Aquarius - 支持项目发展
  
• ⭐ Star & Fork 框架文档： ZRead - JZXStudio/Aquarius - 项目介绍文档，深入了解框架
  
• ⭐ Star & Fork 悦记源码： GitHub - JZXStudio/yuenote - 完整案例，深入了解框架使用方式
  

第二步：体验效果
<ul><strong>
来源：程序园用户自行投稿发布，如果侵权，请联系站长删除
免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！