Skip to content
Trimble Identity

trimble-id-android

Maven Central

Trimble Identity Android OAuth Library

Table of Contents

Section titled “Table of Contents”

Features

Section titled “Features”
  • 🔐 OAuth 2.0 Authentication - Secure authentication with Trimble Identity
  • 👥 Multi-User Support - Manage multiple user accounts (Preview)
  • 📱 Offline Authentication - Work offline with cached credentials (Preview)
  • 🔄 Token Management - Automatic token refresh and management
  • ⚡ Modern API - Kotlin-first with coroutines support
  • 📖 Comprehensive Documentation - Complete guides and API reference

Versions

Section titled “Versions”

We provide two versions of the Trimble Identity Android SDK:

🟢 Stable Version (Recommended for Production)

Section titled “🟢 Stable Version (Recommended for Production)”
  • Version: 1.0.1
  • Repository: Maven Central
  • Status: Production-ready, stable API
  • Use Case: Stable integrations

🟡 Preview Version (Beta)

Section titled “🟡 Preview Version (Beta)”
  • Version: 1.2.0-alpha-20250620
  • Repository: Trimble Artifactory
  • Status: Beta release with new features
  • Features: Offline Authentication, Multi-User Support
  • Use Case: Early adoption and feature testing

Installation

Section titled “Installation”

Stable Version

Section titled “Stable Version”

Gradle

dependencies {
    implementation 'com.trimble:trimble-id-android:1.0.1'
}

Maven

<dependency>
    <groupId>com.trimble</groupId>
    <artifactId>trimble-id-android</artifactId>
    <version>1.0.1</version>
</dependency>

Preview Version (Beta)

Section titled “Preview Version (Beta)”

First, add the Trimble Artifactory repository:

Gradle

repositories {
    maven {
        url 'https://artifactory.trimble.tools/artifactory/trimblecloudplatform-engagement-maven/'
    }
}


dependencies {
    implementation 'com.trimble:trimble-id-android:1.2.0-alpha-20250620'
}

Maven

<dependencies>
    <dependency>
        <groupId>com.trimble</groupId>
        <artifactId>trimble-id-android</artifactId>
        <version>1.2.0-alpha-20250620</version>
    </dependency>
</dependencies>

Configure Trimble Identity

Section titled “Configure Trimble Identity”

1. Register Your Application

Section titled “1. Register Your Application”

Create a new application in the Trimble Developer Console:

  1. Navigate to Applications in the left pane
  2. Click + NEW APPLICATION
  3. Fill in your application details:
    • Name: Your application name
    • Description: Brief description of your app
  4. Configure OAuth settings:
    • Grant Type: Authorization Code Grant
    • Enable: Use Refresh tokens
  5. Set your callback URLs:
    • Callback URL: Where users return after login
    • Logout URL: Where users go after logout
  6. Click Create Application

For more information, see Authentication documentation.

2. Configure Scopes

Section titled “2. Configure Scopes”

Scopes determine the aud claim in access tokens and are mandatory. Use your application name registered in the Trimble Developer Console.

Format: {uuid}-{application-name} Example: 12345678-1234-1234-1234-123456789012-myapp

Documentation

Section titled “Documentation”

Stable Version (1.0.1)

Section titled “Stable Version (1.0.1)”

Preview Version (1.2.0-alpha-20250620)

Section titled “Preview Version (1.2.0-alpha-20250620)”

Reporting Issues

Section titled “Reporting Issues”

Found a bug or have a feature request? Please open an issue

Support

Section titled “Support”