The Dropbox Java SDK allows you to move away from request-by-request error handling by supplying a callback factory to the client. This enables consistent, global handling of two types of errors:

1. General Network Errors: Implement getNetworkErrorCallback to handle errors that occur at the networking layer, such as authentication errors.
2. Route-Specific Errors: Implement one of the getRouteErrorCallback methods to handle errors specific to certain API endpoints or routes.

This pattern is useful for centralizing error logic (like logging or re-authentication flows) that should apply to all requests regardless of the specific endpoint being called.

To use the Dropbox SDK in an Android project, add the core and Android-specific dependencies to your build.gradle file.

Note on Kotlin: The Android SDK is written in Kotlin. If your project does not already include Kotlin, you must add the Kotlin standard library as a dependency to avoid runtime exceptions.

Jettifier Workaround: If you encounter transformation errors with jackson-core or fastdoubleparser while using Jettifier, add the following to your gradle.properties: android.jetifier.ignorelist = jackson-core,fastdoubleparser

dependencies {
    // ...
    implementation 'com.dropbox.core:dropbox-core-sdk:8.0.2'
    implementation 'com.dropbox.core:dropbox-android-sdk:8.0.2'
    // Required if your project doesn't have Kotlin
    implementation "org.jetbrains.kotlin:kotlin-stdlib:2.4.0"
}

The tutorial example demonstrates basic usage of the Dropbox Java SDK. To run the provided example code, you must provide a valid Dropbox access token.

1. Locate Main.java in the example source.
2. Replace the placeholder "<ACCESS TOKEN>" with your actual Dropbox access token.
3. Refer to the official Dropbox online tutorial for instructions on how to generate an access token and complete the setup.

// In Main.java, replace the placeholder with your token:
String accessToken = "<ACCESS TOKEN>";

The provided Android example uses the local source version of the SDK. To use the published version of the SDK in your own Android project instead of the local source, modify your build.gradle file to replace the project dependency with the remote Maven dependency.

Replace: implementation(project(":core"))

With: implementation("com.dropbox.core:dropbox-core-sdk:LATEST_VERSION_GOES_HERE")

// Replace this:
implementation(project(":core"))

// With this:
implementation("com.dropbox.core:dropbox-core-sdk:LATEST_VERSION_GOES_HERE")

To interact with the Dropbox API, you must instantiate a DbxClientV2. This requires a DbxRequestConfig (which includes a client name for identification) and an access token obtained from the Dropbox App Console.

import com.dropbox.core.DbxException;
import com.dropbox.core.DbxRequestConfig;
import com.dropbox.core.v2.DbxClientV2;

public class Main {
    private static final String ACCESS_TOKEN = "<ACCESS TOKEN>";

    public static void main(String args[]) throws DbxException {
        // Create Dropbox client
        DbxRequestConfig config = DbxRequestConfig.newBuilder("dropbox/java-tutorial").build();
        DbxClientV2 client = new DbxClientV2(config, ACCESS_TOKEN);
    }
}

You can add the Dropbox Java SDK to your project using Maven or Gradle.

Note on Java Versions:

• v8.0.0+: Requires Java 21+.
• v7.x: Supports Java 8 through Java 20.

Note on Android:

• Supports Android 8+ (SDK 26+).

### Maven

```xml
<dependency>
    <groupId>com.dropbox.core</groupId>
    <artifactId>dropbox-core-sdk</artifactId>
    <version>8.0.2</version>
</dependency>

Gradle

dependencies {
    // ...
    implementation 'com.dropbox.core:dropbox-core-sdk:8.0.2'
}

As of version 7.0.0, the SDK no longer provides certificate pinning by default and SSLConfig is no longer available. You must provide your own SSLSocketFactory or CertificatePinner using the available requestors.

// Using StandardHttpRequestor
StandardHttpRequestor.Config customConfig = StandardHttpRequestor.Config.DEFAULT_INSTANCE.copy()
        .withSslSocketFactory(mySslSocketFactory)
        .build();
StandardHttpRequestor requestor = new StandardHttpRequestor(customConfig);

// Using OkHttp3Requestor
okhttp3.OkHttpClient httpClient = OkHttp3Requestor.defaultOkHttpClientBuilder()
        .certificatePinner(myCertificatePinner)
        .build();

// Using OkHttpRequestor
OkHttpClient httpClient = OkHttpRequestor.defaultOkHttpClient().clone()
        .setCertificatePinner(myCertificatePinner)
        .build();

To run the Android example application, you must provide your Dropbox App/API Key. This is done by creating a local.properties file within the Android example directory (examples/android/local.properties).

Note: Creating this file is not required to build the app, but it is mandatory if you want to test the authentication flow.

Steps:

1. Ensure your build environment supports at least Android SDK version 21 (Android 5.0 Lollipop).
2. Create examples/android/local.properties with the following content: DROPBOX_APP_KEY=YOUR_KEY_HERE (replace YOUR_KEY_HERE with your actual Dropbox App/API Key).

You can automate this via the terminal from the root of the dropbox-sdk-java repository:

echo "DROPBOX_APP_KEY=YOUR_KEY_HERE" > examples/android/local.properties