Skip to main content

Set up the Kotzilla SDK

This section will guide you through the process of registering your application in the Kotzilla Platform and setting up the Kotzilla SDK in your NowInAndroid app.

Step 1 - Register your application on Kotzilla​

1.1 Register your application using the IDE Plugin​

  • Sign in to the Koin IDE Plugin
  • Open the Application Issues tab in the Issues Panel
  • Click the New App button

This will open the Register Your Application wizard in your browser

1.2 Define your application details​

  • Application Name: Enter “NowInAndroid”
  • Android Package Name: Use “com.google.samples.apps.nowinandroid.demo.debug”
  • App type: Select the default “Debug” value
note

If you choose "Production," you’ll also need to provide the corresponding mapping file for your release build.*

Now that the NowInAndroid app is registered, we will proceed to set up the Kotzilla SDK.

info

You can also register new apps directly from the Kotzilla Console: Go to the Kotzilla Console and log in to your account. On the homepage, click Register Your Application.

2. Set up the Kotzilla SDK​

2.1 Create a Kotzilla project configuration File​

Download the Kotzilla.json file that has been automatically generated. This is the configuration file of your project.

info

Add the Kotzilla.json file into the app-level module of your Android Studio project (nowinandroid/app directory)

Module (app-level) Gradle file ( <project>/<app-module> )

note

If you want to use the Version Catalog configuration, please skip section 2.2 below and follow this guide instead.

2.2 Update Gradle files​

note

Kotzilla SDK is available on both Maven Central and the Kotzilla public repository. More information on how to configure access to the Kotzilla repository is available here

info

In your project root folder, add the plugin and Kotzilla SDK to the build.gradle.kts: Project (root-level) Gradle file (NowInAndroid/build.gradle.kts):

buildscript {
    repositories { ... }
    dependencies {
        // This part to copy paste
        classpath("io.kotzilla:kotzilla-plugin:1.0.1")
    }
}
info

In your app module add the plugin and Kotzilla SDK dependency to the build.gradle.kts file within the module directory:

Module (app-level) Gradle file (NowInAndroid/app/build.gradle.kts):

// --- Plugins ---
plugins {
  // Add the Kotzilla Gradle plugin
  id("io.kotzilla.kotzilla-plugin")
}

// --- Dependencies ---
dependencies {
  // The Kotzilla SDK library dependency
  implementation("io.kotzilla:kotzilla-sdk:1.0.1")
}

2.3 Sync your project​

Once installed, sync your NowInAndroid project with the updated Gradle files to apply the changes.

3. Start the Kotzilla SDK in your NowInAndroid App​

In your Application class:

  • Start the Kotzilla SDK using analytics() during Koin initialisation
import io.kotzilla.sdk.analytics.koin.analytics
class NiaApplication : Application() {
	
    override fun onCreate() {
    super.onCreate()

        startKoin {
            androidContext(this@NiaApplication)

            // Kotzilla SDK setup for Android apps
            analytics()
            ...
        }
    }
}

Final steps​

The registration wizard will then prompt you to go to the Kotzilla Platform dashboard:

Congratulations! The installation is now complete, and you’re all set to start debugging your app.