tracelet_android 1.2.0 changelog

1.2.0 #

CHORE: Version bump for federation consistency with tracelet_platform_interface 1.2.0 (new NotificationPriority and HashAlgorithm enums).

1.1.0 #

New Features #

FEAT: Add native DeltaEncoder (Kotlin) for delta-compressed HTTP sync payloads — mirrors the Dart implementation exactly for platform consistency. Encodes only field deltas between consecutive locations using shortened keys (la, lo, t, s, h, a, al, b), achieving 60–80% bandwidth reduction. Uses java.time.Instant for ISO 8601 timestamp parsing with flexible numeric type coercion.
FEAT: ConfigManager now reads and applies the following new configuration fields from Dart: batteryBudgetPerHour (adaptive battery budget target), enableSparseUpdates, sparseDistanceThreshold, sparseMaxIdleSeconds (app-level deduplication), enableDeadReckoning, deadReckoningActivationDelay, deadReckoningMaxDuration (inertial navigation when GPS lost), enableDeltaCompression, deltaCoordinatePrecision (HTTP delta encoding), and disableAutoSyncOnCellular (WiFi-only sync).
FEAT: HttpSyncManager now supports disableAutoSyncOnCellular — skips auto-sync when device is on cellular network, syncing only on WiFi. Also conditionally applies DeltaEncoder.encode() to multi-location batches before HTTP upload when enableDeltaCompression is enabled, reducing upload size by 60–80%.

1.0.2 #

