Skip to content

Upgrading io.insert-koin:koin-core 3 to 4

Breaking3.5.6 → 4.2.2Breaking9Platform2Deprecated2New63Changed96Fixed92Other73

Full comparisonBack to io.insert-koin:koin-core
BreakingUpgrade verdict

8 breaking changes and 2 platform requirement changes.

In plain terms
  • Renames module to lazyModule in some contexts.
  • getAll() now returns instances in declaration order, removing the previous default sorting.
  • If you used koin-fu, switch to the Koin Annotations plugin instead.
  • Changes the BeanDef constructor, updating its API signature.
Must act Top 5 of 12 that need code or config changes

Installs 5 packages in all (was 6).

What you must change

Breaking8
Renames module to lazyModule in some contexts.
modulelazyModule
4.2.0GitHub ReleaseSummarizedView source
getAll() now returns instances in declaration order, removing the previous default sorting.
getAll()
4.2.0-RC1GitHub ReleaseSummarizedView source
Removes the koin-fu module, which moved to the Koin Annotations plugin.
koin-fu
4.2.0-RC1GitHub ReleaseSummarizedView source
Changes the BeanDef constructor, updating its API signature.
BeanDef
4.2.0GitHub ReleaseSummarizedView source
Requires ViewModel declarations that need scope injection to be inside a viewModelScope { } block.
viewModelScope
4.2.0-RC1GitHub ReleaseSummarizedView source
Automatic ViewModel scope creation now requires ViewModel declarations inside the viewModelScope section; declarations outside resolve against the root scope.
viewModelviewModelScope
4.2.0-beta3GitHub ReleaseSummarizedView source
KoinApplication is reworked to start and stop on the Compose lifecycle.
KoinApplication
4.0.0GitHub ReleaseSummarizedView source
Fixes Compose scope resolution with proper context handling and introduces ComposeContextWrapper to manage internal scope state.
ComposeContextWrapper
4.1.1GitHub ReleaseSummarizedView source
Platform2
Raises minSdk to 23 for Android.
4.2.0GitHub ReleaseSummarizedView source
Requires the Ktor EAP repository to be added to settings.gradle.kts.
4.2.0-beta4GitHub ReleaseSummarizedView source

Deprecations to plan for

Deprecated2
Deprecates CheckModules.
CheckModules
4.0.0GitHub ReleaseSummarizedView source
Restores CheckModules as deprecated code.
CheckModules
4.0.0GitHub ReleaseSummarizedView source