Question 1

Should I use PersistentStorageSerializable or Swift's Codable for saving app settings?

Accepted Answer

PersistentStorageSerializable simplifies automatic mapping without manual Codable conformance, but Codable is built-in, type-safe, and better supported in Swift 4+. Choose PersistentStorageSerializable if you need backward compatibility with legacy keys or prefer reflection-based automation over Codable's explicit coding.

Question 2

How do I store a custom Swift object with PersistentStorageSerializable?

Accepted Answer

You must archive the custom object to Data first, since the library only supports property list types directly. Use NSKeyedArchiver or a similar method to convert your object to Data, then store it as a property, as mentioned for URL types in Plist storage.

Question 3

Is PersistentStorageSerializable thread-safe for concurrent access?

Accepted Answer

No, the library doesn't guarantee thread-safety for storage operations. UserDefaults and file I/O should be synchronized manually in multithreaded environments to avoid data corruption or race conditions.

Question 4

Can I use PersistentStorageSerializable with SwiftUI?

Accepted Answer

Yes, but you'll need to integrate it with SwiftUI's state management, such as using @ObservableObject or @State to update the UI when persisted data changes, as the library only handles persistence, not reactive updates.

Question 5

How to handle schema migrations when adding new properties?

Accepted Answer

The library doesn't handle migrations automatically. Use the key mapping feature to map new properties to defaults or manage initial values in the init(from:) method to ensure backward compatibility when loading from existing storage.

Question 6

What's the performance impact of using reflection in this library?

Accepted Answer

Reflection is slower than direct property access, so for large objects or frequent persist() calls, there may be noticeable overhead. Profile your app to assess if the convenience outweighs the performance cost for your use case.

PersistentStorageSerializable

What is PersistentStorageSerializable?

Overview

Use Cases

Best For

Related Projects

Found a gem we're missing?

Not Ideal For

Pros & Cons

Pros

Cons

Frequently Asked Questions