Merge PR: cmp-paycraft 2.0.8 — androidx-startup Initializer

Author: MobileByteLabsCommunity

cmp-paycraft/build.gradle.kts

@@ -90,6 +90,9 @@ kotlin {
         androidMain.dependencies {
             implementation(libs.ktor.client.cio)
             implementation("androidx.security:security-crypto:1.1.0-alpha06")
+            // androidx-startup hands the Application Context to PayCraftInitializer
+            // before Application.onCreate runs — see PayCraftInitializer.kt.
+            implementation("androidx.startup:startup-runtime:1.2.0")
         }
 
         iosMain.dependencies {

cmp-paycraft/src/androidMain/AndroidManifest.xml

@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+
+    <!--
+        androidx-startup wiring for PayCraftInitializer.
+
+        The InitializationProvider node is contributed by the androidx.startup:
+        startup-runtime library when it's on the consumer's classpath. We merge
+        a single <meta-data> entry referencing our Initializer so the AndroidX
+        Startup framework hands the Application Context to PayCraftPlatform
+        before the consumer's Application.onCreate runs — no consumer-side
+        PayCraftPlatform.init(applicationContext) call needed.
+
+        See PayCraftInitializer.kt for the opt-out pattern.
+    -->
+    <application>
+        <provider
+            android:name="androidx.startup.InitializationProvider"
+            android:authorities="${applicationId}.androidx-startup"
+            android:exported="false"
+            tools:node="merge">
+            <meta-data
+                android:name="com.mobilebytelabs.paycraft.PayCraftInitializer"
+                android:value="androidx.startup" />
+        </provider>
+    </application>
+</manifest>

cmp-paycraft/src/androidMain/kotlin/com/mobilebytelabs/paycraft/PayCraftInitializer.kt

@@ -0,0 +1,43 @@
+package com.mobilebytelabs.paycraft
+
+import android.content.Context
+import androidx.startup.Initializer
+
+/**
+ * androidx-startup [Initializer] that wires the Android application Context
+ * into [PayCraftPlatform] at app start — BEFORE `Application.onCreate` runs.
+ *
+ * Why this exists:
+ *
+ *   With this initializer the consumer's `Application.onCreate` only needs to
+ *   call `PayCraft.initialize(apiKey)` from commonMain. The Android-specific
+ *   Context handoff happens automatically via the AndroidX Startup framework
+ *   — no platform-specific bootstrap leaks into the consumer's androidMain.
+ *
+ * Disabling:
+ *
+ *   Most apps don't need to. If a host app wants to delay or skip the
+ *   handoff (e.g. lazy bootstrap for cold-start optimisation), they can
+ *   remove the manifest provider node via tools:node="remove":
+ *
+ *   ```xml
+ *   <provider
+ *     android:name="androidx.startup.InitializationProvider"
+ *     android:authorities="${applicationId}.androidx-startup"
+ *     android:exported="false"
+ *     tools:node="merge">
+ *     <meta-data
+ *       android:name="com.mobilebytelabs.paycraft.PayCraftInitializer"
+ *       tools:node="remove" />
+ *   </provider>
+ *   ```
+ *
+ *   …and then call `PayCraftPlatform.init(applicationContext)` themselves.
+ */
+class PayCraftInitializer : Initializer<Unit> {
+    override fun create(context: Context) {
+        PayCraftPlatform.init(context.applicationContext)
+    }
+
+    override fun dependencies(): List<Class<out Initializer<*>>> = emptyList()
+}

gradle.properties

@@ -14,6 +14,6 @@ org.jetbrains.compose.experimental.macos.enabled=true
 android.useAndroidX=true
 android.nonTransitiveRClass=true
 #Publishing
-paycraft.version=2.0.7
+paycraft.version=2.0.8
 SONATYPE_HOST=CENTRAL_PORTAL
 SONATYPE_AUTOMATIC_RELEASE=true