# forcedotcom/salesforcemobilesdk-android architecture

> Architecture diagram of the GitHub repository forcedotcom/salesforcemobilesdk-android, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/forcedotcom/salesforcemobilesdk-android
- Repository: https://github.com/forcedotcom/salesforcemobilesdk-android

## Overview

Salesforce Mobile SDK for Android supplies reusable native and hybrid-app services. The primary workflow is an app initiating login, OAuth establishing a session and account, then REST or MobileSync operations exchanging Salesforce data with the app’s local SmartStore. The graph also preserves documented analytics, push, and Cordova capabilities. Relationship evidence is limited to the README and the shown excerpts plus SOURCE INDEX references; unsampled implementation links are omitted where not established.

Main entry points: [`libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt`](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt) (Sync Manager), [`libs/SalesforceSDK/src/com/salesforce/androidsdk/accounts/UserAccountManager.java`](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/accounts/UserAccountManager.java) (User Accounts), [`libs/SalesforceSDK/src/com/salesforce/androidsdk/rest/RestClient.java`](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/rest/RestClient.java) (REST Client), [`libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/SmartStore.java`](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/SmartStore.java) (SmartStore)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["SDK Core"]
  node_login["Login UI<br/>[LoginActivity.kt]"]
  node_oauth["OAuth Auth<br/>[OAuth2.java]"]
  node_authservice["Auth Service"]
  node_accounts["User Accounts"]
  node_sdkmanager["SDK Manager"]
  node_rest["REST Client<br/>[RestClient.java]"]
end

subgraph group_data["Data and Sync"]
  node_syncmanager["Sync Manager<br/>[SyncManager.kt]"]
  node_synctargets["Sync Targets<br/>[SyncDownTarget.kt]"]
  node_syncstate["Sync State<br/>[SyncState.kt]"]
  node_syncsdk["MobileSync Manager"]
  node_storemanager["Store Manager"]
  node_smartstore[("SmartStore<br/>[SmartStore.java]")]
  node_query["Query Builder<br/>[QuerySpec.java]"]
end

subgraph group_hybrid["Hybrid Runtime"]
  node_hybridmanager["Hybrid Manager"]
  node_webview["WebView Engine"]
  node_plugins["Cordova Plugins"]
end

subgraph group_services["Platform Services"]
  node_analytics[("Analytics")]
  node_push["Push Service<br/>[PushService.kt]"]
  node_security["Device Security"]
end

node_app(("Android App"))
node_cloud(("Salesforce Cloud"))

node_app -->|"starts login"| node_login
node_login -->|"authenticates with"| node_oauth
node_authservice -->|"requests tokens"| node_oauth
node_authservice -->|"builds account"| node_accounts
node_app -->|"manages accounts"| node_accounts
node_accounts -->|"creates client"| node_rest
node_rest -->|"sends REST requests"| node_cloud
node_app -->|"initializes sync"| node_syncsdk
node_syncsdk -->|"creates sync manager"| node_syncmanager
node_syncmanager -->|"dispatches targets"| node_synctargets
node_syncmanager -->|"creates sync state"| node_syncstate
node_syncmanager -.->|"syncs local data"| node_smartstore
node_syncmanager -->|"uses REST"| node_rest
node_storemanager -->|"opens stores"| node_smartstore
node_query -->|"queries soups"| node_smartstore
node_app -->|"uses local storage"| node_storemanager
node_app -->|"initializes hybrid"| node_hybridmanager
node_hybridmanager -->|"hosts web app"| node_webview
node_app -->|"uses Cordova bridge"| node_plugins
node_app -->|"tracks events"| node_analytics
node_app -->|"receives notifications"| node_push
node_app -->|"uses secure storage"| node_security

