Skip to main content

Set up the Kotzilla SDK

You can configure the Kotzilla SDK either from the Koin IDE Plugin or from the Kotzilla Console. All the details are available here.

In this guide, we'll use the Koin IDE Plugin to set up the Kotzilla SDK in the NowInAndroid sample app:

1.- Open the NowInAndroid project in Android Studio.

2.- In the Koin IDE Plugin, open the Koin Insights view, go to the Kotzilla Flight Check tab, and click on the Manual Setup button. This will redirect you to the Kotzilla Console onboarding page.

3.- In the Kotzilla Console, register your application with the following values:

  • Application Name: NowInAndroid-gettingStarted
  • Android Package Name: com.google.samples.apps.nowinandroid.demo.debug

4.- Follow the onboarding steps in the Console to:

  • Generate the kotzilla.json configuration file
  • Update your Gradle build files with the correct SDK setup

5.- Once the setup completes, sync the app and verify the setup:

  • In the Koin Configuration view, the Debugging and performance monitoring flag should now show SDK active.
  • Click on the startKoin in onCreate() entry to see that the SDK initialization has been added to your NiaApplication.kt class.

Delayed SDK Start (e.g. Feature Flag)​

If you need to delay the Kotzilla SDK start — for example, to wait for a feature flag evaluation before enabling monitoring — you can call monitoring() on the KoinApplication instance after the startKoin block:

override fun onCreate() {
        super.onCreate()

        val koinApp = startKoin {
            androidContext(this@NiaApplication)

            modules(appModule)
            workManagerFactory()
        }

        // Start Kotzilla SDK after Koin is configured
        koinApp.monitoring()
}
note

analytics() (import io.kotzilla.sdk.analytics.koin.analytics) can also be called this way. However, monitoring() is recommended for consistency across all platforms.