4.2.1Aktualisiert May 11, 2026

io.insert-koin:koin-android

4.2.12026-04-10T14:24:38Z
Release Notes

Support for Compile Safety with Koin Compiler 1.0.0-RC1

Bug Fixes

  • Fix stacked-params lookup on linked scopes (#2387) — The 4.2.0 resolver rewrite (CoreResolverV2) walked linked scopes but dropped the per-parent stacked-parameters check that 4.1.x performed via recursion. This broke patterns where AndroidParametersHolder is stacked on the factory scope by KoinViewModelFactory and SavedStateHandle is then resolved from a child ViewModel scope. Linked-scope resolution now also checks stacked params on each parent scope.
  • Restore ABI compatibility for runOnKoinStarted (#2391) — The 4.2.0 release inadvertently broke binary compatibility for runOnKoinStarted on JVM. Fixed by restoring the original JVM class name via @JvmName/@JvmMultifileClass annotations.
  • Fix scope _closed concurrency issue (#2389) — The Scope._closed flag was not volatile, which could cause stale reads under concurrent access.

Improvements

  • Improved Scope resolution error messagesCoreResolverV2 now provides clearer error messages when scope resolution fails, making it easier to diagnose misconfigured scopes.
  • Added apiCheck to CI — Binary compatibility validation (kotlinx.binary-compatibility-validator) now runs on every PR to prevent future ABI breaks.

Documentation

  • parametersOf type-collision warning (#2328) — Added a caution note explaining that when a value passed via parametersOf has the same type as the requested definition, Koin returns the value directly and skips the factory block. Suggests using a wrapper type as a workaround.

logo

Kotlin Github Actions Apache 2 License Slack channel

What is KOIN? ✨

Koin is a pragmatic, lightweight dependency injection framework for Kotlin developers, developed by Kotzilla and open-source contributors.

The pragmatic Kotlin & Kotlin Multiplatform Dependency Injection framework
- Simple, Powerful and now Compile-Safe -

Compile-Safe Dependency Injection 🛡️

Koin is now compile-safe thanks to the Koin Compiler Plugin. Your dependency graph is verified at compile time — missing bindings, broken definitions, and misconfigured modules are caught by the compiler instead of crashing at runtime.

  • Catch missing or invalid dependencies before you run your app
  • Keep Koin's concise, idiomatic DSL — no extra boilerplate
  • Works across Kotlin & Kotlin Multiplatform targets

Get started with the Koin Compiler Plugin.

Setup & Current Version 📦

Follow the dedicated setup page to setup Koin for your project. Here are the currently available Koin versions:

  • Latest Version : Maven Central

Developer Tools & Observability 🛠️

Kotzilla Platform — KMP Crash Reporting & Observability

Free signup on Kotzilla

The full observability platform for Kotlin Multiplatform apps:

  • Full KMP Crash Reporting — complete crash reports across Android, iOS and all KMP targets
  • Screen Rendering Impact — understand how each screen affects rendering and user experience
  • Performance Monitoring — track runtime performance, memory metrics, and Koin module behavior

A console-based suite with connected cloud services that visualizes your Koin module structure, provides advanced debugging and tracing, and seamlessly integrates with Kotlin Multiplatform projects.

Koin IDE Plugin — Your Koin Developer Assistant

Freely available on the JetBrains Marketplace

The perfect Koin developer assistant: native support for IntelliJ IDEA and Android Studio, with navigation, inspections, and productivity features dedicated to Koin across Kotlin and Kotlin Multiplatform projects.

Community & Enterprise Support 💬

Koin is backed by an active open-source community and by Kotzilla for teams that need guaranteed, enterprise-grade support.

Community Support 🌱

Free, open-source support from the Koin community:

Enterprise-Grade Support with Koin LTS 🏢

For teams with production and compliance requirements, Koin LTS delivers enterprise-grade support backed by Kotzilla:

  • SLA-backed updates and guaranteed response times
  • Long-term maintenance on stabilized Koin versions (e.g. Koin 3.5 LTS)
  • Security & compliance patches aligned with enterprise requirements
  • Direct access to Kotzilla experts — the team behind Koin
  • Priority bug fixes and advisory support for architecture and migration

👉 Learn more and opt in at kotzilla.io/koin-lts.

Latest News & Resources 🌐

Contributing 🛠

Want to help or share a proposal about Koin? Problem with a specific feature?

  • Open an issue to explain the issue you want to solve Open an issue
  • Come talk on slack #koin-dev channel
  • After discussion to validate your ideas, you can open a PR or even a draft PR if the contribution is a big one Current PRs

Additional readings about basic setup: https://github.com/InsertKoinIO/koin/blob/master/CONTRIBUTING.adoc

Contributors

Thank you all for your work! ❤️

OpenCollective - Sponsorship ❤️

Support this project by becoming a sponsor and be displayed on the offcial website. [Help us and Become a sponsor!]

Versionen vergleichen

Wähle zwei Releases mit Changelog-Notizen um die Änderungen zu sehen.

Hier werden nur Releases mit verfügbaren Changelog-Notizen gezeigt.

Wähle zwei Versionen um Änderungen zu vergleichen.