# Installation

# Step 1 - Add the SDK repository

Add the Positive User maven repository to your settings.gradle.kts:

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        // your existing repositories
        maven {
            url = uri("https://android-sdk.user.com")
        }
    }
}

# Step 2 - Add the dependency

In your app-level build.gradle.kts:

dependencies {
    implementation("com.user:android-sdk:1.2.14")
}

# Step 3 - Add your Firebase configuration

The SDK uses Firebase Cloud Messaging to deliver push notifications. Add your google-services.json to the app module directory and apply the Google Services plugin.

In your project-level build.gradle.kts:

plugins {
    id("com.google.gms.google-services") version "4.4.0" apply false
}

In your app-level build.gradle.kts:

plugins {
    id("com.google.gms.google-services")
}

# Step 4 - Initialize the SDK

Initialize the SDK in your Application class to keep it available for the full app lifecycle.

Declare your Application class in AndroidManifest.xml:

<application
    android:name=".ExampleApp"
    ...>

Then initialize with your credentials. Your keys are available in Positive User under Settings - App Settings - Advanced - Mobile keys and Settings - Setup & Integrations.

class ExampleApp : Application() {

    override fun onCreate() {
        super.onCreate()

        UserCom.Builder(
            this,
            "YOUR_MOBILE_SDK_KEY",        // 64-character Mobile SDK Key
            "YOUR_INTEGRATIONS_API_KEY",  // App Key from Settings - Setup & Integrations
            "https://your-domain.user.com"
        )
            .trackAllActivities(true)
            .build()
    }
}

public class ExampleApp extends Application {

    @Override
    public void onCreate() {
        super.onCreate();

        new UserCom.Builder(
            this,
            "YOUR_MOBILE_SDK_KEY",
            "YOUR_INTEGRATIONS_API_KEY",
            "https://your-domain.user.com"
        )
            .trackAllActivities(true)
            .build();
    }
}

# Builder options

# What's next

• Contact Data - identify your contacts and send their data
• Push Notifications - set up push and in-app notifications
• Sending Events - track contact actions