大家好，我是K哥。一名独立开发者，同时也是Swift开发框架【Aquarius】的作者，悦记和爱寻车app的开发者。
Aquarius开发框架旨在帮助独立开发者和中小型团队，完成iOS App的快速实现与迭代。使用框架开发将给你带来简单、高效、易维护的编程体验。
本文将详细介绍 AUserDefaults 的使用方式，帮助开发者更高效地进行本地数据存储
核心功能说明
AUserDefaults 是对系统 UserDefaults 的封装，提供更简洁的 API 接口。支持三种核心操作：
- 设置值：使用
forKey+setValue组合 - 获取值：直接调用类型转换方法（如 getStringValue）
- 分组存储：通过 appGroups 参数实现多应用数据共享
使用方式
初始化单例
// 使用默认分组let userDefaults = AUserDefaults.shared// 自定义分组（适用于多应用共享数据）AUserDefaults.shared(appGroups: "group.com.example.shared")
设置数据
// 设置整数userDefaults.forKey("userAge")userDefaults.setValue(25)// 设置字符串userDefaults.forKey("userName")userDefaults.setValue("张三")
获取数据
// 获取基础类型let age = userDefaults.getIntValue("userAge") // 返回 Intlet name = userDefaults.getStringValue("userName") // 返回 String// 获取复杂类型if let savedArray = userDefaults.getArrayValue("history") as? [String] {print(savedArray)}
注意事项
- 类型安全：类型转换方法（如 getBoolValue）若数据类型不匹配会直接崩溃
- 分组设置：appGroups 参数需在应用注册时预先配置
- 数据持久化：修改后需主动调用
userDefaults.synchronize()确保数据写入
总结
AUserDefaults 通过封装简化了本地存储操作，特别适合：
- 需要频繁设置/获取基础类型数据的场景
- 跨应用数据共享需求
- 需要类型安全的开发场景
立即体验Aquarius：
第一步：探索资源
- ⭐ Star & Fork 框架源码： GitHub - JZXStudio/Aquarius - 支持项目发展
- ⭐ Star & Fork 框架文档： ZRead - JZXStudio/Aquarius - 项目介绍文档，深入了解框架
- ⭐ Star & Fork 悦记源码： GitHub - JZXStudio/yuenote - 完整案例，深入了解框架使用方式
第二步：体验效果
- 📱 下载示例APP： 悦记 | 爱寻车 - 感受真实项目中的流畅体验
第三步：沟通交流
- 💬 提交Issue： GitHub Issues - 反馈问题或建议
- 💌 联系与反馈： studio_jzx@163.com - 直接交流开发心得