gumbright / seam Goto Github PK

"Simplicity is the ultimate sophistication."

• Leonardo da Vinci

Seam is a framework built to bridge gaps between CoreData and CloudKit. It almost handles all the CloudKit hassle. All you have to do is use it as a store type for your CoreData store. Local caching and sync is taken care of. It builds and exposes different features to facilitate and give control to the developer where it is demanded and required.

In the table above : Integer16, Integer32, Integer64, Decimal, Float and Boolean are referring to the instance of NSNumber used to represent them in CoreData Models. NSManagedObject refers to a to-one relationship in a CoreData Model.

Note : You must create inverse relationships in your app's CoreData Model or Seam wouldn't be able to translate CoreData Models in to CloudKit Records. Unexpected errors and curroption of data can possibly occur.

Seam keeps the CoreData store in sync with the CloudKit Servers. It let's you know when the sync operation starts and finishes by throwing the following two notifications.

• SMStoreDidStartSyncOperationNotification
• SMStoreDidFinishSyncOperationNotification

In case of any sync conflicts, Seam exposes 4 conflict resolution policies.

• ClientTellsWhichWins

This policy requires you to set syncConflictResolutionBlock block of SMStore. You get both versions of the record as arguments. You do whatever changes you want on the second argument and return it.

• ServerRecordWins

This is the default. It considers the server record as the true record.

• ClientRecordWins

This considers the client record as the true record.

• KeepBoth

This saves both versions of the record.

• Declare a SMStore type property in the class where your CoreData stack resides.

var smStore: SMStore?

• Add a store type of SeamStoreType to your app's NSPersistentStoreCoordinator and assign it to the property created in the previous step.

do 
{
   self.smStore = try coordinator.addPersistentStoreWithType(SeamStoreType, configuration: nil, URL: url, options: nil) as? SMStore
}

• Enable Push Notifications for your app.
• Implement didReceiveRemoteNotification Method in your AppDelegate and call handlePush on the instance of SMStore created earlier.

 func application(application: UIApplication, didReceiveRemoteNotification userInfo: [NSObject : AnyObject]) 
 {
    self.smStore?.handlePush(userInfo: userInfo)
 }

• Enjoy

• SMStoreSyncConflictResolutionPolicyOption

Use SMSyncConflictResolutionPolicy enum to use as a value for this option to specify the desired conflict resolution policy when adding SeamStoreType to your app's NSPersistentStoreCoordinator.

Xcode 7

Swift 2.0

Seam supports only user's CloudKit Private Database at this time. It creates and uses a custom zone to store data and fetch changes from the server.

CloudKit Public Database and here are the two reasons why, straight from the docs.

1. The disadvantage of using the default zone for storing records is that it does not have any special capabilities. You cannot save a group of records to iCloud atomically in the default zone. Similarly, you cannot use a CKFetchRecordChangesOperation object on records in the default zone.

2. You cannot create custom zones in a public database.

Download the demo project. Run it and see the magic as it happens.

CocoaPods is the recommended way of adding Seam to your project.

Add this 'Seam', '~> 0.6' to your pod file.

Seam was created by Nofel Mahmood

Follow Nofel Mahmood on Twitter and GitHub or email him at [email protected]

Seam is available under the MIT license. See the LICENSE file for more info.