KOIN Files

Koin 4.2.0-RC1

This Release Candidate consolidates all features, improvements, and bug fixes from the alpha and beta series. The focus has been on Compose integration stability, scope resolution improvements, Ktor 3.4 DI Bridge, and compiler plugin support.

## Highlights

### Ktor 3.4 DI Bridge Integration

• Bidirectional dependency resolution between Koin and Ktor DI - https://github.com/InsertKoinIO/koin/pull/2294 by @arnaudgiuliani
• KoinDependencyMapExtension implementing Ktor 3.2+'s DependencyMapExtension interface - https://github.com/InsertKoinIO/koin/commit/00496cc by @arnaudgiuliani
• New KoinKtorApplication DSL for explicit bridging configuration - https://github.com/InsertKoinIO/koin/commit/53cfc64 by @arnaudgiuliani
• SPI registration for automatic extension discovery
• Ktor 3.4 stable support - https://github.com/InsertKoinIO/koin/commit/3e5b44c by @arnaudgiuliani

### Navigation 3 Support

• New koin-compose-navigation3 module for AndroidX Navigation3 1.0.0 - https://github.com/InsertKoinIO/koin/pull/2302 by @arnaudgiuliani
• EntryProvider API for scoped dependency injection in navigation destinations
• Metadata parameter passing support (animations, etc.) - https://github.com/InsertKoinIO/koin/commit/7fbab5e by @arnaudgiuliani
• Make nav3 EntryProvider generic - https://github.com/InsertKoinIO/koin/pull/2314 by @xephosbot

### Compose Improvements

• koinActivityInject() function for Activity scope dependency retrieval - https://github.com/InsertKoinIO/koin/commit/f946362 by @arnaudgiuliani
• UnboundKoinScope API with @KoinDelicateAPI annotation - https://github.com/InsertKoinIO/koin/commit/f38a30f by @arnaudgiuliani
• Fixed premature release of scope & context in onForgotten - https://github.com/InsertKoinIO/koin/pull/2326 by @arnaudgiuliani
• Fixed Compose Koin Context Loader and Entry Points - https://github.com/InsertKoinIO/koin/pull/2327 by @arnaudgiuliani
• Navigation 2.x scope support (KoinNavigationScope) - https://github.com/InsertKoinIO/koin/pull/2309 by @arnaudgiuliani
• Compose context internals migration helpers - https://github.com/InsertKoinIO/koin/pull/2295 by @arnaudgiuliani

### ViewModelScope Updates

• ⚠️ Breaking ⚠️: ViewModel declarations requiring scope injection must now be inside viewModelScope { } block
• Improved CoreResolverV2 for proper child scope/ViewModel scope resolution - https://github.com/InsertKoinIO/koin/pull/2340 by @arnaudgiuliani

## Koin Compiler Plugin Support API

### New internal APIs for Koin Annotations compiler plugin:

• ModuleExt, CreateDSL, BaseDSLExt, ApplicationDSLExt - https://github.com/InsertKoinIO/koin/commit/932c154 by @arnaudgiuliani
• ViewModelDSLExt / ViewModelModuleExt - https://github.com/InsertKoinIO/koin/commit/43ecac9 by @arnaudgiuliani
• WorkerDSLExt / WorkerModuleExt - https://github.com/InsertKoinIO/koin/commit/43ecac9 by @arnaudgiuliani
• Adjusted KoinApplication.withConfiguration<T>() API support - https://github.com/InsertKoinIO/koin/commit/c4a5dcb by @arnaudgiuliani

## Core Improvements

• strictOverride option + explicit definition override support - https://github.com/InsertKoinIO/koin/pull/2304 by @arnaudgiuliani
• Lazy modules loading performance improvement (parallel loading at start) - https://github.com/InsertKoinIO/koin/pull/2303 by @arnaudgiuliani
• Performance optimization for scope resolution & thread safety - https://github.com/InsertKoinIO/koin/pull/2330 by @arnaudgiuliani
• Optimized ThreadLocal loading to avoid cost per Scope - https://github.com/InsertKoinIO/koin/pull/2345 by @arnaudgiuliani
• getAll() now returns instances in declaration order (removed default sorting) - https://github.com/InsertKoinIO/koin/commit/74d9884 by @arnaudgiuliani
• Kotlin 2.2.20 update - https://github.com/InsertKoinIO/koin/pull/2278 by @nhajratw, https://github.com/InsertKoinIO/koin/pull/2296 by @arnaudgiuliani

## Bug Fixes

• Fixed scope resolution issues - https://github.com/InsertKoinIO/koin/pull/2324 by @arnaudgiuliani
• Fixed CoreResolution with Child Scopes / ViewModelScope - https://github.com/InsertKoinIO/koin/pull/2340 by @arnaudgiuliani
• Fixed CoreResolverV2 stack params propagation - https://github.com/InsertKoinIO/koin/pull/2341 by @arnaudgiuliani
• Fixed sharedKoinViewModel with type-safe navigation routes - https://github.com/InsertKoinIO/koin/pull/2293 by @nazaburo
• Fixed WASM qualified name resolution - https://github.com/InsertKoinIO/koin/pull/2344 by @arnaudgiuliani
• Fixed module flatten order error - https://github.com/InsertKoinIO/koin/pull/1999 by @luozejiaqun
• Fixed crashing declarations for LocalKoinScope & LocalKoinApplication - https://github.com/InsertKoinIO/koin/commit/261bf93 by @arnaudgiuliani
• Fixed Qualifier conversion in Ktor DI bridge - https://github.com/InsertKoinIO/koin/commit/90edf60 by @arnaudgiuliani
• Safer ScopeFactory protecting all operations from parallel calls - https://github.com/InsertKoinIO/koin/pull/2323 by @arnaudgiuliani
• Fixed nav3 metadata arguments - https://github.com/InsertKoinIO/koin/pull/2313 by @arnaudgiuliani
• Fixed Scope Archetypes Qualifier in plugin support functions - https://github.com/InsertKoinIO/koin/commit/f972c52 by @arnaudgiuliani
• Fixed scope resolution in plugin - https://github.com/InsertKoinIO/koin/commit/01cff0d by @arnaudgiuliani
• Fixed EAP Access Ktor - https://github.com/InsertKoinIO/koin/commit/f6a5040 by @arnaudgiuliani

## Dependencies

• Kotlin 2.3.20-Beta1
• Ktor 3.4.0
• Coroutines 1.10.2
• Compose Multiplatform 1.10.0
• AndroidX Lifecycle 2.10.0 / JetBrains Lifecycle 2.9.6
• AndroidX Navigation 2.9.6 / JetBrains Navigation 2.9.1
• AndroidX Navigation3 1.0.0

## New Modules

• koin-compose-navigation3 - Navigation 3 integration
• koin-annotations - Core annotations module
• koin-dagger-bridge - Dagger to Koin bridge

## Removed

• koin-fu module (moved to Koin Annotations plugin) - https://github.com/InsertKoinIO/koin/commit/932c154 by @arnaudgiuliani
• CHANGELOG.md (see GitHub releases) - https://github.com/InsertKoinIO/koin/pull/2308 by @jvanderwee

## Breaking ⚠️

• ViewModel Scope Constructor Injection (still experimental) - ViewModel declarations requiring scope injection must now be declared inside viewModelScope { } block

## Contributors

Thanks to all contributors: @arnaudgiuliani, @nhajratw, @egorikftp, @GrzegorzBobryk, @jvanderwee, @xephosbot, @nazaburo, @luozejiaqun

Full Changelog: https://github.com/InsertKoinIO/koin/compare/4.1.1...4.2.0-RC1