@josuelmm/cordova-background-geolocation 4.5.2 → 4.5.5

package/android/common/src/main/java/com/marianhello/bgloc/data/sqlite/SQLiteSessionLocationDAO.java

@@ -1,169 +1,169 @@
-package com.marianhello.bgloc.data.sqlite;
-
-import android.content.ContentValues;
-import android.content.Context;
-import android.database.Cursor;
-import android.database.sqlite.SQLiteDatabase;
-import com.marianhello.bgloc.data.BackgroundLocation;
-import com.marianhello.bgloc.data.SessionLocationDAO;
-
-import java.util.ArrayList;
-import java.util.Collection;
-
-public class SQLiteSessionLocationDAO implements SessionLocationDAO {
-
-    private static final String PREFS_NAME = "bgloc_session";
-    private static final String KEY_SESSION_ACTIVE = "session_active";
-
-    private final SQLiteDatabase db;
-    private final Context context;
-
-    public SQLiteSessionLocationDAO(Context context) {
-        this.context = context.getApplicationContext();
-        SQLiteOpenHelper helper = SQLiteOpenHelper.getHelper(this.context);
-        this.db = helper.getWritableDatabase();
-    }
-
-    @Override
-    public void startSession() {
-        db.delete(SQLiteSessionContract.SessionEntry.TABLE_NAME, null, null);
-        setSessionActive(true);
-    }
-
-    @Override
-    public void clearSession() {
-        db.delete(SQLiteSessionContract.SessionEntry.TABLE_NAME, null, null);
-        setSessionActive(false);
-    }
-
-    @Override
-    public boolean isSessionActive() {
-        return context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
-                .getBoolean(KEY_SESSION_ACTIVE, false);
-    }
-
-    private void setSessionActive(boolean active) {
-        context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
-                .edit()
-                .putBoolean(KEY_SESSION_ACTIVE, active)
-                .apply();
-    }
-
-    @Override
-    public void persistSessionLocation(BackgroundLocation location) {
-        if (!isSessionActive() || location == null) return;
-        ContentValues values = getContentValues(location);
-        db.insertOrThrow(SQLiteSessionContract.SessionEntry.TABLE_NAME,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_NULLABLE, values);
-    }
-
-    @Override
-    public Collection<BackgroundLocation> getSessionLocations() {
-        Collection<BackgroundLocation> locations = new ArrayList<>();
-        String orderBy = SQLiteSessionContract.SessionEntry.COLUMN_NAME_TIME + " ASC";
-        Cursor cursor = null;
-        try {
-            cursor = db.query(
-                    SQLiteSessionContract.SessionEntry.TABLE_NAME,
-                    queryColumns(),
-                    null, null, null, null, orderBy);
-            while (cursor.moveToNext()) {
-                locations.add(hydrate(cursor));
-            }
-        } finally {
-            if (cursor != null) cursor.close();
-        }
-        return locations;
-    }
-
-    @Override
-    public int getSessionLocationsCount() {
-        Cursor cursor = null;
-        try {
-            cursor = db.rawQuery("SELECT COUNT(*) FROM " + SQLiteSessionContract.SessionEntry.TABLE_NAME, null);
-            return cursor.moveToFirst() ? cursor.getInt(0) : 0;
-        } finally {
-            if (cursor != null) cursor.close();
-        }
-    }
-
-    private BackgroundLocation hydrate(Cursor c) {
-        BackgroundLocation l = new BackgroundLocation(c.getString(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_PROVIDER)));
-        l.setTime(c.getLong(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_TIME)));
-        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ACCURACY)) == 1) {
-            l.setAccuracy(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_ACCURACY)));
-        }
-        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_VERTICAL_ACCURACY)) == 1) {
-            l.setVerticalAccuracy(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_VERTICAL_ACCURACY)));
-        }
-        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_SPEED)) == 1) {
-            l.setSpeed(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_SPEED)));
-        }
-        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_BEARING)) == 1) {
-            l.setBearing(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_BEARING)));
-        }
-        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ALTITUDE)) == 1) {
-            l.setAltitude(c.getDouble(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_ALTITUDE)));
-        }
-        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_RADIUS)) == 1) {
-            l.setRadius(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_RADIUS)));
-        }
-        l.setLatitude(c.getDouble(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LATITUDE)));
-        l.setLongitude(c.getDouble(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LONGITUDE)));
-        l.setLocationProvider(c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LOCATION_PROVIDER)));
-        l.setLocationId(c.getLong(c.getColumnIndex(SQLiteSessionContract.SessionEntry._ID)));
-        l.setMockFlags(c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_MOCK_FLAGS)));
-        return l;
-    }
-
-    private ContentValues getContentValues(BackgroundLocation l) {
-        ContentValues values = new ContentValues();
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_PROVIDER, l.getProvider());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_TIME, l.getTime());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_ACCURACY, l.getAccuracy());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_VERTICAL_ACCURACY, l.getVerticalAccuracy());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_SPEED, l.getSpeed());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_BEARING, l.getBearing());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_ALTITUDE, l.getAltitude());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_RADIUS, l.getRadius());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LATITUDE, l.getLatitude());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LONGITUDE, l.getLongitude());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ACCURACY, l.hasAccuracy() ? 1 : 0);
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_VERTICAL_ACCURACY, l.hasVerticalAccuracy() ? 1 : 0);
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_SPEED, l.hasSpeed() ? 1 : 0);
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_BEARING, l.hasBearing() ? 1 : 0);
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ALTITUDE, l.hasAltitude() ? 1 : 0);
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_RADIUS, l.hasRadius() ? 1 : 0);
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LOCATION_PROVIDER, l.getLocationProvider());
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_STATUS, 0);
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_BATCH_START_MILLIS, 0L);
-        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_MOCK_FLAGS, l.getMockFlags());
-        return values;
-    }
-
-    private String[] queryColumns() {
-        return new String[]{
-                SQLiteSessionContract.SessionEntry._ID,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_PROVIDER,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_TIME,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_ACCURACY,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_VERTICAL_ACCURACY,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_SPEED,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_BEARING,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_ALTITUDE,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_RADIUS,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_LATITUDE,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_LONGITUDE,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ACCURACY,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_VERTICAL_ACCURACY,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_SPEED,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_BEARING,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ALTITUDE,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_RADIUS,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_LOCATION_PROVIDER,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_STATUS,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_BATCH_START_MILLIS,
-                SQLiteSessionContract.SessionEntry.COLUMN_NAME_MOCK_FLAGS
-        };
-    }
-}
+package com.marianhello.bgloc.data.sqlite;
+
+import android.content.ContentValues;
+import android.content.Context;
+import android.database.Cursor;
+import android.database.sqlite.SQLiteDatabase;
+import com.marianhello.bgloc.data.BackgroundLocation;
+import com.marianhello.bgloc.data.SessionLocationDAO;
+
+import java.util.ArrayList;
+import java.util.Collection;
+
+public class SQLiteSessionLocationDAO implements SessionLocationDAO {
+
+    private static final String PREFS_NAME = "bgloc_session";
+    private static final String KEY_SESSION_ACTIVE = "session_active";
+
+    private final SQLiteDatabase db;
+    private final Context context;
+
+    public SQLiteSessionLocationDAO(Context context) {
+        this.context = context.getApplicationContext();
+        SQLiteOpenHelper helper = SQLiteOpenHelper.getHelper(this.context);
+        this.db = helper.getWritableDatabase();
+    }
+
+    @Override
+    public void startSession() {
+        db.delete(SQLiteSessionContract.SessionEntry.TABLE_NAME, null, null);
+        setSessionActive(true);
+    }
+
+    @Override
+    public void clearSession() {
+        db.delete(SQLiteSessionContract.SessionEntry.TABLE_NAME, null, null);
+        setSessionActive(false);
+    }
+
+    @Override
+    public boolean isSessionActive() {
+        return context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
+                .getBoolean(KEY_SESSION_ACTIVE, false);
+    }
+
+    private void setSessionActive(boolean active) {
+        context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
+                .edit()
+                .putBoolean(KEY_SESSION_ACTIVE, active)
+                .apply();
+    }
+
+    @Override
+    public void persistSessionLocation(BackgroundLocation location) {
+        if (!isSessionActive() || location == null) return;
+        ContentValues values = getContentValues(location);
+        db.insertOrThrow(SQLiteSessionContract.SessionEntry.TABLE_NAME,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_NULLABLE, values);
+    }
+
+    @Override
+    public Collection<BackgroundLocation> getSessionLocations() {
+        Collection<BackgroundLocation> locations = new ArrayList<>();
+        String orderBy = SQLiteSessionContract.SessionEntry.COLUMN_NAME_TIME + " ASC";
+        Cursor cursor = null;
+        try {
+            cursor = db.query(
+                    SQLiteSessionContract.SessionEntry.TABLE_NAME,
+                    queryColumns(),
+                    null, null, null, null, orderBy);
+            while (cursor.moveToNext()) {
+                locations.add(hydrate(cursor));
+            }
+        } finally {
+            if (cursor != null) cursor.close();
+        }
+        return locations;
+    }
+
+    @Override
+    public int getSessionLocationsCount() {
+        Cursor cursor = null;
+        try {
+            cursor = db.rawQuery("SELECT COUNT(*) FROM " + SQLiteSessionContract.SessionEntry.TABLE_NAME, null);
+            return cursor.moveToFirst() ? cursor.getInt(0) : 0;
+        } finally {
+            if (cursor != null) cursor.close();
+        }
+    }
+
+    private BackgroundLocation hydrate(Cursor c) {
+        BackgroundLocation l = new BackgroundLocation(c.getString(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_PROVIDER)));
+        l.setTime(c.getLong(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_TIME)));
+        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ACCURACY)) == 1) {
+            l.setAccuracy(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_ACCURACY)));
+        }
+        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_VERTICAL_ACCURACY)) == 1) {
+            l.setVerticalAccuracy(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_VERTICAL_ACCURACY)));
+        }
+        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_SPEED)) == 1) {
+            l.setSpeed(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_SPEED)));
+        }
+        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_BEARING)) == 1) {
+            l.setBearing(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_BEARING)));
+        }
+        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ALTITUDE)) == 1) {
+            l.setAltitude(c.getDouble(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_ALTITUDE)));
+        }
+        if (c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_RADIUS)) == 1) {
+            l.setRadius(c.getFloat(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_RADIUS)));
+        }
+        l.setLatitude(c.getDouble(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LATITUDE)));
+        l.setLongitude(c.getDouble(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LONGITUDE)));
+        l.setLocationProvider(c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LOCATION_PROVIDER)));
+        l.setLocationId(c.getLong(c.getColumnIndex(SQLiteSessionContract.SessionEntry._ID)));
+        l.setMockFlags(c.getInt(c.getColumnIndex(SQLiteSessionContract.SessionEntry.COLUMN_NAME_MOCK_FLAGS)));
+        return l;
+    }
+
+    private ContentValues getContentValues(BackgroundLocation l) {
+        ContentValues values = new ContentValues();
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_PROVIDER, l.getProvider());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_TIME, l.getTime());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_ACCURACY, l.getAccuracy());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_VERTICAL_ACCURACY, l.getVerticalAccuracy());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_SPEED, l.getSpeed());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_BEARING, l.getBearing());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_ALTITUDE, l.getAltitude());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_RADIUS, l.getRadius());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LATITUDE, l.getLatitude());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LONGITUDE, l.getLongitude());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ACCURACY, l.hasAccuracy() ? 1 : 0);
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_VERTICAL_ACCURACY, l.hasVerticalAccuracy() ? 1 : 0);
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_SPEED, l.hasSpeed() ? 1 : 0);
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_BEARING, l.hasBearing() ? 1 : 0);
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ALTITUDE, l.hasAltitude() ? 1 : 0);
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_RADIUS, l.hasRadius() ? 1 : 0);
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_LOCATION_PROVIDER, l.getLocationProvider());
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_STATUS, 0);
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_BATCH_START_MILLIS, 0L);
+        values.put(SQLiteSessionContract.SessionEntry.COLUMN_NAME_MOCK_FLAGS, l.getMockFlags());
+        return values;
+    }
+
+    private String[] queryColumns() {
+        return new String[]{
+                SQLiteSessionContract.SessionEntry._ID,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_PROVIDER,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_TIME,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_ACCURACY,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_VERTICAL_ACCURACY,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_SPEED,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_BEARING,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_ALTITUDE,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_RADIUS,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_LATITUDE,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_LONGITUDE,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ACCURACY,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_VERTICAL_ACCURACY,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_SPEED,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_BEARING,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_ALTITUDE,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_HAS_RADIUS,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_LOCATION_PROVIDER,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_STATUS,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_BATCH_START_MILLIS,
+                SQLiteSessionContract.SessionEntry.COLUMN_NAME_MOCK_FLAGS
+        };
+    }
+}

