Datastore API SDKs

The Datastore API lets you effortlessly sync all of your app's structured data such as contacts, to-do items, and game state. It enables your app to sync data quickly, manage conflicting changes, and even work offline.

Before building an app using the Datastore API, you'll need to create an app on the App Console.

iOS SDK

Xcode with the iOS development kit is required to build an iOS app using the Datastore API. The Datastore API requires iOS 5.0 or later.

Adding Dropbox.framework to your project

Once you've downloaded the Datastore API iOS SDK, you'll need to add all the necessary frameworks to your project.

  1. Open your project in Xcode.
  2. Navigate to where you downloaded the SDK and drag the Dropbox.framework folder into your project in Xcode.
  3. Make sure Copy items into destination group's folder is selected.
  4. Press the Finish button.
  5. Ensure that you have CFNetwork.framework, Security.framework, SystemConfiguration.framework, QuartzCore.framework, and libc++.dylib added to your project. To do this, select your project file in the file explorer, select your target, and select the Build Phases sub-tab. Under Link Binary with Libraries, press the + button, select CFNetwork.framework, and press Add. Repeat for Security.framework, SystemConfiguration.framework, QuartzCore.framework, and libc++.dylib.

Creating a URL scheme

The SDK coordinates with the Dropbox app (if it's installed) to simplify the auth process. But in order to smoothly hand the user back to your app, you need to add a unique URL scheme that Dropbox can call. You'll need to configure your project to add one:

  1. Click on your project in the Project Navigator, choose the Info tab, expand the URL Types section at the bottom, and finally, press the + button.
  2. In the URL Schemes enter db-APP_KEY (replacing APP_KEY with the key generated when you created your app).

Example apps

If you want to see the Datastore API in action, check out the Examples directory in the SDK bundle. There you can find a simple task tracking app that uses the Datastore API to save tasks to Dropbox. This app will also sync tasks with the tasks example included in the SDKs for other platforms.

More info