Changelog

The changelog for Foil. Also see the releases on GitHub.

NEXT

• TBA

5.0.0

This release closes the 5.0.0 milestone.

Breaking

• The UserDefaultsSerializable protocol has changed. Previously, it declared the initializer init(storedValue:). It is now failable: init?(storedValue:). This change was necessary to accommodate Codable types (see below). (#92, @jessesquires)

• Both property wrappers have been renamed. @WrappedDefault is now @FoilDefaultStorage and @WrappedDefaultOptional is now @FoilDefaultStorageOptional. To migrate, you can simply find-and-replace these names. Nothing else has changed. (#73, #94, @jessesquires)

New

• Support for Codable types. (Please don't abuse this. See the docs.) (#72, #92, @jessesquires)

• Added privacy manifest for iOS 17. (@jessesquires)

Changed

• Upgrade to Xcode 15
• Upgrade to Swift 5.9

4.0.1

This release closes the 4.0.1 milestone.

Fixed

• WrappedDefaultOptional no longer crashes when the type stored in UserDefaults does not match the type being requested, nil is now returned instead. (#70, @ejensen)

4.0.0

This release closes the 4.0.0 milestone.

New

• The publisher projected by the property wrapper now sends values when user defaults changes from anywhere. Previously, only when using the property wrapper's setter would the projected publisher send a new value. (#61, @nolanw)

Breaking

• Due to #61 (see above), there are some (potentially) breaking changes with key names. If any of your keys are named like the following examples and you need to observe changes, you will need to migrate your key names.
  • Key names starting with an @ character do not notify observers on updates.
    • Example: @my-key-name
  • Key names containing a . character anywhere in the name do not notify observers on updates. (This is a side-effect of KeyPaths which include periods.)
    • Example: com.myApp.my-key-name

Changed

• Upgrade to Xcode 14
• Upgrade to Swift 5.7

3.0.0

This release closes the 3.0.0 milestone.

New

• Refined the Combine API for responding to changes. This removes the need for the .publisher(for:) KVO API call. See the updated documentation for additional details. (#38, @JonnyBeeGod)

Breaking

• Updated minimum deployment targets for all platforms
  • iOS 13.0
  • tvOS 13.0
  • watchOS 6.0
  • macOS 11.0

2.0.0

This release closes the 2.0.0 milestone.

Breaking

• Implemented more succinct implicit initialization. See example below. (#36, @jessesquires)

// OLD
@WrappedDefault(keyName: "flag", defaultValue: true)
var flag: Bool

// NEW
@WrappedDefault(key: "flag")
var flag = true

Changed

• Various project infra updates: Xcode 13, Swift 5.5, etc. (#34, @jessesquires)

1.2.0

This release closes the 1.2.0 milestone.

• Fix deployment target inconsistencies between CocoaPods and SwiftPM. (#18, #19, @kambala-decapitator, @jessesquires)

• Lower deployment targets to support iOS/tvOS 9.0 and above. (#16, #19, @kambala-decapitator, @jessesquires)

1.1.0

This release closes the 1.1.0 milestone.

• Added support for custom RawRepresentable types (#10, @basememara)

• Add default support for UInt (#3, #12, @jessesquires)

• Updated documentation with examples for observing changes in defaults (#4, #5, @basememara)

• Updated documentation with examples for observing changes in defaults when using Foil (#4, #5, @basememara)

• Minor documentation and internal library improvements (@jessesquires)

1.0.0

Initial release. 🎉

Documentation available here.