FIX: destroyAll() unconditionally removed geofence registrations from Play Services even when stopOnTerminate: false was configured with trackingMode=1 (geofence mode). Geofences now survive app termination and are re-registered on boot/task-removal (#23).

1.0.1 #

FIX: HTTP auto-sync never triggered from automatic location tracking — onLocationInserted() was only called from the manual insertLocation handler, not from LocationEngine.persistLocationIfAllowed() (#21).
FIX: PeriodicLocationWorker now triggers HTTP auto-sync after each periodic location insert.

1.0.0 #

🎉 Stable Release #

FEAT: First stable release of tracelet_android.
DOCS: Add Play Store background location declaration guide.
REFACTOR: Remove third-party company name references.
All native Android APIs are finalized and production-ready.

0.12.0 #

Performance Audit — 29 Android issues resolved #

PERF: Add 10-minute wakelock timeout to prevent indefinite CPU wake (A-C1).
PERF: Cache battery info with 30s TTL — eliminates sticky broadcast IPC per location (A-C2).
PERF: Replace N+1 audit trail verification with JOIN query (A-C3).
PERF: Add in-memory privacy zone cache with CRUD invalidation (A-C4).
PERF: Add in-memory geofence cache with CRUD invalidation (A-C5).
PERF: Cache SimpleDateFormat as static isoFormatter (A-H1).
PERF: Throttle DB pruning to every 100 inserts instead of every insert (A-H2, A-H3).
PERF: Add @Volatile to isRunning in LocationService (A-H4).
PERF: Add @Volatile to sync flags in HttpSyncManager (A-H5).
PERF: Use ThreadLocal<MessageDigest> for thread-safe SHA-256 (A-H6).
PERF: Use cached location for heartbeat events instead of activating GPS (A-H7).
PERF: Remove duplicate flat keys from platform channel location maps (A-H8).
PERF: Add LIMIT 5000 to getLog() query (A-H9).
PERF: Singleton ConfigManager with double-checked locking (A-M1).
PERF: Add Locale.US to all String.format() in buildCanonicalString() (A-M2).
PERF: Pre-compiled hex lookup table for SHA-256 byte-to-hex conversion (A-M3).
PERF: Smart config restart — only restart location engine when location-relevant keys change (A-M4).
PERF: Rely on wakelock auto-release timeout in BootReceiver (A-M5).
PERF: Use ConcurrentHashMap.newKeySet() for activeGeofenceIds (A-M6).
PERF: Track insert count to avoid SELECT COUNT(*) for auto-sync threshold (A-M7).
PERF: Add created_at index on locations table (DB v5) (A-M8).
PERF: Apply deferTime to LocationRequest.setMaxUpdateDelayMillis() (A-M9).
PERF: Add @Volatile to consecutiveStillSamples in MotionDetector (A-M10).
PERF: Resolve cursor column indices once before loop in cursorToLocationList() (A-L1).
PERF: Use equals(ignoreCase = true) instead of uppercase() allocation in logger (A-L2).
PERF: Remove unnecessary toMutableMap() in watchPosition() (A-L3).
PERF: Extract ParsedSchedule data class to deduplicate schedule parsing (A-L4).
PERF: Use setOf() instead of listOf() for OEM manufacturer detection (A-L6).
REFACTOR: Remove trivial isMoreRestrictive() wrapper, inline isActionMoreRestrictive() call.
CHORE: Bump DB version from 4 to 5 (v4→v5 migration adds created_at index).

0.11.5 #

FIX: Persist polygon geofence vertices to SQLite — add vertices TEXT column, DB migration v3→v4, and JSON serialization/deserialization in insertGeofence()/cursorToGeofence().
FIX: Skip malformed vertex entries instead of coercing invalid coordinates to 0.0; require ≥ 3 valid vertices for polygon storage.
TEST: Add Robolectric tests for geofence vertices CRUD (11 tests covering round-trip, validation, edge cases).
TEST: Add DB migration integration tests — v3→v4 and v1→v4 upgrade paths, existing data preservation, fresh install.

0.11.4 #

CHORE: Version bump for platform consistency.

0.11.3 #

FIX: Add ACCESS_BACKGROUND_LOCATION permission checks to all killed-state restart paths — BootReceiver, LocationService.onTaskRemoved(), LocationService.startBootTracking(), PeriodicAlarmReceiver, and PeriodicLocationWorker. Prevents "While In Use" permission from triggering tracking in killed/boot state.
FEAT: New hasBackgroundPermission() utility on LocationEngine for proactive background permission verification.

0.11.2 #

CHORE: Tighten tracelet_platform_interface constraint to ^0.11.2.

0.11.1 #

FIX: Auto-select exact alarms for periodic intervals < 15 min without foreground service.
FIX: Re-scheduling chain in PeriodicLocationWorker.doWork() now uses interval < 900 auto-detect to match initial scheduling strategy.
FIX: Doze-safe alarm fallback — changed set() to setAndAllowWhileIdle() in scheduleExactAlarm().
FIX: Re-wire EventDispatcher in onAttachedToEngine() when periodic mode is already active (fixes null dispatcher after process restart).
FIX: Preserve periodic alarms in destroyAll() when stopOnTerminate=false and periodic tracking is active.
FEAT: Add canScheduleExactAlarms and openExactAlarmSettings method channel handlers.
CHORE: Bump platform interface to 0.11.1.

0.11.0 #

FEAT: AuditTrailManager — SHA-256 hash chain with SQLite persistence and SharedPreferences chain state.
FEAT: PrivacyZoneManager — Haversine distance-based zone evaluation with exclude, degrade, and event-only actions.
FEAT: Privacy zones database table with CRUD operations (v2→v3 migration).
FEAT: Audit trail database table with hash chain linkage.
FEAT: ConfigManager getters for audit and privacy zone configuration.
CHORE: Bump tracelet_platform_interface to ^0.11.0.

0.10.0 #

FEAT: Periodic mode — GPS-friendly interval tracking via startPeriodic(). Three scheduling strategies: WorkManager (default), foreground service, and exact alarms.
FEAT: PeriodicLocationWorker — WorkManager CoroutineWorker for one-shot GPS fixes with automatic SQLite persistence and EventChannel/headless dispatch.
FEAT: PeriodicAlarmReceiver — BroadcastReceiver for AlarmManager exact alarm chaining when periodicUseExactAlarms: true.
FEAT: SCHEDULE_EXACT_ALARM permission with graceful fallback to inexact alarms on Android 13+.
FIX: TraceletAndroidPluginTest — make mainHandler lazy to avoid RuntimeException in plain JUnit tests.
CHORE: Bump tracelet_platform_interface to ^0.10.0.

0.9.1 #

FIX: Fire heartbeat events in boot-mode headless tracking. LocationService.startBootTracking() now starts a self-rescheduling heartbeat timer so heartbeat events dispatch to HeadlessTaskService after device reboot.

0.9.0 #

FEAT: HTTP sync retry engine — configurable retry with exponential backoff for transient 5xx, 429, and timeout failures. Respects Retry-After headers. Defers sync on connectivity loss.
FEAT: Configurable motion sensitivity — MotionDetector reads shakeThreshold, stillThreshold, stillSampleCount from ConfigManager at runtime instead of hardcoded constants.
FIX: HTTP 429 (Too Many Requests) now correctly treated as transient (was previously treated as permanent failure).
FIX: Added REQUEST_IGNORE_BATTERY_OPTIMIZATIONS permission to AndroidManifest.xml for battery exemption settings.
CHORE: Bump tracelet_platform_interface to ^0.9.0.

0.8.3 #

FEAT: Proximity-based geofence auto-load/unload — only geofences within geofenceProximityRadius are registered with the OS, sorted by distance, capped at 100 (Android limit). Enables monitoring thousands of geofences.
FEAT: GeofenceManager.updateProximity() — re-evaluates which geofences to monitor on every location update, dynamically swapping registrations as the device moves.
FEAT: geofencesChange event fires with on/off arrays when geofences are activated/deactivated from proximity monitoring.
FEAT: maxMonitoredGeofences config respected — caps simultaneously monitored geofences below the platform limit.
CHORE: Bump tracelet_platform_interface to ^0.8.3.

0.8.2 #

DOCS: Improve README visuals with combined Android & iOS demo image.

0.8.1 #

DOCS: Document iOS background hardening changes (no Android code changes in this release).

0.8.0 #

FEAT: OemCompat utility — comprehensive OEM compatibility layer with manufacturer detection (Huawei, Xiaomi, OnePlus, Samsung, Oppo, Vivo), aggression ratings (0–5), and OEM-specific settings deep-links.
FEAT: Huawei PowerGenie wakelock hack — uses LocationManagerService wakelock tag to bypass PowerGenie background killing.
FEAT: Xiaomi autostart detection — runtime check for MIUI autostart management activity availability.
FEAT: OEM settings deep-links — 8 manufacturer-specific settings screens (autostart, battery saver, app launch, protected apps) validated via PackageManager.resolveActivity().
FEAT: getSettingsHealth method channel handler — returns full device OEM health map.
FEAT: openOemSettings method channel handler — launches OEM settings by label.
PERF: OEM-safe wakelock lifecycle in LocationService — acquire on start, release on stop/destroy/taskRemoved.
PERF: Boot receiver wakelock — temporary 60-second wakelock during BOOT_COMPLETED processing to survive aggressive OEM process killing.
CHORE: ProGuard/R8 consumer rules (consumer-rules.pro) — prevents stripping of services, receivers, Room entities, and Kotlin metadata in release builds.
DOCS: Update README with OEM compatibility feature and documentation link.
CHORE: Bump tracelet_platform_interface to ^0.8.0.

0.7.1 #

DOCS: Add mock location detection feature to README with platform-specific detection details.
CHORE: Bump tracelet_platform_interface to ^0.7.1.

0.7.0 #

FEAT: Mock location detection — isLocationMock() uses Location.isMock() (API 31+) and isFromMockProvider() (API 18+) to flag spoofed GPS.
FEAT: Heuristic mock detection (level 2) — satellite count check (< 4 = suspicious) and SystemClock.elapsedRealtimeNanos drift detection (> 5s = suspicious).
FEAT: enrichLocation() includes mock flag and mockHeuristics metadata map (satellites, elapsedRealtimeDriftMs, platformFlagMock).
FEAT: Native-level mock rejection — when rejectMockLocations is enabled, drops mocked locations before sending to Dart and fires ProviderChangeEvent.mockLocationsDetected.
FEAT: ConfigManager.getMockDetectionLevel() and getRejectMockLocations() getters.
CHORE: Bump tracelet_platform_interface to ^0.7.0.

0.6.1 #

REFACTOR: Remove 6 dead ConfigManager constants and methods for filtering migrated to Dart in 0.6.0 (getDisableElasticity, getElasticityMultiplier, getFilterPolicy, getMaxImpliedSpeed, getTrackingAccuracyThreshold, getUseKalmanFilter).
REFACTOR: Remove dead EventDispatcher.sendTrip() and "trip" channel registration — trip events now from Dart TripManager.
CHORE: Bump tracelet_platform_interface to ^0.6.1.

0.6.0 #

REFACTOR: Remove duplicate location filtering from LocationEngine.onLocationReceived() — elasticity, distance filter, accuracy filter, and speed filter now handled by shared Dart LocationProcessor.
REFACTOR: Replace GeofenceManager.evaluateHighAccuracyProximity() with no-op stub — proximity evaluation moved to shared Dart GeofenceEvaluator.
CHORE: Bump tracelet_platform_interface to ^0.6.0.

0.5.5 #

CHORE: Bump tracelet_platform_interface to ^0.5.5.

0.5.4 #

FIX: Heartbeat event now wraps location data in {"location": ...} to match HeartbeatEvent.fromMap() — fixes heartbeat always returning zero coordinates.
FIX: Heartbeat falls back to last known location (via enrichLocation()) when getCurrentPosition returns null.

0.5.3 #

CHORE: Bump tracelet_platform_interface to ^0.5.3.

0.5.2 #

FEAT: Accelerometer-only motion detection mode — when disableMotionActivityUpdates is true, uses hardware accelerometer + TYPE_SIGNIFICANT_MOTION sensor for permission-free stationary↔moving detection.
PERF: Lazily initialize ActivityRecognitionClient — no longer created when unused in accelerometer-only mode.
PERF: Cache SensorManager instance via obtainSensorManager() instead of re-fetching on each call.
FIX: Graceful degradation — if ACTIVITY_RECOGNITION permission throws SecurityException, automatically falls back to accelerometer-only mode.
REFACTOR: Extract activityTransition() helper to reduce boilerplate in transition registration.

0.5.1 #

DOCS: Rewrite README with proper description, setup guide link, and related packages table.

0.5.0 #

CHORE: Bump tracelet_platform_interface to ^0.5.0.
CHORE: Bump version to 0.5.0.

0.4.0 #

FEAT: getMotionPermissionStatus() / requestMotionPermission() — ACTIVITY_RECOGNITION permission handling.
FIX: Auto-pace not triggering — start accelerometer monitoring in MotionDetector.start() when stationary.
FIX: Speed always zero in motionchange events — track lastEffectiveSpeed in LocationEngine.
FIX: Kotlin compilation error from literal \n in import line.
CHORE: Bump tracelet_platform_interface to ^0.4.0.

0.3.0 #

FEAT: One-shot location via getCurrentPosition() with persist, samples, maximumAge, and extras parameters.
FEAT: getLastKnownLocation() with 3-tier fallback — in-memory cache → FusedLocationProviderClient → system LocationManager (GPS/Network).
FEAT: ForegroundServiceConfig.enabled — conditionally start/stop foreground service based on config.
FIX: Replace requestLocationUpdates with sequential getCurrentLocation() calls in collectSamples() to avoid silent throttling on budget devices without foreground service.
BREAKING: Requires tracelet_platform_interface: ^0.3.0.

0.2.3 #

Fix LICENSE file format for proper SPDX detection on pub.dev.

0.2.2 #

Fix ConfigManager.setConfig() — flatten nested section sub-maps (geo, app, http, etc.) sent by Dart before processing. Fixes foreground service notification config (title, text, channel, priority) and all other sub-config values being silently ignored.

0.2.1 #

Version bump for coordinated release.

0.2.0 #

Add SPDX license: Apache-2.0 identifier for pub.dev scoring.

0.1.0 #

Initial release.
FusedLocationProvider-based location tracking.
Foreground service with configurable notification.
Activity recognition via Google Play Services.
SQLite persistence with Room.
HTTP auto-sync with OkHttp.
Geofencing with platform GeofencingClient.
Headless Dart isolate execution.
Boot-completed receiver for start-on-boot.
WorkManager-based scheduling.

tracelet_android 1.2.0 tracelet_android: ^1.2.0 copied to clipboard

Metadata