sunshinejr/SwiftyUserDefaults
SwiftyUserDefaults
SwiftyUserDefaults 是一个类型安全的 Swift 接口，用于使用 NSUserDefaults 存储系统读写用户偏好设置。它提供了一个静态类型的偏好存储，利用泛型和默认值来防止应用设置中的运行时类型不匹配。
该库包括一个自定义类型序列化器，用于将复杂对象和数组转换为兼容的存储格式；以及一个观察者，使用键值观察 (KVO) 在偏好值更改时触发逻辑。它还具有一个应用组偏好管理器，利用套件名称在应用和扩展之间交换用户偏好。
该项目涵盖了更广泛的功能领域，包括偏好生命周期管理、减少存储读取的内存值缓存，以及将应用启动参数读取为静态类型配置值的能力。它还提供了用于管理多个隔离键存储和重置偏好存储的工具。
Features
- User Preference Managers - Manages reading and writing application settings through a statically-typed interface to ensure type safety.
- Standard Library Wrappers - Provides a type-safe Swift wrapper around the NSUserDefaults standard library to improve ergonomics and safety.
- User Preference Management - Provides utilities to check for key existence and remove individual entries to maintain preference state.
- User Preference Managers - Provides a type-safe interface for storing and retrieving application settings on iOS.
- Type-Safe Configuration Stores - Implements a preference store using generic types and default values to prevent runtime type mismatches in settings.
- Type-Safe Key Interfaces - Maps preference keys to specific Swift types to prevent runtime type mismatches during data retrieval.
- App Group Synchronization - Provides a preference manager that uses suite names to exchange user settings between applications and extensions.
- Storage Key Observation - Ships a monitoring tool that uses key-value observing to trigger logic when specific preference values are updated.
- Custom Type Serializers - Allows specifying how custom types and arrays are transformed when reading from or writing to persistent storage.
- Data Type Serialization - Provides logic for encoding and decoding complex custom types and arrays into persistent storage formats.
- In-Memory Caches - Implements an in-memory cache for retrieved preferences to reduce direct read operations from persistent storage.
- Preference Caches - Stores retrieved preference values in memory to reduce the frequency of direct reads from persistent storage.
- Default Value Fallbacks - Provides fallback values when requested preference keys are absent to ensure non-optional returns.
- Default Value Assignments - Assigns fallback values to keys so that lookups return a non-optional value when no data exists.
- Inter-App Data Sharing - Uses shared suite names to synchronize user preferences and settings between a main application and its extensions.
- App Group Storage - Directs preference operations to specific named containers to share data between applications and extensions.
- Property Change Observers - Tracks updates to stored settings to trigger immediate logic changes within the application.
- Shared Suite Access - Enables redirecting preference read and write operations to a shared container for use between applications and extensions.
- State Change Observers - Uses key-value observing to trigger registered callbacks when stored preference values are updated.
- Data Persistence - Cleaner syntax for UserDefaults.
- Database Libraries - Statically-typed interface for UserDefaults.
