How dropbox/dropbox-sdk-java works
Project type and purpose
• This is an open-source, multi-module Java/Android SDK (Dropbox Core SDK for Java). It provides a reusable library for calling Dropbox’s HTTP Core API (v1 & v2), an Android wrapper in Kotlin/Java, and a Stone-based code generator plugin. It also ships with sample applications demonstrating how to integrate the SDK.
File structure
• Top-level modules (subprojects) in settings.gradle:
• core: the Java library module containing the HTTP client, JSON serializers, OAuth flows, and generated API surface.
• android: Android-specific wrapper in Kotlin/Java that depends on core, exposes Auth flows to Android apps.
• stone-java-gradle-plugin: a Gradle plugin that reads Stone specification files and emits generated API source under core/build/generated_stone_source.
• examples: contains sample console, web, Android, and Java applications illustrating usage.
• proguard: a small demo showing ProGuard integration.
• Build scripts (build.gradle, gradlew, gradle.properties) configure multi-module Gradle builds, dependencies, publishing, and test tasks.
• Generated code lives under core/build/generated_stone_source, consumed by core/src/main/java.
• External‐facing artifacts: core JAR, android AAR, plugin JAR.
README for additional insights
• Describes supported Java/Android versions, dependency declarations, tutorial snippets, sample run commands, integration tests.
• Highlights extensibility points: pluggable HTTP requestors (StandardHttpRequestor, OkHttpRequestor, OkHttp3Requestor), JSON serializers, custom SSLSocketFactory/certificate pinning, ProGuard rules.
• Shows AndroidManifest configuration needed for in-app and app-to-app OAuth flows.
Elements
• Clear labels on each module/component (e.g., “core module,” “stone-plugin,” “Android wrapper,” “Dropbox API”)
• Library modules (rectangles)
• Related items (e.g., underline all Gradle subprojects under a “GitHub Repo” boundary).