tracelet_ios 1.0.0 copy "tracelet_ios: ^1.0.0" to clipboard
tracelet_ios: ^1.0.0 copied to clipboard

Published 11 days ago • verified publisherikolvi.com• Latest: 1.4.2
[unknown platforms]
→

Metadata

iOS implementation of the Tracelet background geolocation plugin.

More...

1.0.0 #

🎉 Stable Release #

  • FEAT: First stable release of tracelet_ios.
  • REFACTOR: Remove third-party company name references.
  • All native iOS APIs are finalized and production-ready.

0.12.0 #

Performance Audit — 22 iOS issues resolved #

  • PERF: Cache ISO8601DateFormatter as static instance (I-C1, I-C2).
  • PERF: Call UIDevice.isBatteryMonitoringEnabled once at plugin initialization (I-C3).
  • PERF: Add serial stateQueue for thread-safe sync flag access (I-C4).
  • PERF: Use BackgroundTaskHelper.shared.begin() with proper expiration handler (I-C5).
  • PERF: Reduce accelerometer to 10 Hz and deliver on background queue (I-H1).
  • PERF: Set timer tolerance to 10% for iOS energy coalescing (I-H2).
  • PERF: Use SQLite transactions for batch geofence inserts (I-H3).
  • PERF: Throttle DB pruning to every 100 inserts (I-H4, I-H6).
  • PERF: Move JSON serialization outside DB queue lock (I-H5).
  • PERF: Default pausesLocationUpdatesAutomatically to true (I-M1).
  • PERF: Make activityType configurable via getActivityType() mapping (I-M2).
  • PERF: Reuse URLSession — getAllTasks cancel instead of invalidateAndCancel (I-M3).
  • PERF: Defer BGAppRefreshTask.setTaskCompleted until async location fix returns (I-M4).
  • PERF: Find monitored region by identifier instead of creating dummy CLCircularRegion (I-M5).
  • PERF: Add in-memory privacy zone cache with CRUD invalidation (I-M7).
  • PERF: Add in-memory geofence cache with CRUD invalidation (I-M8).
  • PERF: Lazy-init CMMotionActivityManager and CMPedometer for accelerometer-only mode (I-L1).
  • PERF: Remove duplicate haversine() from GeofenceManager, call module-level function (I-L3).
  • PERF: Remove dead @available(iOS 14) self-assign no-op (I-L4).
  • REFACTOR: Remove trivial isMoreRestrictive() wrapper, inline isActionMoreRestrictive() call (I-L5).
  • CHORE: Add CoreLocation import to ConfigManager.swift for CLActivityType.

0.11.5 #

  • FIX: Persist polygon geofence vertices to SQLite — add vertices TEXT column with PRAGMA table_info migration for existing installs, and JSON serialization/deserialization in insertGeofence()/geofenceRowToMap().
  • FIX: Use NSNumber bridging for JSONSerialization vertex deserialization (fixes silent cast failure with [[Double]]).
  • FIX: Handle heterogeneous vertex arrays — skip non-array entries instead of failing the entire cast.
  • TEST: Add XCTest tests for geofence vertices CRUD (11 tests covering round-trip, validation, edge cases).
  • TEST: Add DB migration integration tests — column addition, data preservation, idempotency, multi-geofence migration, fresh install.

0.11.4 #

  • FIX: Revert over-aggressive allowsBackgroundLocationUpdates and significant-location guards — When In Use permission now works correctly for foreground and background tracking. iOS enforces permission at the OS level; only the killed-state entry point (autoResumeTracking) requires Always authorization.

0.11.3 #

  • FIX: Add .authorizedAlways guard to autoResumeTracking() — prevents "When In Use" permission from triggering tracking after app is relaunched from killed state via significant-location-change.
  • FIX: Guard allowsBackgroundLocationUpdates in configureLocationManager() and performPeriodicFix() — only set to true when Always authorization is granted.

0.11.2 #

  • CHORE: Tighten tracelet_platform_interface constraint to ^0.11.2.

0.11.1 #

  • FIX: Set event: "periodic" in all didUpdateLocations code paths for periodic tracking (was empty string).
  • FEAT: Add canScheduleExactAlarms (returns true) and openExactAlarmSettings (returns false) method channel stubs.
  • CHORE: Add NSLog diagnostic logging to startPeriodic() and performPeriodicFix().
  • CHORE: Bump platform interface to 0.11.1.

0.11.0 #

  • FEAT: AuditTrailManager — SHA-256 hash chain with SQLite persistence and UserDefaults chain state.
  • FEAT: PrivacyZoneManager — Haversine distance-based zone evaluation with exclude, degrade, and event-only actions.
  • FEAT: Privacy zones database table with CRUD operations.
  • 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(). Timer-based scheduling with background location toggling per fix.
  • FEAT: ConfigManager periodic config getters for interval, accuracy, foreground service, and exact alarms.
  • FIX: ConfigManager.swift escaped string literals causing Swift compilation failure.
  • CHORE: Bump tracelet_platform_interface to ^0.10.0.

0.9.1 #

  • FIX: Safe optional unwrap of UIBackgroundTaskIdentifier in HttpSyncManager.syncNextBatch() — fixes Swift compiler error.

