Enable background location updates on AppleLocationEngine (#166)

* fix: Enable background location updates

* feat: Parameterize background location updates to avoid forcing users to use them

* chore: Update version to v.5.0.0-pre7 and update changelog

Author: sotomski

CHANGELOG.md

@@ -3,6 +3,10 @@ Changelog for the MapLibre Navigation SDK for Android
 
 MapLibre welcomes participation and contributions from everyone.
 
+### v5.0.0-pre7 - Jun 18, 2025
+
+- Fix AppleLocationEngine by enabling background location updates [#166](https://github.com/maplibre/maplibre-navigation-android/pull/166)
+
 ### v5.0.0-pre6 - Jun 13, 2025
 
 - Fix crash on MapFpsDelegate, caused by null modifier [#141](https://github.com/maplibre/maplibre-navigation-android/issues/141)

VERSION

@@ -1 +1 @@
-5.0.0-pre6
+5.0.0-pre7

maplibre-navigation-core/src/iosMain/kotlin/org/maplibre/navigation/core/location/engine/AppleLocationEngine.kt

@@ -30,11 +30,12 @@ import platform.CoreLocation.CLLocation as AppleLocation
  * location. You can define a timeout for this request in the constructor.
  *
  * @param getLocationTimeout The maximum duration to wait for the one-time location request.
+ * @param enableBackgroundLocationUpdates Enables CLLocationManager's background location updates.
  */
-open class AppleLocationEngine(private val getLocationTimeout: Duration) :
+open class AppleLocationEngine(private val getLocationTimeout: Duration, private val enableBackgroundLocationUpdates: Boolean) :
     LocationEngine {
 
-    constructor() : this(getLocationTimeout = 5.seconds)
+    constructor() : this(getLocationTimeout = 5.seconds, enableBackgroundLocationUpdates = true)
 
     /**
      * A [MutableStateFlow] that holds the current location or null if no location was emitted yet.
@@ -50,6 +51,7 @@ open class AppleLocationEngine(private val getLocationTimeout: Duration) :
      * The underlying CLLocationManager instance used to fetch location updates.
      */
     private val locationManager = CLLocationManager().also { locationManager ->
+        locationManager.allowsBackgroundLocationUpdates = enableBackgroundLocationUpdates
         locationManager.delegate = locationDelegate
     }
 
@@ -89,7 +91,9 @@ open class AppleLocationEngine(private val getLocationTimeout: Duration) :
     private suspend fun getLocation(timeout: Duration): Location? = withContext(Dispatchers.Main) {
         withTimeoutOrNull(timeout) {
             suspendCancellableCoroutine { continuation ->
-                val locationManager = CLLocationManager()
+                val locationManager = CLLocationManager().also {
+                    it.allowsBackgroundLocationUpdates = enableBackgroundLocationUpdates
+                }
                 locationManager.delegate = object : NSObject(), CLLocationManagerDelegateProtocol {
                     /**
                      * Called when the location manager updates the location.