CXone Chat for Android

Repository Overview

This is the CXone Chat SDK for Android, a comprehensive customer engagement solution by NiCE Ltd. The repository contains an Android SDK for chat functionality, UI components, and a sample store application.

High-Level Repository Information

• Project Type: Android SDK library with UI module

• Primary Languages: Kotlin (99.8%)

• Target Runtime: Android API 35 (Android 15)

• Supported Runtime: Android API 24-36 (Android 7.0 to Android 16)

• Build System: Gradle 9.3.1 with Android Gradle Plugin 8.13.2

• Java Compatibility: Source and target compatibility Java 11

• Architecture: Multi-module Android library with Jetpack Compose UI

Key Frameworks and Dependencies

• UI Framework: Jetpack Compose with Material Design 3

• Networking: Retrofit 3.0.0 with OkHttp 5.3.2

• Serialization: Kotlinx Serialization 1.9.0

• Dependency Injection: Koin 4.1.1 with KSP annotations

• Push Notifications: Firebase Cloud Messaging

• Image Loading: Coil 3.3.0

• Media Playback: AndroidX Media3 (ExoPlayer)

• Testing: JUnit 4, Kotest, MockK, Robolectric

Prerequisites for project build

JDK 17 is required to run the Gradle 9.x daemon. The recommended distribution is Eclipse Temurin 17 (used in CI). Avoid JDK 25 — it is currently incompatible with Detekt.

Android SDK & Build Tools: Android SDK with API levels 24–36 and corresponding build tools must be installed. Specify SDK location in local.properties using sdk.dir property if you are having issues, e.g.:

sdk.dir=/path/to/Android/Sdk

Project Layout and Architecture

Module Structure

├── chat-sdk-core/         # Core SDK functionality (Published artifact)
├── chat-sdk-ui/           # Default UI implementation (Published artifact)  
├── store/                 # Sample e-commerce application
├── utilities/             # Shared utility classes (Published artifact - transitive dependency)
├── logger/                # Logging interface (Published artifact - transitive dependency)
├── logger-android/        # Android-specific logging (Published artifact - transitive dependency)
├── logger-client/         # Client logging implementation (Published artifact - transitive dependency)
├── cxone-detekt-rules/    # Custom lint rules
└── buildSrc/              # Gradle convention plugins

CXone Chat SDK (chat-sdk-core)

This is the primary published module. It is released as an Android multi-flavor library with Maven artifact coordinates com.nice.cxone:chat-core.

Main objective of the SDK is to offer one API over several CXone Chat backends together with required business logic.

Adding the Dependency

To use the published artifact, include our public Maven/Gradle GitHub repository in your project. For details, see GitHub documentation on using published packages.

In the section where you define repositories used in your project (in our case, it is settings.gradle), add this part:

def localProperties = new Properties()
try {
    localProperties.load(file("local.properties").newReader())
} catch (ignored) {
    logger.trace("Unable to read local.properties")
}
repositories {
    maven {
        name = "github-nice-devone-cxone-mobile"
        url = "https://maven.pkg.github.com/nice-devone/nice-cxone-mobile-sdk-android"
        credentials {
            // Use property key from local.properties for local builds or environment variable for CI builds
            username = localProperties["github.user"] ?: System.getenv("GPR_USERNAME")
            password = localProperties["github.key"] ?: System.getenv("GPR_TOKEN")
        }
    }
}

Then either add properties github.user and github.key to your local.properties e.g.:

github.user=myuser
github.key=github_my_token

or set system variables GPR_USERNAME and GPR_TOKEN. You can use any non-privileged valid token, since the package are public.

Then you can use the dependency simply by adding:

    implementation "com.nice.cxone:chat-sdk-core:$currentVersion"

Additional information

Visit NICE documentation for more information about CXone Chat and pre-requisites for the SDK.

Current API.

You can also find a simplified example of possible SDK usage in docs/case-studies.md documentation.

We offer a brief how-to guide for integration docs/implementation.md.

CXone Chat UI

This is the default implementation of the UI for CXone Chat SDK, which allows easier integration of the SDK into the intended target application.

It is released as an Android multi-flavor library with Maven artifact coordinates com.nice.cxone:chat-sdk-ui.

More of the details can be found in the module chat-sdk-ui/README.md

Chat UI provides these features:

• Display the thread list (for multi-thread SDK configuration)

• Archive an existing thread

• Start a new thread

• Display and service the thread conversation (including implementation for all message formats currently supported by the SDK)

• Send message

• Upload attachment

• Record & play voice messages

• Name the thread (for multi-thread SDK configuration)

• Message pagination support

• Typing indication & reporting

• Filling out of pre-contact form

• Display notification about the new message when application is in the background (requires Firebase Cloud Messaging)

• Sharing of message attachments

• Fullscreen previews of images & videos

Additional information

A brief case study about docs/chat-sdk-ui/cs-ui-configuration.md will lead you through the setup process.

We offer a brief how-to guide for integration docs/chat-sdk-ui/cs-ui-integration.md.

Store application

This is a mock application that tries to imitate e-store with its purchase flow, so we can also demonstrate an integration of the SDK analytics events like pageView or conversion.

Integration

When integrating the CXone Chat SDK into your application, please note the following:

If your application defines its own fullBackupContent rules, you must explicitly exclude the CXone SDK's shared preferences file to avoid backing up sensitive data, which are not transferable.

Add the following exclusion to your backup rules:

<exclude domain="file" path="datastore/secure_store.preferences_pb" />
<exclude domain="sharedpref" path="cxonechat_tink_keyset.xml" />
<exclude domain="sharedpref" path="com.nice.cxonechat.secure.xml" />

This ensures that the SDK's secure preferences are not included in the application's backup and won't cause an issue if the application is restored on a different device.

Tooling modules:

logger

The logger module is a minimalistic logging framework used by the chat-sdk-core without any platform-specific code. It is distributed as a java library at the moment.

The maven artifact coordinates are com.nice.cxone:logger.

logger-android

The logger-android module provides the default android-specific implementation of the Logger. Application can provide this instance to the SDK builder if it wishes the SDK to log to the Android platform log output.

The maven artifact coordinates are com.nice.cxone:logger-android.

logger-client

The logger-client module provides an integrated remote logging solution that sends error logs to NICE servers for tracking and analysis.

utilities

This is an internal module that attempts to resolve some of the issues reported by the strict mode.