package/android/common/src/main/java/com/marianhello/bgloc/provider/AbstractLocationProvider.java

@@ -89,7 +89,7 @@ public abstract class AbstractLocationProvider implements LocationProvider {
     }
 
     /**
-     * v4.5.2: drop fixes whose horizontal accuracy is worse than the configured
+     * v4.5.4: drop fixes whose horizontal accuracy is worse than the configured
      * maxAcceptedAccuracy threshold. Returns true when the location must be
      * discarded.
      */
@@ -169,7 +169,7 @@ public abstract class AbstractLocationProvider implements LocationProvider {
     }
 
     /**
-     * v4.5.2: emit a permission-denied error to the delegate (used when a runtime
+     * v4.5.4: emit a permission-denied error to the delegate (used when a runtime
      * permission such as ACTIVITY_RECOGNITION is missing on Android 10+).
      */
     protected void handlePermissionDenied(String message) {
@@ -179,7 +179,7 @@ public abstract class AbstractLocationProvider implements LocationProvider {
     }
 
     /**
-     * v4.5.2: emit a service-level error to the delegate (used when Google Play
+     * v4.5.4: emit a service-level error to the delegate (used when Google Play
      * Services is missing/outdated or the OS location service is disabled).
      */
     protected void handleServiceError(String message) {
@@ -195,7 +195,7 @@ public abstract class AbstractLocationProvider implements LocationProvider {
     }
 
     public Boolean hasMockLocationsEnabled() {
-        // v4.5.2: Settings.Secure.getString may return null (key absent on the
+        // v4.5.4: Settings.Secure.getString may return null (key absent on the
         // device's settings provider). The previous code crashed with NPE because
         // it called .equals("1") on the returned value. Invert the comparison so
         // null safely yields false.

package/android/common/src/main/java/com/marianhello/bgloc/provider/ActivityRecognitionLocationProvider.java

@@ -48,7 +48,7 @@ public class ActivityRecognitionLocationProvider extends AbstractLocationProvide
     private boolean stopOnStillWarningEmitted = false;
     private DetectedActivity lastActivity = new DetectedActivity(DetectedActivity.UNKNOWN, 100);
 
-    // v4.5.2: snapshot of fields that require restarting tracking when they change.
+    // v4.5.4: snapshot of fields that require restarting tracking when they change.
     private Integer prevDesiredAccuracy;
     private Integer prevInterval;
     private Integer prevFastestInterval;
@@ -77,7 +77,7 @@ public class ActivityRecognitionLocationProvider extends AbstractLocationProvide
     public void onCreate() {
         super.onCreate();
 
-        // v4.5.2: ACTIVITY_PROVIDER strictly depends on Google Play Services
+        // v4.5.4: ACTIVITY_PROVIDER strictly depends on Google Play Services
         // (FusedLocationProviderClient + ActivityRecognitionClient). If GPS is
         // missing/outdated we cannot operate — surface a clear error instead of
         // silently failing.
@@ -108,7 +108,7 @@ public class ActivityRecognitionLocationProvider extends AbstractLocationProvide
         logger.info("Start recording");
         this.isStarted = true;
 
-        // v4.5.2: ACTIVITY_PROVIDER hinges on the STILL/ACTIVE state machine.
+        // v4.5.4: ACTIVITY_PROVIDER hinges on the STILL/ACTIVE state machine.
         // If the host turned that off, the provider degenerates into a tracker
         // that never pauses — warn so it shows up in logcat for the integrator.
         if (mConfig != null && Boolean.FALSE.equals(mConfig.getStopOnStillActivity()) && !stopOnStillWarningEmitted) {
@@ -129,7 +129,7 @@ public class ActivityRecognitionLocationProvider extends AbstractLocationProvide
 
     @Override
     public void onConfigure(Config config) {
-        // v4.5.2: only restart tracking if a field that actually affects the
+        // v4.5.4: only restart tracking if a field that actually affects the
         // LocationRequest / activity-updates subscription has changed. A no-op
         // reconfigure used to drop+re-add the location callback and momentarily
         // leave the service without updates.
@@ -204,7 +204,7 @@ public class ActivityRecognitionLocationProvider extends AbstractLocationProvide
         int priority = translateDesiredAccuracy(mConfig.getDesiredAccuracy());
         // v3.4: LocationRequest.Builder (play-services-location 21.0.0+) replaces deprecated
         // LocationRequest.create() + setPriority/setInterval/setFastestInterval.
-        // v4.5.2: also honor distanceFilter (was ignored on ACTIVITY_PROVIDER), so the
+        // v4.5.4: also honor distanceFilter (was ignored on ACTIVITY_PROVIDER), so the
         // FusedLocationProvider can throttle by distance and not just by interval.
         LocationRequest.Builder builder = new LocationRequest.Builder(priority, mConfig.getInterval())
                 .setMinUpdateIntervalMillis(mConfig.getFastestInterval())
@@ -257,7 +257,7 @@ public class ActivityRecognitionLocationProvider extends AbstractLocationProvide
         startTracking();
 
         if (!isWatchingActivity && mConfig.getStopOnStillActivity()) {
-            // v4.5.2: on Android 10+ ACTIVITY_RECOGNITION is a runtime permission.
+            // v4.5.4: on Android 10+ ACTIVITY_RECOGNITION is a runtime permission.
             // Without it, requestActivityUpdates() silently returns no broadcasts and
             // STILL/ACTIVE never flips — the provider then runs as a continuous tracker
             // by accident. Emit a one-shot error so the host app knows to request it.
@@ -341,7 +341,7 @@ public class ActivityRecognitionLocationProvider extends AbstractLocationProvide
 
             DetectedActivity candidate = getProbableActivity(detectedActivities);
 
-            // v4.5.2: skip transitions whose confidence is below the configured
+            // v4.5.4: skip transitions whose confidence is below the configured
             // threshold (default 50). Prevents jittery STILL/ACTIVE flips when the
             // motion classifier is unsure — which translated into spurious GPS
             // start/stop bursts in earlier versions.

package/android/common/src/main/java/com/marianhello/bgloc/provider/DistanceFilterLocationProvider.java

@@ -33,7 +33,7 @@ import static java.lang.Math.round;
 
 
 /**
- * v4.5.2 — Distance-filter provider with a runtime-chosen backend:
+ * v4.5.4 — Distance-filter provider with a runtime-chosen backend:
  * <ul>
  *   <li><b>Fused path</b> (Play Services available): {@link FusedLocationProviderClient}
  *       + {@link LocationCallback}. Better fused GPS+Network blending and battery.</li>
@@ -61,7 +61,7 @@ public class DistanceFilterLocationProvider extends AbstractLocationProvider imp
     private static final int MAX_STATIONARY_ACQUISITION_ATTEMPTS = 5;
     private static final int MAX_SPEED_ACQUISITION_ATTEMPTS = 3;
 
-    // v4.5.2 — Aggressive interval used while acquiring stationary location or speed (FLP path).
+    // v4.5.4 — Aggressive interval used while acquiring stationary location or speed (FLP path).
     private static final long ACQUISITION_INTERVAL_MS = 1000L;
 
     private Boolean isMoving = false;
@@ -144,7 +144,7 @@ public class DistanceFilterLocationProvider extends AbstractLocationProvider imp
         locationManager = (LocationManager) mContext.getSystemService(Context.LOCATION_SERVICE);
         alarmManager = (AlarmManager) mContext.getSystemService(Context.ALARM_SERVICE);
 
-        // v4.5.2 — pick the location backend at runtime. Play Services missing
+        // v4.5.4 — pick the location backend at runtime. Play Services missing
         // (Huawei/HMS, AOSP, China ROMs) → use the OS LocationManager so the
         // provider still works.
         int gps = GoogleApiAvailability.getInstance().isGooglePlayServicesAvailable(mContext);
@@ -159,7 +159,7 @@ public class DistanceFilterLocationProvider extends AbstractLocationProvider imp
         int updateCurrentFlag = Build.VERSION.SDK_INT >= Build.VERSION_CODES.S
                 ? PendingIntent.FLAG_UPDATE_CURRENT | PendingIntent.FLAG_IMMUTABLE
                 : PendingIntent.FLAG_UPDATE_CURRENT;
-        // v4.5.2: singleUpdatePI must be MUTABLE on API 31+ because
+        // v4.5.4: singleUpdatePI must be MUTABLE on API 31+ because
         // LocationManager.requestSingleUpdate() fills the resulting Location
         // into the intent's extras at delivery time. FLAG_IMMUTABLE blocks that
         // population, so the receiver would never see the fix.
@@ -389,7 +389,7 @@ public class DistanceFilterLocationProvider extends AbstractLocationProvider imp
                     }
                 }
             } else {
-                // v4.5.2 — subscribe to GPS AND Network simultaneously when both
+                // v4.5.4 — subscribe to GPS AND Network simultaneously when both
                 // are available. The previous version only used GPS-or-Network
                 // (excluyente), which on cheap/vehicular Androids could leave the
                 // app waiting for a GPS fix while a quick Network fix was available.
@@ -438,7 +438,7 @@ public class DistanceFilterLocationProvider extends AbstractLocationProvider imp
     @Override
     public void onProviderDisabled(String provider) {
         logger.warn("Provider {} was disabled", provider);
-        // v4.5.2: surface as an error so JS layer can prompt the user to enable
+        // v4.5.4: surface as an error so JS layer can prompt the user to enable
         // location services. Only when no fallback provider is left.
         if (locationManager != null && pickProvider() == null) {
             handleServiceError("Location provider '" + provider + "' disabled and no fallback available.");
@@ -523,7 +523,7 @@ public class DistanceFilterLocationProvider extends AbstractLocationProvider imp
     }
 
     /**
-     * v4.5.2 — Stop active updates and start the polling-based stationary monitor.
+     * v4.5.4 — Stop active updates and start the polling-based stationary monitor.
      * The previous version also called {@code addProximityAlert} (geofence); that
      * path has been removed per product decision (no geofencing).
      */

package/android/common/src/main/java/com/marianhello/bgloc/provider/RawLocationProvider.java

@@ -14,7 +14,7 @@ import java.util.List;
 public class RawLocationProvider extends AbstractLocationProvider implements LocationListener {
     private LocationManager locationManager;
     private boolean isStarted = false;
-    // v4.5.2: providers we actively subscribed to (so we can unsubscribe cleanly).
+    // v4.5.4: providers we actively subscribed to (so we can unsubscribe cleanly).
     private final List<String> activeProviders = new ArrayList<>(2);
 
     public RawLocationProvider(Context context) {
@@ -42,7 +42,7 @@ public class RawLocationProvider extends AbstractLocationProvider implements Loc
             logger.warn("RawLocationProvider started without config");
             return;
         }
-        // v4.5.2: honor desiredAccuracy and subscribe to all suitable providers
+        // v4.5.4: honor desiredAccuracy and subscribe to all suitable providers
         // simultaneously (GPS + Network when available). Previously RAW only
         // used GPS-or-Network and ignored desiredAccuracy.
         List<String> providers = pickProviders();
@@ -67,7 +67,7 @@ public class RawLocationProvider extends AbstractLocationProvider implements Loc
     }
 
     /**
-     * v4.5.2: choose providers based on desiredAccuracy.
+     * v4.5.4: choose providers based on desiredAccuracy.
      * <ul>
      *   <li>&lt; 1000 m → include GPS when enabled (HIGH / BALANCED)</li>
      *   <li>≥ 10 m → include Network when enabled (covers indoor and quick fixes)</li>
@@ -111,7 +111,7 @@ public class RawLocationProvider extends AbstractLocationProvider implements Loc
             return;
         }
         try {
-            // v4.5.2: removeUpdates(this) detaches us from every provider we
+            // v4.5.4: removeUpdates(this) detaches us from every provider we
             // subscribed to via the same LocationListener.
             locationManager.removeUpdates(this);
         } catch (SecurityException e) {
@@ -158,7 +158,7 @@ public class RawLocationProvider extends AbstractLocationProvider implements Loc
     @Override
     public void onProviderDisabled(String provider) {
         logger.warn("Provider {} was disabled", provider);
-        // v4.5.2: emit SERVICE error when no fallback provider is available so
+        // v4.5.4: emit SERVICE error when no fallback provider is available so
         // the JS layer can re-prompt the user. Matches DISTANCE_FILTER provider
         // behavior.
         if (locationManager != null && pickProvider() == null) {