Upgrading io.insert-koin:koin-compose 1 to 4

Breaking1.1.5 → 4.2.2Breaking9Platform2Deprecated2New65Changed87Fixed82Other63

Full comparison Back to io.insert-koin:koin-compose

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 default sorting.
The koin-fu module is gone; its functionality now lives in the Koin Annotations plugin.
Changes the BeanDef constructor, updating its API signature.

Must act Top 5 of 12 that need code or config changes

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 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

ViewModel declarations requiring scope injection must now 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 cycle.

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.

minSdk

4.2.0GitHub ReleaseSummarizedView source

Requires the Ktor EAP repository to be added to settings.gradle.kts.

settings.gradle.ktsmaven()

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