Legacy Gradle SDK setup

This page shows how to setup the Kotzilla SDK for projects not using Version Catalog.

info

• Initial app registration (downloading kotzilla.json) and starting the SDK (calling monitoring() in your Koin configuration) remain exactly the same as in the app-type specific setup guides.
• Only the Gradle configuration snippets differ.
• Use this page only if your project is not using Version Catalog.

1. Root Project Gradle File

In your root-level build.gradle.kts file, apply the Kotzilla plugin:

plugins {
    id("io.kotzilla.kotzilla-plugin") version "2.0.2" apply false
}

This step is the same for all app types.

2. Module-Level Gradle File

Choose the snippet that matches your app type and add it to your module-level build.gradle.kts.

Auto-Dependency Injection (SDK 2.0.x)

The plugin automatically adds SDK dependencies. No manual implementation line needed.

For manual control, set kotzilla { autoAddDependencies = false } and add the dependency explicitly.

Android

plugins {
    id("io.kotzilla.kotzilla-plugin")
}

Manual fallback: implementation("io.kotzilla:kotzilla-sdk:2.0.2")

Android with Compose

plugins {
    id("io.kotzilla.kotzilla-plugin")
}

Manual fallback: implementation("io.kotzilla:kotzilla-sdk-compose:2.0.2")

note

Compose navigation instrumentation is enabled by default in SDK 2.0.x.

Kotlin Multiplatform (KMP)

plugins {
    id("io.kotzilla.kotzilla-plugin")
}

Manual fallback: implementation("io.kotzilla:kotzilla-sdk:2.0.2") in commonMain.dependencies

Compose Multiplatform (CMP)

plugins {
    id("io.kotzilla.kotzilla-plugin")
}

kotzilla {
    versionName = "1.0.0" // Your app version
}

Manual fallback: implementation("io.kotzilla:kotzilla-sdk-compose:2.0.2") in commonMain.dependencies

note

Compose navigation instrumentation is enabled by default in SDK 2.0.x.

SDK Library for Android

plugins {
    id("io.kotzilla.kotzilla-plugin")
}

Manual fallback: implementation("io.kotzilla:kotzilla-sdk:2.0.2")

info

The latest version of the kotzilla-sdk is:

3. Kotzilla DSL Reference

The kotzilla {} block provides configuration options for the Gradle plugin:

kotzilla {
    enabled = true                      // Master switch (default: true)
    versionName = "1.0.0"               // Auto-detected if omitted
    site = "gateway.kotzilla.io"        // Custom endpoint (optional)
    projectFile = "kotzilla.json"       // Custom config path (optional)
    uploadMappingFile = true            // ProGuard mapping upload (default: true)
    composeInstrumentation = true       // Compose NavHost tracking (default: true)
    obfuscateGeneratedConfig = true     // Encodes API key to avoid visibility in bundle (default: true)
    autoInjectXcodeScript = true        // iOS dSYM script (default: true)
    autoAddDependencies = true          // Auto-add SDK deps (default: true)
    displayLogs = false                 // Debug logging (default: false)
}

Default Changes in SDK 2.0.x

Option	1.4.x Default	2.0.x Default
composeInstrumentation	false	true
autoInjectXcodeScript	false	true
obfuscateGeneratedConfig	N/A	true
autoAddDependencies	N/A	true