大家好，我是 K 哥。一名独立开发者，同时也是 Swift 开发框架【 Aquarius】的作者， 悦记和 爱寻车 app 的开发者。

Aquarius 开发框架旨在帮助独立开发者和中小型团队，完成 iOS App 的快速实现与迭代。使用框架开发将给你带来简单、高效、易维护的编程体验。

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

核心功能说明

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

1. 设置值：使用  forKey +  setValue 组合
2. 获取值：直接调用类型转换方法（如 getStringValue）
3. 分组存储：通过 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)
}

注意事项

1. 类型安全：类型转换方法（如 getBoolValue）若数据类型不匹配会直接崩溃
2. 分组设置：appGroups 参数需在应用注册时预先配置
3. 数据持久化：修改后需主动调用  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 - 直接交流开发心得