DreierF/dropbox-sdk-java

A Java library for the Dropbox Core API.

Inofficial Android client library for the Dropbox API.

An android library to access Dropbox's HTTP-based Core API v2. This SDK also supports the older Core API v1, but that support will be removed at some point.

This is a fork of the official Dropbox Java API, with the aim to reduce the method count of the library. Currently it has been shrinked from 11,176 to 5,789 methods (without ProGuard).

With ProGuard and optimization turned on there is no difference in the method count to the official library. But for my project the debug build hit the 65k limit, that's why I came up with this workaround.

This has been removed:

• Team features
• Sharing features
• Google App Engine support
• OkHttp support (OkHttp3 support is still included)
• OSGi

Further changes:

• Adopted to the standard library folder layout
• Included consumer proguard file
• Changed language level to Java 7

License: MIT

Javadoc.

Setup

Then edit your project's "build.gradle" and add the following:

repositories {
   flatDir {
       dirs 'libs'
   }
}

dependencies {
    compile(name: 'dropbox-android-core-2-1-2', ext: 'aar')
    compile 'com.fasterxml.jackson.core:jackson-core:2.8.5'
    compile 'javax.servlet:servlet-api:2.5'
    compile 'com.squareup.okhttp3:okhttp:3.4.2'
}

Download the Android library AAR directly from the latest release page and place it into your libs folder. Note that the distribution artifacts on the releases pages do not contain optional dependencies.

Get a Dropbox API key

You need a Dropbox API key to make API requests.

• Go to: https://www.dropbox.com/developers/apps
• If you've already registered an app, click on the "Options" link to see the app's API key and secret.
• Otherwise, click "Create an app" to register an app. Choose "Dropbox API app", then "Files and datastores", then "Yes" or "No" depending on your needs.

Save the API key to a JSON file called, say, "test.app":

{
  "key": "Your Dropbox API app key",
  "secret": "Your Dropbox API app secret"
}

Using the Dropbox API

Before your app can access a Dropbox user's files, the user must authorize your application using OAuth 2. Successfully completing this authorization flow gives you an access token for the user's Dropbox account, which grants you the ability to make Dropbox API calls to access their files. Example for an Android app: Android example

Once you have an access token, create a DbxClientV2 and start making API calls.

You only need to perform the authorization process once per user. Once you have an access token for a user, save it somewhere persistent, like in a database. The next time that user visits your app's, you can skip the authorization process and go straight to creating a DbxClientV2 and making API calls.

Building from source

git clone https://github.com/dreierf/dropbox-sdk-java.git
cd dropbox-sdk-java
./update-submodules    # also do this after every "git checkout"
./gradlew build

The output will be in "build/".

Running the examples

1. Follow the instructions in the "Build from source" section above.
2. Save your Dropbox API key in a file called "test.app". See: Get a Dropbox API key, above.
3. Compile with ./gradlew :sample:assembleRelease

Running the integration tests

1. Run through the authorize example above to get a "test.auth" file.
2. ./gradlew -Pcom.dropbox.test.authInfoFile=<path-to-test.auth> integrationTest

To run individual tests, use the --tests gradle test filter:

./gradlew -Pcom.dropbox.test.authInfoFile=<path-to-test.auth> integrationTest --tests '*.DbxClientV1IT.testAccountInfo'