6.AUserDefaults 使用指南

大家好，我是 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") // 返回 Int
let 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 - 直接交流开发心得