Kotlin Multiplatform Development Help

Lifecycle

Lifecycle of components in Compose Multiplatform is adopted from the Jetpack Compose lifecycle concept. Lifecycle-aware components can react to changes in the lifecycle state of other components and help you produce better-organized, and often lighter, code that is easier to maintain.

Compose Multiplatform provides a common LifecycleOwner implementation, which extends the original Jetpack Compose functionality to other platforms and helps observe lifecycle states in common code.

States and events

The flow of lifecycle states and events (same as for the Jetpack lifecycle):

Lifecycle diagram

Lifecycle implementation

Composables usually don't need unique lifecycles: a common LifecycleOwner provides a lifecycle for all interconnected entities. By default, all composables created by Compose Multiplatform share the same lifecycle — they can subscribe to its events, refer to the lifecycle state, and so on.

When working with coroutines in multiplatform lifecycles, remember that the Lifecycle.coroutineScope value is tied to the Dispatchers.Main.immediate value, which might be unavailable on desktop targets by default. To make coroutines and flows in lifecycles work correctly with Compose Multiplatform, add the kotlinx-coroutines-swing dependency to your project. See Dispatchers.Main documentation for details.

Mapping Android lifecycle to other platforms

iOS

Native events and notifications

Lifecycle event

Lifecycle state change

viewDidDisappear

ON_STOP

STARTEDCREATED

viewWillAppear

ON_START

CREATEDSTARTED

willResignActive

ON_PAUSE

RESUMEDSTARTED

didBecomeActive

ON_RESUME

STARTEDRESUMED

didEnterBackground

ON_STOP

STARTEDCREATED

willEnterForeground

ON_START

CREATEDSTARTED

viewControllerDidLeaveWindowHierarchy

ON_DESTROY

CREATEDDESTROYED

Web

Due to limitations of the Wasm target, lifecycles:

  • Skip the CREATED state, as the application is always attached to the page.

  • Never reach the DESTROYED state, as web pages are usually terminated only when the user closes the tab.

Native event

Lifecycle event

Lifecycle state change

blur

ON_PAUSE

RESUMEDSTARTED

focus

ON_RESUME

STARTEDRESUMED

Desktop

Swing listener callbacks

Lifecycle event

Lifecycle state change

windowIconified

ON_STOP

STARTEDCREATED

windowDeiconified

ON_START

CREATEDSTARTED

windowLostFocus

ON_PAUSE

RESUMEDSTARTED

windowGainedFocus

ON_RESUME

STARTEDRESUMED

dispose

ON_DESTROY

CREATEDDESTROYED

Last modified: 25 September 2024