Android Installation

Add the Lovina Chat SDK to your Android project. The SDK requires Android 7.0+ (API 24), JDK 17+, and AndroidX. See Compatibility for the full version matrix.

The recommended way to install is from Lovina's private Nexus Maven registry — Gradle resolves the SDK and its transitive dependencies automatically. If you can't reach the registry, see Alternative: manual AAR at the end.

1. Configure the Nexus registry

The SDK is published to Lovina's private Nexus maven-releases repository under the coordinates com.lovina:chat-sdk. Tell Gradle where to find it and how to authenticate.

Store your credentials

Keep credentials out of source control by putting them in your global Gradle properties at ~/.gradle/gradle.properties (not the project's):

lovinaNexusUsername=your-username
lovinaNexusPassword=your-password

Ask your Lovina administrator for registry access. In CI, provide these as ORG_GRADLE_PROJECT_lovinaNexusUsername / ORG_GRADLE_PROJECT_lovinaNexusPassword environment variables instead of a file.

Add the repository

Most modern projects centralise repositories in settings.gradle.kts under dependencyResolutionManagement. Add the Nexus Maven repo alongside google() and mavenCentral():

// settings.gradle.kts
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven {
            name = "LovinaNexus"
            url = uri("https://packages.ailovina.com/repository/maven-releases/")
            credentials {
                username = providers.gradleProperty("lovinaNexusUsername").orNull
                password = providers.gradleProperty("lovinaNexusPassword").orNull
            }
        }
    }
}

Older project without dependencyResolutionManagement?

If your project still declares repositories in the root build.gradle(.kts), add the same maven { … } block inside allprojects { repositories { … } } there instead.

2. Add the dependency

In your module-level app/build.gradle.kts:

dependencies {
    implementation("com.lovina:chat-sdk:{version}")
}

Using the Groovy DSL (build.gradle)? Use implementation 'com.lovina:chat-sdk:{version}'.

That's it — the required AndroidX and coroutines dependencies come in transitively through the published POM, so you don't need to list them yourself.

3. Sync the project

Click Sync Now in the Gradle notification bar, or run:

./gradlew build

Permissions

The SDK requires internet access. Add to your AndroidManifest.xml if not already present:

<uses-permission android:name="android.permission.INTERNET" />

Requirements

Requirement	Minimum
Android	7.0+ (API 24)
Android targetSdk	35
JDK	17+

Verify Installation

Import the SDK in any Kotlin file:

import com.lovina.chatsdk.LovinaChatConfig

Build the project. If it compiles without errors, the SDK is installed.

Alternative: manual AAR

If you don't have access to the Nexus registry (for example, an air-gapped build), you can vendor the AAR directly.

1. Download the latest android-{version}.aar from the releases page.

2. Copy it into your module's app/libs/ directory:

   your-app/
   ├── app/
   │   ├── libs/
   │   │   └── android-{version}.aar
   │   └── build.gradle.kts

3. Reference the file and manually add every transitive dependency — the file-based approach carries no POM, so Gradle can't resolve them for you:

   dependencies {
       implementation(files("libs/android-{version}.aar"))
   
       // Required transitive dependencies (auto-resolved when using the registry)
       implementation("androidx.core:core-ktx:1.12.0")
       implementation("androidx.appcompat:appcompat:1.6.1")
       implementation("androidx.webkit:webkit:1.10.0")
       implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
   }

Next Steps

Once installed, head to Usage to embed the chat widget in your app.