bgeo_background_geolocation 0.4.0

Reliable background geolocation for Flutter (BGeo engine) — iOS & Android. Motion-aware tracking, offline HTTP queue, geofences, headless events.

0.4.0

• Engine 0.17.0. License key no longer required; the SDK is free. The ready()/start() license gate is gone, so LICENSE_* errors are never returned; the licenseMissing/licenseInvalid/licenseExpired/licenseAppMismatch constants are deprecated and will be removed in the next major. You can delete the com.bgeo.license meta-data (Android) and BGeoLicense Info.plist key (iOS) from your app.
• Example app no longer links to the web console: device linking, server upload of locations/logs and geofence mirroring are removed; map, logs, history and geofences stay fully local.

0.3.3

• Engine 0.16.11 (Android): a refused foreground-service start no longer crashes the app. LocationService now calls startForeground before any bail-out (stopping a startForegroundService-started service before startForeground is fatal), the geofence wake receiver tolerates a refused FGS exemption (seen on Android 16) and falls back to dormancy, and the boot receiver skips the start without ACCESS_BACKGROUND_LOCATION instead of hitting a SecurityException.

0.3.2

• Engine 0.16.10: a non-finite compass sample (NaN rotation vector from the sensor hub, seen on some Android devices right after watchHeading) crashed the app with JSONException: Forbidden numeric value: NaN; a later NaN silently froze the heading stream for the rest of the session. Such samples are now dropped before they reach the smoother.

0.3.1

• Engine 0.16.9: exposes the experimental iOS wake trail that was already compiled into the 0.3.0 binary but had no typed config — new keys wakeTrailEnabled (default false) and wakeTrailCount (default 8). No behaviour change unless you turn it on.

0.3.0

• New events: onCrash (on-device collision detection, crashDetection config) and onDistraction (phone handling while driving, distractionDetection config; flagged fixes carry dds/ddc/ddd extras). Both are off by default.
• New config: wakeRegionRingCount / wakeRegionRingDistance (iOS wake ring of entry-monitored satellites around the parked anchor — faster departure wakes for a killed or suspended app; app geofences are now capped at 19 − ringCount, 11 by default) and dormantOnStationary / dormantWakeInterval / dormantGrace (Android: drop the foreground service while parked and take periodic Doze-proof fixes instead; off by default).
• ProviderChangeEvent.insufficientlyInUse (iOS 17+): locationd refused the background session; the engine falls back to the legacy location manager.
• Engine 0.16.8 (iOS): session-refusal fallback, no background task on an exhausted budget, wake decisions consult Core Motion activity history, keep-alive no longer synthesizes a stop 36 s after a wake, 15 s first-fix check after a refused-session wake, app-geofence regions namespaced com.bgeo.gf.* with a one-time sweep of foreign regions on first launch (re-register your own CLRegions after that launch — see the geofencing guide).
• Engine 0.16.8 (Android): dormant mode with grace period, wake-upload retries and a network-constrained flush job; parked service restarts re-arm the stationary geofence; watchPosition stops on task-removed.

0.2.2

• Engine 0.14.1: parked iOS devices no longer burn 1 Hz GPS while the phone is handled — the delivery stream is paused after the stop settles and resumed in place on departure (no re-subscription, so background delivery restarts within milliseconds). Also: the moving keep-alive retries after a background-budget exhaustion in dead zones, and the missed-stop synthesizer stands down while GPS-denied fixes are still arriving (no more backdated stops in tunnels). No Dart API changes.

0.2.1

• Engine 0.14.0: iOS now keeps continuous location delivery after the system relaunches the app in the background (overnight eviction, kill while driving) instead of degrading to significant-change bursts of a few points every 4–6 minutes. The upload queue is also flushed on every background wake, so stop records no longer sit on the device until the next app open. No Dart API changes.

0.2.0

• Licensing: the LICENSE file is now the plain MIT license covering the bridge sources; the proprietary engine-binary terms moved unchanged to LICENSE-BINARY.md. No functional changes.

0.1.8

• Engine 0.13.5: fix the iOS license-error banner rendering as an empty red rectangle — the text had zero height. No Dart API changes.

