Kotzilla SDK changelog
Stay up-to-date with the latest changes, bug fixes, and improvements in the Kotzilla SDK.
Maven Packages
The Kotzilla SDK & Plugin are available on maven central.
Here is the current available version:
| Module | Version |
|---|---|
| kotzilla-plugin | |
| kotzilla-sdk-compose | |
| kotzilla-sdk |
Latest Changes
-
2.0.4 (11/02/2026)
- iOS crash reports now include Kotlin stack traces — Previously, iOS crash reports only contained PLCrashReporter's native stack trace. The SDK now captures the full Kotlin stack trace at the moment of an unhandled exception, persists it immediately, and includes it in the crash report sent on next launch.
-
2.0.3 (04/02/2026)
- Fixed: Koin resolution failure — Fixed "Could not create instance for KotzillaHttpClientImpl" error caused by
singleOf()DSL ignoring default parameter values - Fixed: Early flush race condition — Multiple coroutines could be spawned for early flush at 70% buffer capacity, causing request bursts. Now uses
@Volatileflag to guarantee single flush - Fixed: SDK startup failure — Fixed edge case where
KotzillaHttpClientImplinstantiation could fail due to a race condition between HttpEngine registration and lazy resolution - Fixed: Flag stuck after lifecycle — Reset
earlyFlushPendingon resume and shutdown to prevent stuck state - Added Koin singleton smoke tests to prevent similar regressions
- Fixed: Koin resolution failure — Fixed "Could not create instance for KotzillaHttpClientImpl" error caused by
-
2.0.2 (29/01/2026)
- Breaking: Koin 4.0.4+ now required (was 3.5+)
monitoring()generated function — Replaces manual SDK setup with auto-configuration fromkotzilla.jsonanalytics {}deprecated on JVM/JS/Native/WASM — Usemonitoring {}; Androidanalytics()unchangedkeyGenerationDSL removed — Replaced by automaticGenerateKotzillaConfigTask- iOS crash reporting (Beta) — PLCrashReporter with dSYM upload automation (
./gradlew setupKotzillaXcode) - JS/WASM support (Experimental) — Browser & Node.js exception handlers with localStorage persistence
- JVM crash reporting (Experimental) — Crashes captured; mapping file support not yet available
- Auto-dependency injection — SDK dependencies added automatically; opt-out:
kotzilla { autoAddDependencies = false } - ProGuard/R8 rules auto-included — No manual configuration needed
composeInstrumentationdefault:true— Wasfalse; opt-out:kotzilla { composeInstrumentation = false }- API key obfuscation — XOR+Base64 by default; opt-out:
kotzilla { obfuscateGeneratedConfig = false } - Fail-fast on missing API key — Build fails with actionable error instead of silent failure
- Environment mismatch detection — Warns when Gradle
sitediffers from runtimeEnvironment sdkVersiondeprecated inkotzilla.json— No longer used- Kotlin 2.1.0–2.3.0 support (was 2.0.21–2.1.20)
- Compose Navigation upgraded to 2.9.1
- Reduced and optimised SDK traffic
- Improved reliability of mapping/dSYM upload
- Fixed API 21 crash in Compose SDK (
forEachmethod is not supported on API 21)
-
1.4.2 (17/12/2025)
- Fixes a problem in CMP apps where the key wasn't found in the first folder
- Prevented race condition in event reporter fixing duplicate event batches to be sent to Kotzilla
- Prevented stale app version in Compose apps
- Automatic app version resolution was added to Compose apps to help with configuration
-
1.4.2-RC1 (12/12/2025)
- Fix Compose Android resources folder scanning
-
1.4.1 (04/12/2025)
- Fix long running sessions analytics
-
1.4.0 (17/11/2025)
- Kotlin 2.0.21 is the minimum required version
- Ktor is replaced with a native HTTP client on each supported platform
- Removed all Ktor HTTP client dependencies (up to ~500-700KB non-minified binary size reduction)
- Added consumer ProGuard rules for better R8/ProGuard compatibility
-
1.3.1 (7/11/2025)
- Kotzilla key selection by flavor
- Fix Gradle Plugin, to skip Compose Navigation tracing if not using Kotlin 2.1.x (make it compat with Kotlin 2.2.x)
-
1.3.0 (23/10/2025)
- Remove kotlinx date-time dependency to avoid conflicts
- Upgrade Kotlin Compatibility version to 2.1.20
-
1.2.3 (07/10/2025)
- Fixed connection retry strategies
- Fixed events retry strategies
-
1.2.2 (10/09/2025)
- Fixed core internals and schedulers threading
- Fixed events mission + better retry strategies
-
1.2.1 (29/08/2025)
- Added
suspendTraceto trace coroutines function (used in Koin Annotations 2.2 with@Monitor) - Added Compose Nav arguments to the capture data
- Added
-
1.2.0 (29/08/2025)
- Check for the Compose resources task in Gradle
-
1.2.0-Beta4 (27/05/2025)
- Analytics/Koin logger active guard at start (to check if Koin config is ok)
- Fixed events emitting & parallelism
- Default push to 30s
-
1.2.0-Beta3 (16/05/2025)
- Introduce new
kotzilla-sdk-composelibrary to allow Compose Multiplatform setup - Track for Compose Navigation events from Kotlin Compiler instrumentation (Compose 1.7+)
- Fixed Kotzilla generation for Android & CMP projects
- Introduce new
-
1.1.0 (16/05/2025)
- Fix
kotzilla-pluginto be usable directly by Version Catalog
- Fix
-
1.0.2-RC3 (15/05/2025)
- Fix
Context.apiKey()to find the right Kotzilla SDK context - Fix Gradle tasks with Gradle cache usage and clean task dependency
- Fix
-
1.0.1 (05/03/2025)
- upload mapping file following any 'assembleRelease' build. This can be disabled by
uploadMappingFile = falsein Kotzilla gradle config
- upload mapping file following any 'assembleRelease' build. This can be disabled by
-
1.0.0 (03/03/2025)
- 0.13.6 - analytics() function in Koin + Plugin Fixes + Key fingerprint to help regeneration
- Rework SDK to allow different http engine ktor2 / ktor3
- Network resilience - recover connection & send events network errors
- Rework analytics function for KMP API
- Rearchitecture all API for ktor3 / Entry points
-
0.13.6 (05/02/2025)
- analytics function setup by for Koin (one-line magic setup)
- Gradle clean key assets task
- cleanKotzillaKey Task hook on Gradle/Android clean task
- Reinforcement for all Gradle Tasks to fail if the kotzilla key is not well-detected
- Key injection in Gradle task fix
- Change kotzilla key generation with SHA1 fingerprint key to help generation/verification
-
0.13.5 (09/12/2024)
- Fix Gradle plugin Tasks generation
-
0.13.4 (26/11/2024)
- Fix
KotzillaSDK.setupAPI call to allow nullable advanced setup options
- Fix
-
0.13.3 (26/11/2024)
- Maven Central publish fix + Doc update to use
classpathdeclaration atbuild.gradle.ktsroot project file
- Maven Central publish fix + Doc update to use
-
0.13.2 (20/11/2024)
- Logger optimization & Fixes
- Core Scheduler start optimization
-
0.13.1 (20/11/2024)
- Project file format fix
-
0.13.0 (24/10/2024) - Rebranding to Kotzilla Platform + Api Key Managagement
- renamed
CloudInjectSDKtoKotzillaSDKclass - moved
io.kotzilla.cloudinjectin toio.kotzilla.sdkpackage - moved Maven package from
io.kotzilla:cloud-injecttoio.kotzilla:kotzilla-sdk - moved Maven package from
io.kotzilla:cloud-inject-gradletoio.kotzilla:kotzilla-gradle - added proguard rule:
-keep class io.kotzilla.sdk.** { *; } - added
generateAndroidAssetsKeyGradle task to generate container key fromkotzilla.jsonproject file see more - added
generateProjectFileGradle task to generate emptykotzilla.jsonwith all package see more
- renamed
New Maven packages are kotzilla-sdk & kotzilla-plugin
You need to download a kotzilla.json project file
-
0.12.0 (27/9/2024)
- CloudInjectSDK setup DSL revamped to allow easyer setup and options
- Http engine fixed back to Ktor CIO
- changed tag for logs in 'Kotzilla Platform'
- updated to
cloudInjectGradle DSL declaration part
-
0.11.1 (27/9/2024)
- Fix Koin 4.0 compatibility
- Fix min SDK to 21
- Fix error report job cancelling
- Breaking, due to package move. Add
-keep class io.kotzilla.data.json.** { *; }to proguard rules
-
0.11.0 (9/9/2024)
- New KMP/standalone context isolation
- Fix plugin setup description
-
0.10.0-Beta6 (23/8/2024)
- Fix to Handle Android Library from plugin
-
0.10.0-Beta5 (2/7/2024)
- merge android & KMP project as single gradle module
-
0.10.0-Beta4 (2/7/2024)
- work all native KMP API to help start on iOS
-
0.10.0-Beta3 (31/5/2024)
- optimized startup process & Stricmode fixes
- global background performances updates
- SDK context isolation
-
0.10.0-Beta1
- Start of new KMP Version (Experimental)
-
0.9.5
- Fix Http Client engine to avoid StrictMode conflicts
- Display sessionId in info logs
- remove useless setUserId done at start
- Optimize SDK start calls on IO for local storage
-
0.9.4
- Fix some internals logging
-
0.9.3
- Proguard fix
-
0.9.2
- Feature
createIssueto manually to create an issue from the app - API protection reinforcements
- Feature
-
0.9.1
- SDK startup Delay Fix
- logError() can take up to 20 lines of stacktrace
-
0.9.0
- log() function to log messages
- trace() function to trace performances for a block code
-
0.8.1
- Fix proguard flatten packages to avoid conflicts with other SDK
-
0.8.0
- SDK is now public on Maven Central & Github
- improved proguard rules internally
-
0.7.0
- Fixing internals API - Push rate adjustements
- Fixing mapping upload with Gradle plugin
-
0.6.2
- fix offline networking error
- handle android security config
-
0.6.1
- Fix plugin id to help setup with Gradle KTS
- New Logger system - report fatal internals
- Check for Koin Logger setup if not properly setup when SDK is connecting
-
0.6.0
- renaming both sdk & plugin to 0.6.x version track
- publish back to JFrog
-
0.5.x
- Gradle plugin to upload mapping & meta index to the platform
-
0.4.5
- SDK internal initialization fix to allow async usage of different analytics reporter, in different threads
-
0.4.3 & 0.4.4
- JFrog distribution hosting - kotzilla.jfrog.io
- internals update with common-sdk
-
0.4.2
- crash reporter enabled by default (compatible with crashlytics)
- explicit API cleaning
-
0.4.1
- Error reporting reconnection fix
- Local backup format fix
-
0.4.0
- Client connection handling 403/429 and reconnect strategy
- Crash reporting (not yet enabled by default)
- Store & resend saved crash report
- Core scheduler update with Coroutines 1.7.1
-
0.3.x
- cloud inject rebranding
- new connection endpoint
- new background scheduler
0**.3.1 - 2023-05-11**
- cloud-inject rebranding
- allow delayed SDK setup for Koin logger
0**.2.0 - 2023-**
- connection & control flow from the cloud
- persist refresh
0**.1.5 - 2023-04-24**
- atomic order management
0**.1.3 - 2023-03-17**
- Android event scheduling fix
0.1.2 - 2023-03-14
- Environment Configuration management
- Threading info Fix