0.9.0 #

  • FEAT: HTTP sync retry engine — configurable retry with exponential backoff for transient 5xx, 429, and timeout failures. Defers sync on connectivity loss via NWPathMonitor. Batch continuation loop.
  • FEAT: Configurable motion sensitivity — MotionDetector reads shakeThreshold, stillThreshold, stillSampleCount from ConfigManager at runtime (auto-converts m/s² to g-force).
  • 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 CLLocationManager, sorted by distance, capped at 20 (iOS limit). Enables monitoring thousands of geofences.
  • FEAT: GeofenceManager.updateProximity() — re-evaluates which geofences to monitor on every location update, dynamically swapping region 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 regions 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 #

  • FEAT: BackgroundTaskHelper — central thread-safe utility wrapping UIApplication.beginBackgroundTask for safe background execution of native operations.
  • FEAT: iOS 17+ CLBackgroundActivitySession support via BackgroundActivitySessionManager — extends background runtime for location-tracking apps.
  • FEAT: iOS 18+ CLServiceSession support via ServiceSessionManager — maintains authorization state during background execution.
  • PERF: Wrap LocationEngine.didUpdateLocations in background task — protects persist + dispatch chain from iOS suspension.
  • PERF: Wrap HttpSyncManager.sync() in background task — protects entire HTTP upload + DB cleanup cycle.
  • PERF: Wrap HeadlessRunner.dispatchEvent() engine boot in background task — ensures Dart engine starts fully before iOS reclaims resources.
  • PERF: Wrap all TraceletIosPlugin lifecycle transitions (handleStop, handleReset, onStopRequested, handleScheduleStop, stopAfterElapsedTimer) in background tasks.
  • FIX: preventSuspendManager.start() now called in startGeofences() — was missing, causing audio keep-alive to not activate in geofence-only mode.
  • FIX: preventSuspendManager.stop() now called in all stop paths (reset, stopOnStationary, scheduleStop, stopAfterElapsed) — was only called in handleStop().
  • FIX: setConfig() now toggles preventSuspendManager mid-session when preventSuspend changes.
  • FIX: reset() now calls cancelStopAfterElapsedTimer() — was leaving stale timer running after reset.
  • FIX: iOS 17+/18+ session managers wired into all lifecycle paths (start, stop, startGeofences, reset, scheduleStart/Stop, stopOnStationary, stopAfterElapsed).

0.8.0 #

  • FEAT: OEM compatibility stubs — getSettingsHealth returns isAggressiveOem: false (iOS has no OEM power management issues), openOemSettings returns false.
  • DOCS: Update README with OEM compatibility note 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 CLLocationSourceInformation (iOS 15+) to detect simulated locations.
  • FEAT: Heuristic mock detection (level 2) — timestamp drift check (> 10s between location timestamp and system time = suspicious).
  • FEAT: buildLocationMap() includes mock flag and mockHeuristics metadata map (timestampDriftMs, 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 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.didUpdateLocations() — 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 #

  • FIX: onSchedule event now sends full state map (via stateManager.toMap()) instead of partial ["state": "on", "enabled": true] — fixes State.fromMap() crash on schedule events.

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 buildLocationMap()) 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 CMMotionManager raw accelerometer for permission-free stationary↔moving detection (no NSMotionUsageDescription required).
  • FEAT: getMotionAuthorizationStatus() / requestMotionPermission() return 3 (granted) immediately in accelerometer-only mode — no OS dialog shown.
  • PERF: Reuse shared CMMotionManager instance for sensor queries instead of creating throwaway instances.
  • FIX: Auto-fallback to accelerometer-only when CMMotionActivityManager.isActivityAvailable() returns false.

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() — CMMotionActivityManager authorization check.
  • FIX: Speed always zero in motionchange events — track lastEffectiveSpeed in LocationEngine.
  • FIX: "Upgrade to Always" dialog not appearing — fix handleStart isMoving initialization.
  • FIX: MotionDetector motion state bugs — proper accelerometer + activity recognition lifecycle.
  • 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: Multi-sample collection with distanceFilter = kCLDistanceFilterNone and DispatchQueue timeout guard.
  • FEAT: getLastKnownLocation() — prefers own cached location, falls back to CLLocationManager.location.
  • FEAT: ForegroundServiceConfig.enabled support.
  • FIX: Add CLAuthorizationStatus guard in getCurrentPosition() — returns nil if not authorized instead of hanging.
  • FIX: Single-sample path now sets desiredAccuracy = kCLLocationAccuracyBest before requestLocation().
  • BREAKING: Requires tracelet_platform_interface: ^0.3.0.

0.2.4 #

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

0.2.3 #

  • Fix ConfigManager.setConfig() — flatten nested section sub-maps (geo, app, http, etc.) sent by Dart before processing. Fixes all user config values being silently ignored in favor of defaults.

0.2.2 #

  • Fix duplicate keys in ConfigManager.defaultConfig() dictionary literal causing runtime crash.

0.2.1 #

  • Version bump for coordinated release.

0.2.0 #

  • Add Swift Package Manager support.
  • Fix podspec homepage URL.
  • Fix podspec source_files and resource_bundles paths for SPM layout.
  • Add SPDX license: Apache-2.0 identifier for pub.dev scoring.

0.1.0 #

  • Initial release.
  • CLLocationManager-based location tracking.
  • CoreMotion activity recognition.
  • SQLite3 persistence.
  • HTTP auto-sync with URLSession.
  • CLCircularRegion geofencing.
  • Headless FlutterEngine execution.
  • BGTaskScheduler integration.
  • Significant-change monitoring support.

← Metadata

1
likes
0
points
1.56k
downloads

Publisher

verified publisherikolvi.com

Weekly Downloads

Metadata

iOS implementation of the Tracelet background geolocation plugin.

Homepage
Repository (GitHub)
View/report issues

License

unknown (license)

Dependencies

flutter, tracelet_platform_interface

More

Packages that depend on tracelet_ios

Packages that implement tracelet_ios

Back