0.1.7

• Engine 0.13.4: a release build that fails the license check (LICENSE_MISSING, LICENSE_INVALID, LICENSE_EXPIRED, LICENSE_APP_MISMATCH) now shows a persistent on-screen banner with the error code and app id. Previously tracking was silently blocked — easy to ship without noticing. Debug builds and the iOS simulator are unaffected. No Dart API changes.

0.1.6

• Engine 0.13.3: getState() on Android now reports the health fields iOS has always reported — trackingActive, authorization, and lastRawFixAge / lastAcceptedFixAge (seconds, null until a fix arrives). The raw age is stamped before the location filter runs, so the pair tells "the OS stopped delivering fixes" apart from "the filter is rejecting them". Read them off state.raw; no Dart API changes.

0.1.5

• Engine 0.13.2: a stationary device uploads again. watchPosition no longer drops its persist option on the way to the per-tick fix, and getCurrentPosition(persist: true) waits for a fresh fix instead of resolving with the provider's replay of the last known location, which the old same-timestamp dedup then silently discarded — so heartbeat records never reached the server. Persist dedup is now by record identity (stamp + channel). No Dart API changes.

0.1.4

• Breaking (types): Location.isMoving is now bool? instead of bool. Both engines send is_moving: null while a cold-started session's first fixes are still in the unconfirmed-MOVING probing window (up to stopTimeout minutes after start()); the decoder used to collapse that to false, so an app could not tell "not yet known" from "stationary". If you don't care about the difference, replace location.isMoving with location.isMoving ?? false. MotionChangeEvent.isMoving is unchanged (non-nullable) — the engines always send a real verdict there.

0.1.3

• Engine 0.13.1 fixes two payload defects; no Dart API changes.
• onGeofencesChange: geofences in the off list now carry their real radius/latitude/longitude again. Removing an actively monitored geofence used to emit an identifier-only record, which Geofence.fromMap decoded as zeroed geometry.
• providerState / onProviderChange: accuracyAuthorization is now populated (0 = full, 1 = reduced) instead of always decoding to null. On Android it reports reduced when only ACCESS_COARSE_LOCATION is granted.

0.1.2

• Engine 0.13.0 embeds the production licence signing key in place of the development key that previously shipped. Licence tokens issued or re-signed before 2026-07-29 will not verify against this build — copy the current token from your dashboard at https://bgeo.dev before upgrading.
• iOS: the vendored BGeoCore.xcframework now ships an Apple privacy manifest (PrivacyInfo.xcprivacy) declaring precise/coarse location collection for app functionality and the NSUserDefaults required-reason API (CA92.1).
• Android: the engine AAR's Maven coordinate moved from com.bgeo:bgeo-android:0.12.1 to dev.bgeo:bgeo-android:0.13.0. It's vendored in this package's local Maven repo per the documented setup, so no action is needed unless you hand-wrote the old coordinate directly.

0.1.1

• No functional changes. Release-infrastructure housekeeping: first version published through CI (GitHub Actions → pub.dev automated publishing); engine binaries verified current (BGeoCore / bgeo-android 0.12.1).

0.1.0

Initial release.

• Full RN/native react-native-background-geolocation API parity ported to Futures/Streams: ready/start/stop/setConfig/getState, changePace, getCurrentPosition/watchPosition, permission + provider-state queries, odometer, upload queue (sync/getLocations/destroyLocation(s)/getCount/ insertLocation), auth state, persisted logger (getLog/destroyLog/ uploadLog), and geofences (add/remove/getGeofences/geofenceExists).
• Event streams: onLocation, onLocationError, onMotionChange, onHeartbeat, onGeofence, onGeofencesChange, onProviderChange, onPowerSaveChange, onHttp, onConnectivityChange, onAuthorization.
• Headless (killed-app) event dispatch on Android via a top-level/static Dart entrypoint running in a background FlutterEngine.
• iOS (BGeoCore.xcframework, iOS 15.5+) and Android (bgeo-android AAR, minSdk 24) closed-source engine binaries vendored with the package.
• Offline license evaluation in debug builds and the iOS simulator; license key required for release builds via manifest meta-data / Info.plist.