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 - 直接交流开发心得

---