Extract and open the sample app
Drag and drop all the files and folders within the SynCloud App Folder and subfolders into your app.
Add the following frameworks to your project
Go to http://aws.amazon.com/simpledb/ and join Amazon Web Services.
Note that this is a paid service where you pay based on usage. The billing, ie "How much will this cost me" is very difficult to understand, however in my own experience, I have used this API in my app Inventory Tracker and have yet to receive a single bill from Amazon. I would consider these costs insignificant unless you are going to be using this on a massive scale.
In your project, open Syncloud_config.m and add the app ID and Secret Key from SimpleDB into your app.
Sign up at SynCloudAPI.com and create a new App. You will be given a new API ID and Key for this new app. A new registration comes with a free trial period.
Note registration to use this API does come at a monthly cost, but keep in mind that you will be able to charge users for using your service.
In your project, open Syncloud_config.m and add the app ID and Secret Key from SynCloud app.
Open Syncloud_config.m and configure a few app Sync variables. A description of each can be found in the .m file
Any tables that you wish to sync must have the following fields added to their entity definition.
In your AppDelegate, ApplicationDidLaunch method, you should setup the SyncService
Note that in your AppDelegate, where the ManagedObjectContext is created, it must be created with the NSMainQueueConcurrencyType concurrancy type
Add a button in your project and when pressed, pushed the supplied SyncSettingsController. This will handle account creation, subscriptions, enabling / disabling, ect.
For your synced core data objects, you should call
Note that these methods are contained in a category file so you must add an import
There are many other ways you can use the API. See the documentation and the example code for various uses. Note this example code is still being expanded.
You may want to add a refresh call to your view controllers to refresh its data after a full sync has completed. Note that this is done automatically if you are using NSFetchedResultsControllers
You can do this by Implementing the SyncServiceDelegate protocol, then call
in your viewWillAppear: method
Implement the protocol by adding a
This software may NOT be used in any free or commercial applications without the express consent of iParty! Mobile or Logan Sease. This software and/or its source code should not be distributed under any circumstances. Logan Sease and iParty! Mobile maintain all intellectual property rights to original source code contained with in this project and to the processes performed by it, including and especially the data syncing algorithm used by this software. The use of this software is done free of any warantee or of any liablities from Logan Sease or iParty! Mobile. We make absolutely no guarantees about the functionality contained or offered within. By using this software within your project, you hereby agree to the terms of this license.