Colota - Android GPS Location tracker
feat: log GPS tracking heartbeat every 5 minutes for stall diagnostics
Max Dietrichf9f25446cce5
diff --git a/apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt b/apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.ktindex 0a3ff6a1..be3b37e8 100644--- a/apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt+++ b/apps/mobile/android/app/src/main/java/com/colota/service/LocationForegroundService.kt@@ -51,6 +51,8 @@ class LocationForegroundService : Service() {@Volatile private var serviceScope: CoroutineScope? = null@Volatile private var locationUpdateCallback: LocationUpdateCallback? = null@Volatile private var locationRestartJob: Job? = null+ @Volatile private var trackingHeartbeatJob: Job? = null+ @Volatile private var lastFixAtMs: Long = 0L@Volatile private var motionDetector: MotionDetector? = null@Volatile private var insidePauseZone = false@Volatile private var isWifiPaused = false@@ -77,6 +79,8 @@ class LocationForegroundService : Service() {private const val ENTRY_DELAY_MULTIPLIER = 3.5/** Debounce before resuming GPS after unmetered network is lost (ms). */private const val WIFI_RESUME_DEBOUNCE_MS = 2_000L+ /** Cadence at which the tracking heartbeat logs time-since-last-fix for diagnostics. */+ private const val TRACKING_HEARTBEAT_INTERVAL_MS = 5 * 60_000Lconst val ACTION_MANUAL_FLUSH = "com.Colota.ACTION_MANUAL_FLUSH"const val ACTION_RECHECK_ZONE = "com.Colota.RECHECK_PAUSE_ZONE"const val ACTION_REFRESH_NOTIFICATION = "com.Colota.REFRESH_NOTIFICATION"@@ -284,10 +288,12 @@ class LocationForegroundService : Service() {val callback = object : LocationUpdateCallback {override fun onLocationUpdate(location: android.location.Location) {+ lastFixAtMs = SystemClock.elapsedRealtime()handleLocationUpdate(location)}}locationUpdateCallback = callback+ lastFixAtMs = SystemClock.elapsedRealtime()if (deviceInfoHelper.isBatteryCritical(threshold = 5)) {val (level, _) = deviceInfoHelper.getCachedBatteryStatus()@@ -319,6 +325,8 @@ class LocationForegroundService : Service() {},onFailure = { /* initial location unavailable, updates will arrive */ })++ startTrackingHeartbeatLogger()} catch (e: SecurityException) {AppLogger.e(TAG, "Location permission missing", e)stopForegroundServiceWithReason("Location permission missing")@@ -329,10 +337,35 @@ class LocationForegroundService : Service() {}private fun stopLocationUpdates() {+ cancelTrackingHeartbeatLogger()locationUpdateCallback?.let { locationProvider.removeLocationUpdates(it) }locationUpdateCallback = null}+ /**+ * Diagnostic-only periodic logger. Records "time since last GPS fix" every 5 minutes+ * to the activity log so silent stalls (eg stale FLP binding after long uptime) become+ * visible in user-exported logs. Does not take any recovery action - data only.+ */+ private fun startTrackingHeartbeatLogger() {+ trackingHeartbeatJob?.cancel()+ val scope = serviceScope ?: return+ trackingHeartbeatJob = scope.launch {+ while (isActive) {+ delay(TRACKING_HEARTBEAT_INTERVAL_MS)+ if (isWifiPaused || isMotionlessPaused) continue+ if (locationUpdateCallback == null) continue+ val sinceLastFix = SystemClock.elapsedRealtime() - lastFixAtMs+ AppLogger.i(TAG, "Tracking alive: ${sinceLastFix / 1000}s since last fix")+ }+ }+ }++ private fun cancelTrackingHeartbeatLogger() {+ trackingHeartbeatJob?.cancel()+ trackingHeartbeatJob = null+ }+private fun handleZoneRecheckAction() {geofenceHelper.invalidateCache()