click node_login "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/ui/LoginActivity.kt"
click node_oauth "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/auth/OAuth2.java"
click node_authservice "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/auth/AuthenticatorService.java"
click node_accounts "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/accounts/UserAccountManager.java"
click node_sdkmanager "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/app/SalesforceSDKManager.kt"
click node_rest "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/rest/RestClient.java"
click node_syncmanager "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt"
click node_synctargets "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/target/SyncDownTarget.kt"
click node_syncstate "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/util/SyncState.kt"
click node_syncsdk "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/app/MobileSyncSDKManager.java"
click node_storemanager "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SmartStore/src/com/salesforce/androidsdk/smartstore/app/SmartStoreSDKManager.java"
click node_smartstore "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/SmartStore.java"
click node_query "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/QuerySpec.java"
click node_hybridmanager "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/app/SalesforceHybridSDKManager.java"
click node_webview "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/ui/SalesforceWebViewEngine.java"
click node_plugins "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/plugin/MobileSyncPlugin.java"
click node_analytics "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceAnalytics/src/com/salesforce/androidsdk/analytics/store/EventStoreManager.java"
click node_push "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/push/PushService.kt"
click node_security "https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/security/KeyStoreWrapper.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_login,node_oauth,node_authservice,node_accounts,node_sdkmanager,node_rest toneBlue
class node_syncmanager,node_synctargets,node_syncstate,node_syncsdk,node_storemanager,node_smartstore,node_query toneAmber
class node_hybridmanager,node_webview,node_plugins toneMint
class node_analytics,node_push,node_security toneRose
class node_app,node_cloud toneIndigo
```

## Components

### SDK Core

- [Login UI](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/ui/LoginActivity.kt): `libs/SalesforceSDK/src/com/salesforce/androidsdk/ui/LoginActivity.kt`
- [OAuth Auth](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/auth/OAuth2.java): `libs/SalesforceSDK/src/com/salesforce/androidsdk/auth/OAuth2.java`
- [Auth Service](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/auth/AuthenticatorService.java): `libs/SalesforceSDK/src/com/salesforce/androidsdk/auth/AuthenticatorService.java`
- [User Accounts](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/accounts/UserAccountManager.java): `libs/SalesforceSDK/src/com/salesforce/androidsdk/accounts/UserAccountManager.java`
- [SDK Manager](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/app/SalesforceSDKManager.kt): `libs/SalesforceSDK/src/com/salesforce/androidsdk/app/SalesforceSDKManager.kt`
- [REST Client](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/rest/RestClient.java): `libs/SalesforceSDK/src/com/salesforce/androidsdk/rest/RestClient.java`

### Data and Sync

- [Sync Manager](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt): `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt`
- [Sync Targets](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/target/SyncDownTarget.kt): `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/target/SyncDownTarget.kt`
- [Sync State](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/util/SyncState.kt): `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/util/SyncState.kt`
- [MobileSync Manager](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/app/MobileSyncSDKManager.java): `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/app/MobileSyncSDKManager.java`
- [Store Manager](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SmartStore/src/com/salesforce/androidsdk/smartstore/app/SmartStoreSDKManager.java): `libs/SmartStore/src/com/salesforce/androidsdk/smartstore/app/SmartStoreSDKManager.java`
- [SmartStore](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/SmartStore.java): `libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/SmartStore.java`
- [Query Builder](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/QuerySpec.java): `libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/QuerySpec.java`

### Hybrid Runtime

- [Hybrid Manager](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/app/SalesforceHybridSDKManager.java): `libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/app/SalesforceHybridSDKManager.java`
- [WebView Engine](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/ui/SalesforceWebViewEngine.java): `libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/ui/SalesforceWebViewEngine.java`
- [Cordova Plugins](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/plugin/MobileSyncPlugin.java): `libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/plugin/MobileSyncPlugin.java`

### Platform Services

- [Analytics](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceAnalytics/src/com/salesforce/androidsdk/analytics/store/EventStoreManager.java): `libs/SalesforceAnalytics/src/com/salesforce/androidsdk/analytics/store/EventStoreManager.java`
- [Push Service](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/push/PushService.kt): `libs/SalesforceSDK/src/com/salesforce/androidsdk/push/PushService.kt`
- [Device Security](https://github.com/forcedotcom/salesforcemobilesdk-android/blob/dev/libs/SalesforceSDK/src/com/salesforce/androidsdk/security/KeyStoreWrapper.java): `libs/SalesforceSDK/src/com/salesforce/androidsdk/security/KeyStoreWrapper.java`

### Other components

- **Android App**
- **Salesforce Cloud**

## Connections

- Android App → Login UI: starts login (evidence: `README.md`)
- Login UI → OAuth Auth: authenticates with (evidence: `README.md`)
- Auth Service → OAuth Auth: requests tokens (evidence: `libs/SalesforceSDK/src/com/salesforce/androidsdk/auth/AuthenticatorService.java`)
- Auth Service → User Accounts: builds account (evidence: `libs/SalesforceSDK/src/com/salesforce/androidsdk/auth/AuthenticatorService.java`)
- Android App → User Accounts: manages accounts (evidence: `README.md`)
- User Accounts → REST Client: creates client (evidence: `libs/SalesforceSDK/src/com/salesforce/androidsdk/accounts/UserAccountManager.java`)
- REST Client → Salesforce Cloud: sends REST requests (evidence: `README.md`)
- Android App → MobileSync Manager: initializes sync (evidence: `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/app/MobileSyncSDKManager.java`)
- MobileSync Manager → Sync Manager: creates sync manager (evidence: `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/app/MobileSyncSDKManager.java`)
- Sync Manager → Sync Targets: dispatches targets (evidence: `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt`)
- Sync Manager → Sync State: creates sync state (evidence: `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt`)
- Sync Manager → SmartStore: syncs local data (evidence: `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt`)
- Sync Manager → REST Client: uses REST (evidence: `libs/MobileSync/src/com/salesforce/androidsdk/mobilesync/manager/SyncManager.kt`)
- Store Manager → SmartStore: opens stores (evidence: `libs/SmartStore/src/com/salesforce/androidsdk/smartstore/app/SmartStoreSDKManager.java`)
- Query Builder → SmartStore: queries soups (evidence: `libs/SmartStore/src/com/salesforce/androidsdk/smartstore/store/QuerySpec.java`)
- Android App → Store Manager: uses local storage (evidence: `README.md`)
- Android App → Hybrid Manager: initializes hybrid (evidence: `README.md`)
- Hybrid Manager → WebView Engine: hosts web app (evidence: `libs/SalesforceHybrid/src/com/salesforce/androidsdk/phonegap/app/SalesforceHybridSDKManager.java`)
- Android App → Cordova Plugins: uses Cordova bridge (evidence: `README.md`)
- Android App → Analytics: tracks events (evidence: `README.md`)
- Android App → Push Service: receives notifications (evidence: `README.md`)
- Android App → Device Security: uses secure storage (evidence: `README.md`)
