added auto init

Author: kibotu

README.md

@@ -10,12 +10,12 @@ Convenience library to receive user location updates and geofence events with mi
 
 - [Features](#features)
 - [Installation](#installation)
+- [Initialization](#initialization)
 - [Quick Start](#quick-start)
   - [Geofencing](#geofencing)
   - [Location Tracking](#location-tracking)
 - [API Reference](#api-reference)
 - [Permissions](#permissions)
-- [Publishing](#publishing)
 - [Contributing](#contributing)
 - [License](#license)
 
@@ -27,7 +27,7 @@ Convenience library to receive user location updates and geofence events with mi
 - Geofence transitions: enter, exit, dwell
 - Continuous location updates via `SharedFlow`
 - Survives app kill and device reboot (via WorkManager)
-- Auto-initializes with AndroidX Startup
+- Auto-initializes via built-in ContentProvider (no external dependencies)
 - Configurable update intervals, displacement, and priority
 - Custom actions for geofence and location events
 - minSdk 23, targets Android 15+
@@ -58,6 +58,47 @@ Then add the dependency:
 implementation("com.github.kibotu:geofencer:latest")
 ```
 
+## Initialization
+
+The library auto-initializes using a `ContentProvider` — no manual setup needed.
+
+### Customizing init order
+
+The `ContentProvider` uses `android:initOrder` to control initialization priority relative to other providers. The default value is `100`. Higher values mean the provider is initialized earlier.
+
+Override the priority in your app's `res/values/integers.xml` (or any values resource file):
+
+```xml
+<resources>
+    <integer name="geofencer_init_priority">200</integer>
+</resources>
+```
+
+### Disabling auto-initialization
+
+Add a boolean resource override in your app's `res/values/` to disable the `ContentProvider` from initializing the library:
+
+```xml
+<resources>
+    <bool name="geofencer_auto_init_enabled">false</bool>
+</resources>
+```
+
+Then initialize manually in your `Application.onCreate()`:
+
+```kotlin
+Geofencer.init(applicationContext)
+```
+
+Alternatively, you can remove the provider entirely via manifest merging:
+
+```xml
+<provider
+    android:name="net.kibotu.geofencer.internal.GeofencerInitializer"
+    android:authorities="${applicationId}.geofencer-init"
+    tools:node="remove" />
+```
+
 ## Quick Start
 
 ### Geofencing

geofencer/build.gradle.kts

@@ -6,6 +6,7 @@ plugins {
 
 android {
     namespace = "net.kibotu.geofencer"
+    resourcePrefix = "geofencer_"
 
     compileSdk {
         version = release(36) {
@@ -75,6 +76,5 @@ dependencies {
     implementation(libs.play.services.location)
     implementation(libs.androidx.core.ktx)
     implementation(libs.work.runtime.ktx)
-    implementation(libs.startup.runtime)
     implementation(libs.timber)
 }

geofencer/src/main/AndroidManifest.xml

@@ -34,13 +34,10 @@
         </receiver>
 
         <provider
-            android:name="androidx.startup.InitializationProvider"
-            android:authorities="${applicationId}.androidx-startup"
-            android:exported="false">
-            <meta-data
-                android:name="net.kibotu.geofencer.internal.GeofencerInitializer"
-                android:value="androidx.startup" />
-        </provider>
+            android:name="net.kibotu.geofencer.internal.GeofencerInitializer"
+            android:authorities="${applicationId}.geofencer-init"
+            android:exported="false"
+            android:initOrder="@integer/geofencer_init_priority" />
 
     </application>
 

geofencer/src/main/java/net/kibotu/geofencer/Geofencer.kt

@@ -27,7 +27,7 @@ object Geofencer {
 
     private fun requireRepository(): GeofenceRepository {
         check(::repository.isInitialized) {
-            "Geofencer not initialized. Add androidx.startup dependency or call Geofencer.init(context)."
+            "Geofencer not initialized. Ensure GeofencerInitializer ContentProvider runs or call Geofencer.init(context) manually."
         }
         return repository
     }

geofencer/src/main/java/net/kibotu/geofencer/internal/GeofencerInitializer.kt

@@ -1,15 +1,25 @@
 package net.kibotu.geofencer.internal
 
-import android.content.Context
-import androidx.startup.Initializer
+import android.content.ContentProvider
+import android.content.ContentValues
+import android.database.Cursor
+import android.net.Uri
 import net.kibotu.geofencer.Geofencer
+import net.kibotu.geofencer.R
 
-internal class GeofencerInitializer : Initializer<Geofencer> {
+internal class GeofencerInitializer : ContentProvider() {
 
-    override fun create(context: Context): Geofencer {
-        Geofencer.init(context.applicationContext)
-        return Geofencer
+    override fun onCreate(): Boolean {
+        val ctx = context?.applicationContext ?: return false
+        val enabled = ctx.resources.getBoolean(R.bool.geofencer_auto_init_enabled)
+        if (!enabled) return true
+        Geofencer.init(ctx)
+        return true
     }
 
-    override fun dependencies(): List<Class<out Initializer<*>>> = emptyList()
+    override fun query(uri: Uri, projection: Array<out String>?, selection: String?, selectionArgs: Array<out String>?, sortOrder: String?): Cursor? = null
+    override fun getType(uri: Uri): String? = null
+    override fun insert(uri: Uri, values: ContentValues?): Uri? = null
+    override fun delete(uri: Uri, selection: String?, selectionArgs: Array<out String>?): Int = 0
+    override fun update(uri: Uri, values: ContentValues?, selection: String?, selectionArgs: Array<out String>?): Int = 0
 }

geofencer/src/main/res/values/strings.xml

@@ -1,10 +1,18 @@
 <resources>
-    <plurals name="num_locations_reported">
+    <plurals name="geofencer_num_locations_reported">
         <item quantity="zero">No location reported</item>
         <item quantity="one">One location reported</item>
         <item quantity="other">%d locations reported</item>
     </plurals>
-    <string name="dialog_rationale_coarse_location">We need GPS Location in background so that we can guide you when you are at that locations</string>
-    <string name="button_allow">Allow</string>
-    <string name="button_reject">Reject</string>
+    <string name="geofencer_dialog_rationale_coarse_location">We need GPS Location in background so that we can guide you when you are at that locations</string>
+    <string name="geofencer_button_allow">Allow</string>
+    <string name="geofencer_button_reject">Reject</string>
+
+    <!-- ContentProvider init order for GeofencerInitializer.
+         Higher values = earlier initialization relative to other providers.
+         Override in your app's res/values to change priority. -->
+    <integer name="geofencer_init_priority">100</integer>
+
+    <!-- Set to false in your app's res/values to disable auto-initialization. -->
+    <bool name="geofencer_auto_init_enabled">true</bool>
 </resources>

gradle/libs.versions.toml

@@ -11,7 +11,6 @@ lifecycleRuntimeKtx = "2.10.0"
 mapsCompose = "8.2.0"
 playServicesLocation = "21.3.0"
 preferenceKtx = "1.2.1"
-startupRuntime = "1.2.0"
 timber = "5.0.1"
 vanniktechMavenPublish = "0.36.0"
 workManager = "2.10.0"
@@ -38,7 +37,6 @@ maps-compose = { group = "com.google.maps.android", name = "maps-compose", versi
 maps-compose-utils = { group = "com.google.maps.android", name = "maps-compose-utils", version.ref = "mapsCompose" }
 play-services-location = { group = "com.google.android.gms", name = "play-services-location", version.ref = "playServicesLocation" }
 preference-ktx = { group = "androidx.preference", name = "preference-ktx", version.ref = "preferenceKtx" }
-startup-runtime = { group = "androidx.startup", name = "startup-runtime", version.ref = "startupRuntime" }
 timber = { module = "com.jakewharton.timber:timber", version.ref = "timber" }
 work-runtime-ktx = { group = "androidx.work", name = "work-runtime-ktx", version.ref = "workManager" }