geohawk 0.1.1 copy "geohawk: ^0.1.1" to clipboard
geohawk: ^0.1.1 copied to clipboard

Resilient Android background location tracking — foreground service, watchdog/boot restart, offline cache, and OEM auto-start helpers.

0.1.0 #

  • Initial public release.
  • Android-only: foreground-service-based background location tracking.
  • Geohawk.start(...) launches a FOREGROUND_SERVICE_TYPE_LOCATION service with a configurable interval, max-interval, distance filter, optional HTTPS upload endpoint, and notification title/text/icon.
  • Geohawk.stop() tears down the service, watchdog alarm, and wake lock.
  • Geohawk.updateNotification({title, text, icon}) updates the foreground notification in place without restarting tracking.
  • Geohawk.onLocationUpdate exposes a broadcast stream of LocationFixes.
  • Geohawk.pendingCacheCount() returns the number of unsent fixes currently cached on disk (when the upload endpoint is offline).
  • Geohawk.requestBatteryOptimizationExemption() and Geohawk.openAutoStartSettings() deep-link to the relevant OEM screens.
  • Runtime location permission is requested automatically from the bound Activity before the foreground service is started, avoiding the Android 14+ SecurityException on startForeground with type location.
  • Watchdog alarm and boot/restart receivers keep the service alive across task removal and reboots. Uses setAndAllowWhileIdle (inexact) so no SCHEDULE_EXACT_ALARM / USE_EXACT_ALARM permission is required and Google Play "Exact alarm" policy doesn't apply.
0
likes
0
points
119
downloads

Publisher

unverified uploader

Weekly Downloads

Resilient Android background location tracking — foreground service, watchdog/boot restart, offline cache, and OEM auto-start helpers.

Repository (GitHub)
View/report issues

Topics

#location #background #geolocation #foreground-service #android

License

unknown (license)

Dependencies

flutter, plugin_platform_interface

More

Packages that depend on geohawk

Packages that implement geohawk