Updating the SDK

Learn how to update the Luciq SDK in your Android app. Follow migration steps to upgrade to the latest version and access new features and bug fixes.

Ensure that the Luciq version is consistent across all dependencies, as illustrated below

Gradle Groovy DSL

Updating the Luciq Gradle Plugin

To update to the latest version 14.0.0, modify the root build.gradle file as follows:

buildscript {  
    dependencies {  
        classpath "ai.luciq.library:luciq-plugin:18.0.0"  
    }  
}

Updating the Luciq Dependency

In the Application’s build.gradle file, include the following dependencies:

..  
dependencies {  
    // App dependencies  
    implementation("ai.luciq.library:luciq:18.0.0")  
    implementation("ai.luciq.library:luciq-ndk-crash:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-compose:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-with-okhttp-interceptor:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-apm-okhttp-interceptor:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-apm-grpc-interceptor:18.0.0") // optional  
}

---

Gradle Kotlin DSL

Updating the Luciq Gradle Plugin

To update to the latest version 14.0.0, adjust the root build.gradle file as shown below:

plugins {  
    id("ai.luciq.library") version "18.0.0" apply false // optional, only add if using any Luciq plugins  
}

Updating the Luciq Dependency

In the Application’s build.gradle.kts file, include the following dependencies:

dependencies {  
    // App dependencies  
    implementation("ai.luciq.library:luciq:18.0.0")  
    implementation("ai.luciq.library:luciq-ndk-crash:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-compose:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-with-okhttp-interceptor:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-apm-okhttp-interceptor:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-apm-grpc-interceptor:18.0.0") // optional  
}

---

Gradle Version Catalog TOML

Ensure that the Luciq version is consistent across all dependencies, as illustrated below:

Updating the libs.versions.toml File

To update the Luciq version to 14.0.0, make the following changes:

dependencies {  
    // App dependencies  
    implementation("ai.luciq.library:luciq:18.0.0")  
    implementation("ai.luciq.library:luciq-ndk-crash:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-compose:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-with-okhttp-interceptor:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-apm-okhttp-interceptor:18.0.0") // optional  
    implementation("ai.luciq.library:luciq-apm-grpc-interceptor:18.0.0") // optional  
}

Updating the Luciq Gradle Plugin

In the root build.gradle.kts file, include:

plugins {  
    alias(libs.plugins.luciq.plugin) apply false  
}

Updating the Luciq Dependency

In the App's build.gradle.kts file, configure as follows:

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("luciq") // optional
    id("luciq-apm") // optional
    id("luciq-crash") // optional
    id("luciq-compiler-extension") // optional
}
luciq { // Plugins configuration
    webViewsTrackingEnabled = true // Enables automatic WebView collection, default is false (moved from apm {} in v19.2.0)
    setCaptureComposeNavigationDestinations(true) // Enables automatic screen identification for Compose, default is false
    crashReporting { // Crash reporting configuration
        autoUploadEnabled = false // Enables/disables uploading for whitelisted variants, default is false
        appToken = "token" // Provides the application's token
        experimentalGuardSquareSupportEnabled = false // Enables/disables GuardSquare's product checking and processing, default is false
    }
    apm { // APM Configurations
        fragmentSpansEnabled = true // Enables fragment spans collection, default is false; feature won't work if disabled from the plugin
        networkEnabled = true // Enables automatic network interception (OkHttp & URLConnection), default is true
    }
    compilerExtension { // Compiler extension configurations
        version = "x.y.z" // Luciq compiler extension version that matches Kotlin version for compatibility. Refer to https://docs.luciq.ai/docs/android-kotlin-compilers-compatibility
    }
}
dependencies {
    implementation(libs.luciq.main)
    implementation(libs.luciq.ndk.crash) // optional
    implementation(libs.luciq.compose) // optional
    implementation(libs.luciq.apm.okhttp) // optional
    implementation(libs.luciq.apm.grpc) // optional
    implementation(libs.luciq.okhttp) // optional
}