Effortlessly sync UserDefaults over iCloud
Zephyr has built in monitoring, allowing it to sync specific keys in the background as they change.
For the latest updates, refer to the Releases tab.
- [x] CocoaPods Support
- [x] Syncs all your UserDefaults (if you wish)
- [x] Syncs only specific keys in UserDefaults
- [x] Background monitoring and synchronization between UserDefaults and NSUbiquitousKeyValueStore
- [x] Detailed Logging
- [x] Documentation at http://sabintsev.com/Zephyr/
| Swift Version | Branch Name | Will Continue to Receive Updates? | ------------- | ------------- | ------------- | 4.1 | master | Yes | 4.1 | swift4.1 | No | 3.2 | swift3.2 | No | 3.1 | swift3.1 | No
pod 'Zephyr' # Swift 4.2 pod 'Zephyr', :git => 'https://github.com/ArtSabintsev/Zephyr.git', :branch => 'swift4.1' # Swift 4.1 pod 'Zephyr', :git => 'https://github.com/ArtSabintsev/Zephyr.git', :branch => 'swift3.2' # Swift 3.2 pod 'Zephyr', :git => 'https://github.com/ArtSabintsev/Zephyr.git', :branch => 'swift3.1' # Swift 3.1
github "ArtSabintsev/Zephyr" // Swift 4.2 github "ArtSabintsev/Zephyr", "swift4.1" // Swift 4.1 github "ArtSabintsev/Zephyr", "swift3.2" // Swift 3.2 github "ArtSabintsev/Zephyr", "swift3.1" // Swift 3.1
Swift Package Manager
.Package(url: "https://github.com/ArtSabintsev/Zephyr.git", majorVersion: 3)
- Download Zephyr
Zephyr.swiftinto your project.
Turn on iCloud Sync in Xcode
In Xcode, open your app's project/workspace file:
- Click on your Project
- Click on one of your Targets
- Click on Capabilities
- Turn on iCloud syncing
- Under Services, make sure to check
- Repeat for all Targets (if necessary)
Integrate Zephyr into your App
Before performing each sync, Zephyr automatically checks to see if the data in UserDefaults or NSUbiquitousKeyValueStore is newer. To make sure there's no overwriting going on in a fresh installation of your app on a new device that's connected to the same iCloud account, make sure that your UserDefaults are registered BEFORE calling any of the Zephyr methods. One way to easily achieve this is by using the UserDefaults Register API.
Sync all UserDefaults
Sync a specific key or keys (Variadic Option)
Zephyr.sync(keys: "MyFirstKey", "MySecondKey", ...)
Sync a specific key or keys (Array Option)
Zephyr.sync(keys: ["MyFirstKey", "MySecondKey"])
Add/Remove Keys for Background Monitoring (Variadic Option)
Zephyr.addKeysToBeMonitored(keys: "MyFirstKey", "MySecondKey", ...) Zephyr.removeKeysFromBeingMonitored(keys: "MyFirstKey", "MySecondKey", ...)
Add/Remove Keys for Background Monitoring (Array Option)
Zephyr.addKeysToBeMonitored(keys: ["MyFirstKey", "MySecondKey"]) Zephyr.removeKeysFromBeingMonitored(keys: ["MyFirstKey", "MySecondKey"])
Toggle Automatic Calling of NSUbiquitousKeyValueStore's Synchronization method
Zephyr.syncUbiquitousKeyValueStoreOnChange = true // Default Zephyr.syncUbiquitousKeyValueStoreOnChange = false // Turns off instantaneous synchronization
Zephyr.debugEnabled = true // Must be called before sync(_:) Zephyr.sync()
Please ignore the Sample App as I did not add any demo code in the Sample App. It's only in this repo to add support for Carthage.
Created and maintained by
Help us keep the lights on
3.2.0 - Sep 17, 2018
As of Zephyr v3.2.0, all future changes on
master will be done in Xcode 10 using Swift 4.2.
For those using Swift v4.1.0, please check out the
swift4.1 branch or version
3.1.2 - both point to the same commit hash.
3.1.2 - Apr 23, 2018
- Minor swift optimizations
- Improved documentation.
3.1.1 - Apr 23, 2018
monitoresKeysare now synchronized. (Thanks to @krzyzanowskim)
3.1.0 - Mar 29, 2018
- Adds the ability to sync non-standard
- Thanks to @albertwujj in #28
- Adds Swift 4.1 Compatibility
3.0.2 - Mar 15, 2018
- Updated Podspec file.
.swift-versionfile, as it's been deprecated.
- Removed watchOS support since there are a few insurmountable issue (and because it seems no one was using or requesting this support).