tracelet_ios 0.8.2

iOS implementation of the Tracelet background geolocation plugin.

tracelet_ios

iOS implementation of the Tracelet background geolocation plugin.

This package uses Swift and native Apple frameworks (CoreLocation, CoreMotion, BackgroundTasks, SQLite3) to provide production-grade background location tracking.

Native Features

• Kalman Filter GPS Smoothing — Extended Kalman Filter implementation (KalmanLocationFilter.swift) smooths raw GPS coordinates using device-reported accuracy as measurement noise. Produces cleaner tracks and eliminates jitter. Learn more →
• Trip Detection — TripManager.swift tracks motion state transitions to detect trip start/stop. Each trip includes distance, duration, waypoints, and start/stop locations. Learn more →
• Polygon Geofences — Ray-casting point-in-polygon algorithm in GeofenceManager.swift for arbitrary polygon containment checks alongside circular geofences. Learn more →
• Mock Location Detection — Spoof detection using CLLocationSourceInformation (iOS 15+) and timestamp drift heuristic. Configurable via MockDetectionLevel. Learn more →
• OEM Compatibility — iOS has no OEM-specific power management issues. The Settings Health API returns isAggressiveOem: false and an empty oemSettingsScreens list. Learn more →
• Background Task Protection — All critical native operations (location persist, HTTP sync, headless engine boot, lifecycle transitions) are wrapped in UIApplication.beginBackgroundTask to prevent iOS from killing the app mid-operation.
• iOS 17+ Background Activity Session — CLBackgroundActivitySession extends background runtime for continuous location tracking without user interaction.
• iOS 18+ Service Session — CLServiceSession maintains location authorization state during background execution.

Usage

You should not depend on this package directly. Instead, depend on tracelet which automatically includes this package on iOS builds.

dependencies:
  tracelet: ^0.5.0

For iOS-specific setup (Info.plist, capabilities, entitlements), see the iOS Setup Guide.

Related Packages

Package	Description
tracelet	App-facing Dart API — the only package you depend on
tracelet_platform_interface	Abstract platform interface
tracelet_android	Android implementation
tracelet_web	Web implementation

More Information

• GitHub Repository
• Documentation
• Issue Tracker