---
title: Android
description: This guide covers installing and configuring the Coralogix RUM SDK in an Android application, the options it accepts, the instrumentations it enables, and the API for reporting logs and errors.
url: https://coralogix.com/docs/user-guides/rum/sdk-installation/android/
product: rum
feature: Android SDK
feature_id: mobile-sdk-android
feature_identifier: rum/mobile-sdk-android
last_updated: '2026-08-12'
---

# Coralogix Android RUM SDK

The **Coralogix Android SDK** provides Real User Monitoring (RUM) capabilities for Android apps. It captures **logs, errors, network requests, custom metrics, and mobile performance data**, and sends them to **Coralogix** for advanced observability and analytics.

## Quickstart

Add the dependency and initialize the SDK in your `Application` class.

```
class MyApp : Application() {

    override fun onCreate() {

        super.onCreate()



        val options = CoralogixOptions(

            applicationName = "<YOUR_APP_NAME>",

            coralogixDomain = CoralogixDomain.EU1,

            publicKey = "<YOUR_PUBLIC_KEY>"

        )



        CoralogixRum.initialize(

            application = this,

            options = options

        )

    }

}
```

Note

See the [Initialization](https://coralogix.com/docs/user-guides/rum/sdk-installation/android/configuration/initialization.md#initialization) section for the available regional domains and a detailed documentation of the available sdk options.

## Installation

Add the dependency to your app’s Gradle build file:

```
dependencies {

    implementation "com.coralogix:android-sdk:2.27.0"

}
```

The SDK pulls in [`androidx.work`](https://developer.android.com/topic/libraries/architecture/workmanager) transitively — you do not need to declare it yourself.

Note

**If you initialize WorkManager on demand:** the SDK runs two WorkManager jobs, the backstop job described under [Automatic flush on backgrounding](https://coralogix.com/docs/user-guides/rum/sdk-installation/android/features/supported-instrumentations.md#automatic-flush-on-backgrounding) and the job that sends saved crashes, described under [Automatic Crash Tracking](https://coralogix.com/docs/user-guides/rum/sdk-installation/android/features/supported-instrumentations.md#automatic-crash-tracking). If your `Application` implements `Configuration.Provider` for [on-demand initialization](https://developer.android.com/topic/libraries/architecture/workmanager/advanced/custom-configuration), WorkManager starts on first use and the SDK runs both jobs as usual. If you remove WorkManager's default initializer without implementing `Configuration.Provider`, call `WorkManager.initialize` in `Application.onCreate`; otherwise the SDK skips both jobs. The SDK still flushes immediately without WorkManager, and still sends saved crashes the next time your app starts. To remove WorkManager's initializer, remove only its `androidx.work.WorkManagerInitializer` entry, not the whole `androidx.startup.InitializationProvider`: the SDK uses that provider to flush in the background and to report cold starts.

## Troubleshooting

### Core library desugaring on API 24 and 25

The SDK declares `minSdk = 24` and depends on the OpenTelemetry Java SDK, which uses `java.time` APIs available natively only from API 26. On API 24 and 25 those need core library desugaring, so enable it if your app supports either level:

```
android {

    compileOptions {

        isCoreLibraryDesugaringEnabled = true

    }

}



dependencies {

    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")

}
```

The same switch helps any other dependency that needs Java 8+ APIs, within the subset `desugar_jdk_libs` backports - it is not blanket coverage, so a dependency using an API outside that subset can still fail on API 24 and 25.

## License

```
Copyright (c) 2025 Coralogix

Licensed under the Apache License, Version 2.0
```
