Introduced global plugins, added GlobalNodeLifecycleAware

bumble-tech · Nov 18, 2024 · 2c37b94 · 2c37b94
1 parent 7911ad9
commit 2c37b94
Show file tree

Hide file tree

Showing 4 changed files with 16 additions and 2 deletions.
diff --git a/gradle.properties b/gradle.properties
@@ -3,4 +3,4 @@ org.gradle.caching=true
 org.gradle.parallel=true
 android.useAndroidX=true
 kotlin.code.style=official
-library.version=1.5.0
+library.version=1.5.1
diff --git a/libraries/core/src/main/kotlin/com/bumble/appyx/Appyx.kt b/libraries/core/src/main/kotlin/com/bumble/appyx/Appyx.kt
@@ -1,12 +1,18 @@
 package com.bumble.appyx
 
 import com.bumble.appyx.core.children.ChildEntry
+import com.bumble.appyx.core.plugin.Plugin
 
 object Appyx {
 
     var exceptionHandler: ((Exception) -> Unit)? = null
     var defaultChildKeepMode: ChildEntry.KeepMode = ChildEntry.KeepMode.KEEP
 
+    /**
+     * Plugins that are applied to all Nodes.
+     */
+    var globalPlugins: List<Plugin> = emptyList()
+
     fun reportException(exception: Exception) {
         val handler = exceptionHandler
         if (handler != null) {

diff --git a/libraries/core/src/main/kotlin/com/bumble/appyx/core/node/Node.kt b/libraries/core/src/main/kotlin/com/bumble/appyx/core/node/Node.kt
@@ -27,6 +27,7 @@ import com.bumble.appyx.core.modality.AncestryInfo
 import com.bumble.appyx.core.modality.BuildContext
 import com.bumble.appyx.core.plugin.BackPressHandler
 import com.bumble.appyx.core.plugin.Destroyable
+import com.bumble.appyx.core.plugin.GlobalNodeLifecycleAware
 import com.bumble.appyx.core.plugin.NodeLifecycleAware
 import com.bumble.appyx.core.plugin.NodeReadyObserver
 import com.bumble.appyx.core.plugin.Plugin
@@ -57,7 +58,7 @@ open class Node @VisibleForTesting internal constructor(
     @Suppress("LeakingThis") // Implemented in the same way as in androidx.Fragment
     private val nodeLifecycle = NodeLifecycleImpl(this)
 
-    val plugins: List<Plugin> = plugins + listOfNotNull(this as? Plugin)
+    val plugins: List<Plugin> = plugins + Appyx.globalPlugins + listOfNotNull(this as? Plugin)
 
     val ancestryInfo: AncestryInfo =
         buildContext.ancestryInfo
@@ -115,6 +116,7 @@ open class Node @VisibleForTesting internal constructor(
         updateLifecycleState(Lifecycle.State.CREATED)
         plugins<NodeReadyObserver<Node>>().forEach { it.init(this) }
         plugins<NodeLifecycleAware>().forEach { it.onCreate(lifecycle) }
+        plugins<GlobalNodeLifecycleAware>().forEach { it.onCreate(this, lifecycle) }
     }
 
     @Composable
@@ -179,6 +181,7 @@ open class Node @VisibleForTesting internal constructor(
                 retainedInstanceStore.clearStore(id)
             }
             plugins<Destroyable>().forEach { it.destroy() }
+            plugins<GlobalNodeLifecycleAware>().forEach { it.onDestroy(this) }
         }
     }
 

diff --git a/libraries/core/src/main/kotlin/com/bumble/appyx/core/plugin/Plugins.kt b/libraries/core/src/main/kotlin/com/bumble/appyx/core/plugin/Plugins.kt
@@ -23,6 +23,11 @@ interface NodeLifecycleAware : Plugin {
     fun onCreate(lifecycle: Lifecycle) {}
 }
 
+interface GlobalNodeLifecycleAware : Plugin {
+    fun onCreate(node: Node, lifecycle: Lifecycle) {}
+    fun onDestroy(node: Node) {}
+}
+
 interface UpNavigationHandler : Plugin {
     fun handleUpNavigation(): Boolean = false
 }