NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev, #3983 most downloaded on pub.dev
A common platform interface for the Tracelet background geolocation plugin. Used by tracelet_android and tracelet_ios implementations.
Latest stable
3.8.9
Last release 24 days ago
22 Oct 2026
Release timing varies
gaps range from 8 days to 5 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
8 months old
166 releases · first in 2026
Drag across the ruler to compare, or tap a release to open it.
CHORE: Version bump to align with 3.2.11 platform release.
FIX: streamline geofence event payload handling in fromMap method.
FIX(ios): Remove TraceletCore+Dummy.swift / TraceletSyncFFI+Dummy.swift — @_silgen_name declarations from the old static library model caused "Undefin
Your coding agent can read these notes before it upgrades. Set up the MCP server →
One column per month.
TraceletCore+Dummy.swift / TraceletSyncFFI+Dummy.swift — @_silgen_name declarations from the old static library model caused "Undefined symbol" linker errors after the static→dynamic xcframework migration.ForegroundServiceStartNotAllowedException in LocationService.start() so calling ready() from the background on Android 12+ no longer crashes the host app; the foreground service start is deferred until the app returns to foreground.FIX: Persist geofence ENTER/EXIT events in offline queue and auto-sync to server — events were previously dispatched to the app but never stored in th
event_type, event_payload) for geofence events round-trips correctly through getLocations() and insertLocation().setSyncBodyBuilder (Issue #125).NOT_READY error before ready() is called to match iOS parity; previously Android silently ignored SDK calls before initialization (Issue #129).flutter_rust_bridge has not been initialized on release builds — TraceletCore is now a dynamic framework, preventing dead-code stripping of FRB symbols (Issues #116, #123, #124).Failed to lookup symbol 'frb_get_rust_content_hash' — Rust symbols are now loaded directly from libtracelet_core.so bypassing RTLD_LOCAL isolation (Issues #116, #123).is_moving state per location record so getLocations() returns accurate values instead of always returning the current live state (Issue #126).FIX(ios): prevent dead code stripping of flutter_rust_bridge symbols in release builds.
showPowerManager to handle aggressive battery restrictions on specific OEM devices.PERF: Optimize database timestamp queries for O(log N) fast filtering and resolve precision bugs (Issue #119).
sslPinningFingerprints natively across iOS and Android with Rust configs.Nothing published for this version
FIX(ios): safely resolve dynamic symbols when use_frameworks! :linkage => :dynamic is used.
use_frameworks! :linkage => :dynamic is used.FIX: Force speed motion manager to evaluate initial speed on Android to prevent the state machine from being permanently stuck in MOVING when indoors
MOVING when indoors (#115).flutter_rust_bridge has not been initialized crash by ensuring the Rust core is instantiated and initialized before accessing methods (#116).CHORE: Sync release versions across all federated packages and update Swift Package Manager configuration.
CHORE: Align federated package versions and include additional patch updates.
FEAT: Implement short-lived WakeLocks for transient background tasks (startBackgroundTask / stopBackgroundTask), improving background execution reliab
startBackgroundTask / stopBackgroundTask), improving background execution reliability on Android (matches iOS beginBackgroundTask).tracelet_sync module, which must now be included if you require network synchronization.resolveAddress).CHORE: Sync release versions across workspace.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Bump "tracelet_platform_interface" to 3.1.10.
3.1.10.FIX(android): conditionally apply kotlin-android plugin to support older flutter SDKs while preventing warnings in modern Flutter environments.
release.yml.- Fix iOS SPM publishing
FIX(android): apply kotlin-android plugin to fix gradle build errors on newer AGP versions.
Nothing published for this version
Nothing published for this version
CHORE: Sync release versions across workspace.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
FIX(ios): Add missing FlutterFramework dependency to SPM plugin configuration to resolve compilation failures and PlatformExceptions.
FlutterFramework dependency to SPM plugin configuration to resolve compilation failures and PlatformExceptions.FEAT: Massive Architecture Rewrite — Core algorithms are now powered by a high-performance Rust Core using flutter_rust_bridge.
flutter_rust_bridge.MotionDetectionMode.smart powered by the Rust battery budget engine.FEAT: Smart Foreground Notification Visibility (Android) — Added dynamic foreground service notification management. The notification now intelligentl
tl.MotionDetectionMode.speed). In this mode, motion state transitions are driven directly by GPS speed calculations rather than raw accelerometer hardware. This provides enhanced compatibility and reliability on devices with aggressive sensor sleep policies, particularly in vehicular tracking scenarios.stopTimeout countdown. Previously, if the device was still for 5 seconds on a smooth road, it would begin the 60-second stop countdown and ignore any subsequent bumps or shakes. Now, the accelerometer remains active during the countdown and will correctly abort the stationary transition if motion resumes (#85).TraceletHasRequestedAlways is now properly reset upon notDetermined OS state.retryBackoffCap and retryBackoffBase. Time values are now properly cast as milliseconds instead of seconds, resolving a severe bug where HTTP retries fired every 60ms during network failure, causing excessive CPU/network thrashing and a massive 58KB+ log flood.Tracelet.locationStream pipeline. Replaced the faulty asyncMap batch processing with a highly robust .expand() implementation. The Tracelet.locationStream now correctly parses, type-casts, and guarantees delivery of every individual Location object without throwing type '_Map<Object?, Object?>' is not a subtype of type 'Map<String, dynamic>' or silently discarding valid coordinates.LocationEngine.stop from unintentionally overriding the global stateManager.enabled flag during speed-based motion transitions.MotionDetectionMode.accelerometer as the default to ensure immediate indoor responsiveness upon installation.Packages with breaking changes:
2.0.8.Packages with breaking changes:
Packages with other changes:
Packages with dependency updates only:
Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.
tracelet - v2.0.7tracelet_doctor - v1.0.2FIX(interface): correct intToAuthStatus permission index mappings ([#80](https://github.com/Ikolvi/Tracelet/issues/80)).
We are thrilled to announce the official coordinated release of the Tracelet 2.0 line! This major milestone introduces a modernized, compound configur
We are thrilled to announce the official coordinated release of the Tracelet 2.0 line! This major milestone introduces a modernized, compound configuration schema, type-safe platform channel communication via Pigeon, and major performance and battery optimizations across both iOS and Android.
Fixed a critical bug in ConfigManager.kt where the entire "android" configuration block was omitted from native flattening keys. This caused all custom parameters inside AndroidConfig (including locationUpdateInterval, deferTime, and ForegroundServiceConfig settings like custom notifications) to be silently ignored and fall back to default values. These are now fully parsed and applied correctly.
TYPE_SIGNIFICANT_MOTION for active tracking when a primary accelerometer is missing on the device.Includes official support for our new drop-in companion diagnostic library: tracelet_doctor (v1.0.1).
Developers can now present a complete diagnostic overlay bottom sheet using TraceletDoctor.show(context) to quickly debug missing headless task registrations, mock location states, permission levels, and power-saving overrides in real-time.
This coordinated release bundles the following component updates:
| Component / Package | Version | Description |
|---|---|---|
📦 tracelet |
2.0.6 |
Core Flutter plugin package |
🤖 tracelet_android |
2.0.6 |
Android platform implementation |
🍏 tracelet_ios |
2.0.6 |
iOS platform implementation |
🌐 tracelet_web |
2.0.6 |
Web platform implementation |
🔗 tracelet_platform_interface |
2.0.6 |
Unified Platform Interface |
🩺 tracelet_doctor |
1.0.1 |
Drop-in Companion Diagnostic Tool |
| 🤖 Native Android SDK | 2.0.6 |
Core Android AAR binary |
| 🍏 Native iOS SDK | 2.0.6 |
Core iOS CocoaPod framework |
Tracelet 2.x introduces a compound configuration schema. Platform-specific config fields are now cleanly grouped:
// 1.x flat schema
await Tracelet.ready(Config(
desiredAccuracy: DesiredAccuracy.high,
stopOnTerminate: false,
locationUpdateInterval: 10000,
));
// 2.x structured schema
await Tracelet.ready(Config(
geo: GeoConfig(desiredAccuracy: DesiredAccuracy.high),
app: AppConfig(stopOnTerminate: false),
android: AndroidConfig(locationUpdateInterval: 10000),
));
For a comprehensive migration walkthrough, please refer to our Migration Guide.
CHORE: Version bump for monorepo consistency and package lockstep alignment.
CHORE: Version bump for monorepo consistency and native SDK alignment.
FIX: Removed unreliable timestamp drift heuristic from location spoofing detection.
CHORE: Version bump for iOS status bar fix consistency.
BREAKING: Migrated all platform communication to Pigeon for strictly-typed host and flutter APIs.
Config into a nested compound model (GeoConfig, AppConfig, AndroidConfig, HttpConfig, LoggerConfig, MotionConfig, GeofenceConfig, SecurityConfig).shakeThreshold, stillThreshold, and stillSampleCount to TlMotionConfig Pigeon model for granular motion sensitivity tuning.Tl (e.g., TlAuthorizationStatus, TlTrackingMode) to avoid naming collisions while maintaining stable public-facing Dart enums.2: 3: - CHORE: Version bump for monorepo consistency and native SDK alignment. 4: 5: ## 1.9.2
2: 3: - CHORE: Version bump for monorepo consistency and native SDK alignment. 4: 5: ## 1.9.2
tracelet 1.9.2 release. No interface changes.Nothing published for this version
CHORE: Constraint bump for tracelet 1.9.1 release. No interface changes.
tracelet 1.9.1 release. No interface changes.The previous int-returning methods are kept and marked @Deprecated. They will be removed in 2.0.0. Existing code keeps compiling.
Highlights: typed AuthorizationStatus permission APIs (#57), fix for missing
geofence extras in callback (#58), and fix for RemoteServiceException
foreground-service crash (#59). Bundled into a single coordinated release.
Seven new *Authorization methods on Tracelet return the typed
AuthorizationStatus enum instead of an int:
getLocationAuthorization()requestLocationAuthorization()getNotificationAuthorization()requestNotificationAuthorization()getMotionAuthorization()requestMotionAuthorization()requestTemporaryFullAccuracyAuthorization(purpose)The previous int-returning methods are kept and marked @Deprecated. They
will be removed in 2.0.0. Existing code keeps compiling.
// Before
final status = await Tracelet.getPermissionStatus();
if (status == 4) { /* deniedForever */ }
// After
final status = await Tracelet.getLocationAuthorization();
if (status == AuthorizationStatus.deniedForever) { /* clearer + type-safe */ }
Geofence callbacks now correctly receive the extras map and polygon
vertices array on Android. Affected code paths that read custom metadata
via event.geofence.extras will work again.
LocationService.onStartCommand now always promotes the service to
foreground, including for ACTION_STOP, ACTION_UPDATE_NOTIFICATION,
ACTION_BUTTON, and the null-intent START_STICKY restart path.
This eliminates the RemoteServiceException: Context.startForegroundService() did not then call Service.startForeground() crash that was easily reproducible
when using periodicUseForegroundService: true. Device-verified on a LAVA
LXX503 — no RemoteServiceException, no ANR.
| Package | Old | New |
|---|---|---|
tracelet |
1.8.14 | 1.9.0 |
tracelet_platform_interface |
1.8.14 | 1.9.0 |
tracelet_android |
1.8.14 | 1.9.0 |
tracelet_ios |
1.8.14 | 1.9.0 |
tracelet_web |
1.8.14 | 1.9.0 |
Native tracelet-sdk (Android) |
1.0.13 | 1.1.0 |
Native TraceletSDK (iOS) |
1.0.11 | unchanged |
help/PERMISSIONS.md restructured around the typed API; new
AuthorizationStatus enum table replaces the old int-code table.help/API.md, BACKGROUND-TRACKING.md, INSTALL-ANDROID.md,
INSTALL-IOS.md, HEALTH-CHECK.md, PLAY-STORE-DECLARATION.md,
WEB-SUPPORT.md, and MIGRATION-FROM-FBG.md migrated to the new method
names and enum.example/lib/main.dart) fully migrated as a reference
implementation.melos exec dart format: cleanmelos run analyze: SUCCESS, no issues across all 5 packages + exampletracelet: 462/462 tests pass (12 tests added for #57)tracelet_platform_interface: 338/338 tests passtracelet_web: 29/29 tests passtracelet_android Robolectric: BUILD SUCCESSFULNo code changes required — old methods still compile with a deprecation
warning. To migrate, see help/PERMISSIONS.md.
Full Changelog: https://github.com/Ikolvi/Tracelet/compare/c3c4df2...v1.9.0
_mapToGeofence was silently dropping extras and vertices when converting the Dart map into the Pigeon TlGeofence, so they never reached native and were persisted as null (#58). Both fields now round-trip from Geofence.toMap() through the platform channel intact. The earlier 1.8.12 patch only addressed the Android read path; the actual data loss was one layer up at the federated platform-interface layer and affected both Android and iOS.tracelet 1.9.0 typed permission API additions (#57). No interface changes — the int-based platform-interface methods are unchanged.pigeon_tracelet_test.dart asserting extras and vertices reach TraceletHostApi.addGeofence.CHORE: Version bump for first-fix latency improvement in tracelet_android and tracelet_ios (#54). No interface changes.
tracelet_android and tracelet_ios (#54). No interface changes.CHORE: Version bump for geofence/location extras round-trip fix in tracelet_android (#51 follow-up).
extras round-trip fix in tracelet_android (#51 follow-up).Geofence callbacks no longer silently stop during continuous tracking when a secondary FlutterEngine (e.g. Firebase background messaging) registers th
When FirebaseMessaging.onBackgroundMessage() fires, Firebase creates a temporary FlutterEngine. GeneratedPluginRegistrant.registerWith() creates a new Tracelet plugin instance on that engine, which unconditionally:
sdk.destroyAll() — tearing down the primary tracking sessionA static primaryInstance guard on both Android (TraceletAndroidPlugin) and iOS (TraceletIosPlugin) ensures only the first plugin instance wires SDK state. Secondary instances get Pigeon HostApi only — they cannot corrupt the singleton.
| Package | Version |
|---|---|
tracelet |
1.8.11 |
tracelet_ios |
1.8.11 |
tracelet_web |
1.8.11 |
Native SDKs unchanged at 1.0.10.
tracelet_android and tracelet_ios (#51).FIX: Killed-state tracking now works reliably on Android — stopBootTracking() deferred from sdk.initialize() to sdk.ready() so boot-mode native tracki
stopBootTracking() deferred from sdk.initialize() to sdk.ready() so boot-mode native tracking (LocationEngine + HttpSyncManager) survives until the Dart side explicitly takes over (#50).| Component | Version |
|---|---|
tracelet |
1.8.10 |
tracelet_platform_interface |
1.8.10 |
tracelet_android |
1.8.10 |
tracelet_ios |
1.8.10 |
tracelet_web |
1.8.10 |
Android SDK (com.ikolvi:tracelet-sdk) |
1.0.10 |
iOS SDK (TraceletSDK) |
1.0.10 |
dependencies:
tracelet: ^1.8.10
No code changes required — the fix is entirely in the native Android SDK layer.
Full Changelog: https://github.com/Ikolvi/Tracelet/compare/v1.8.9...v1.8.10
tracelet_android (#50).FEAT: Add syncInterval field to HttpConfig for fixed-cadence HTTP sync (#50).
syncInterval field to HttpConfig for fixed-cadence HTTP sync (#50).HTTP sync payloads are now consistent across iOS and Android (#48).
HTTP sync payloads are now consistent across iOS and Android (#48).
Android previously sent isMoving (camelCase) with numeric epoch timestamps, while iOS sent is_moving (snake_case) with ISO 8601 strings. All Android location producers now emit the canonical format defined in LOCATION-MAP-FORMAT.md. No migration needed — only output mapping changed, SQLite schema is untouched.
tracelet
cursorToLocation() and all location map producers now use canonical is_moving (snake_case) and ISO 8601 timestamps (#48).tracelet_android
is_moving and ISO 8601 timestamps, matching iOS format (#48).1.0.8.tracelet_ios
SubsystemTests static property access for HttpSyncManager callbacks.1.0.8.tracelet_platform_interface / tracelet_web
Android SDK
cursorToLocation() now uses canonical is_moving key and ISO 8601 timestamp string.insertLocation() accepts both is_moving and isMoving for backward compatibility.enrichLocation(), buildLocationMap(), onDrLocationEstimated() normalized to is_moving.appendToChain() / verifyChain() accept both key variants.iOS SDK
SubsystemTests — use HttpSyncManager.onRequestFreshHeaders (static type) instead of instance access.Location.fromMap() already accepted both is_moving and isMoving — verified with tests.insertLocation() now accepts both key variants.1,000+ tests passing: Dart tracelet (444), tracelet_platform_interface (337), Android SDK (Robolectric), iOS SDK (287 XCTest).
CHORE: Align federated package versions and include additional patch updates.
CHORE: Version bump for HTTP sync headers fix.
getPrivacyZones() lazy .cast<Map<String, Object?>>() — eagerly deep-cast each map to prevent _Map<Object?, Object?> type error at runtime.CHORE: Version bump for getCurrentPosition fallback fix (#46).
getCurrentPosition fallback fix (#46).This release fixes a critical crash when SDK methods are called before ready(), affecting both iOS and Android. Native SDK dependencies are now pinned
This release fixes a critical crash when SDK methods are called before ready(), affecting both iOS and Android. Native SDK dependencies are now pinned to exact versions to prevent compatibility issues.
isReady guards to all SDK methods — prevents crash when any method (e.g. getState(), getCurrentPosition(), geofence, persistence, sync, logging, scheduling, enterprise methods) is called before ready() (re-fixes #46)getState() returns a safe default disabled state before ready() instead of crashingUninitializedPropertyAccessException on lateinit var subsystem properties| Method Category | Behavior before ready() |
|---|---|
getState() |
Returns enabled=false, isMoving=false |
stop(), reset(), setConfig() |
Returns NOT_READY error or no-ops safely |
getCurrentPosition(), getLastKnownLocation() |
Callbacks with null |
| Geofence methods | Returns false / empty list |
getLocations(), getCount() |
Returns empty list / 0 |
sync() |
Callbacks with empty list |
dependencies:
tracelet: ^1.8.4
| Component | Version | Registry |
|---|---|---|
tracelet |
1.8.4 | pub.dev |
tracelet_platform_interface |
1.8.4 | pub.dev |
tracelet_android |
1.8.4 | pub.dev |
tracelet_ios |
1.8.4 | pub.dev |
tracelet_web |
1.8.4 | pub.dev |
com.ikolvi:tracelet-sdk |
1.0.4 | Maven Central |
TraceletSDK |
1.0.4 | CocoaPods |
CHORE: Version bump for iOS pre-ready guard fixes.
Patch release with stability fixes and enterprise dependency hardening.
Patch release with stability fixes and enterprise dependency hardening.
NoSuchMethodError on isLocationEnabled for API 26-27 devices - now uses LocationManagerCompat (#47)stop() before ready() completes - added isReady guard (#46)UninitializedPropertyAccessException for soundManager in motion state changes and destroyAll() - added isInitialized guards (#41)Class.forName - app runs without encryption when absentisAvailable() guard - device attestation silently disabled when absentSqlCipherMigrator for cleaner database encryption flow| Component | Registry | Version |
|---|---|---|
| tracelet-sdk | Maven Central | 1.0.2 |
| TraceletSDK | CocoaPods | 1.0.2 |
| tracelet_platform_interface | pub.dev | 1.8.2 |
| tracelet_android | pub.dev | 1.8.2 |
| tracelet_ios | pub.dev | 1.8.2 |
| tracelet_web | pub.dev | 1.8.2 |
| tracelet | pub.dev | 1.8.2 |
Closes: #41, #46, #47
iOS Periodic Mode: Removed CLBackgroundActivitySession from periodic tracking mode. This was causing the blue location indicator to remain permanently
CLBackgroundActivitySession from periodic tracking mode. This was causing the blue location indicator to remain permanently visible in the status bar, even though periodic mode only uses GPS briefly (~5 seconds) per fix.CLBackgroundActivitySession is now only used in continuous and geofence tracking modes where persistent background location is expectedCLServiceSession (iOS 18+) is kept for all modes — it preserves authorization without showing any indicatorBackgroundTaskHelper, temporary allowsBackgroundLocationUpdates, and BGAppRefreshTaskBackgroundActivitySessionManagerTests, ServiceSessionManagerTests, and PeriodicModeBackgroundSessionTests| Component | Version |
|---|---|
| Flutter packages | 1.8.1 |
| iOS SDK (CocoaPods) | 1.0.1 |
| Android SDK (Maven Central) | 1.0.1 |
Full Changelog: https://github.com/Ikolvi/Tracelet/compare/v1.8.0...v1.8.1
FEAT: Add destroySyncedLocations() Pigeon HostApi method — deletes only synced locations and returns count.
destroySyncedLocations() Pigeon HostApi method — deletes only synced locations and returns count.coords map).FEAT: Migrate all event delivery from EventChannels to Pigeon TraceletEventApi FlutterApi.
TraceletEventApi FlutterApi.PigeonEventReceiver with 15 broadcast StreamControllers for type-safe native→Dart event routing.PigeonTracelet platform implementation wrapping Pigeon HostApi + FlutterApi.sdk/android (Maven Central) and sdk/ios (CocoaPods/SPM) modules.FEAT: Add TraceletEventApi Pigeon FlutterApi with 15 event methods replacing EventChannels.
TraceletEventApi Pigeon FlutterApi with 15 event methods replacing EventChannels.PigeonEventReceiver with 15 broadcast StreamControllers for type-safe native→Dart event routing.PigeonTracelet platform implementation wrapping Pigeon HostApi + FlutterApi.TraceletPlatform interface.^1.6.3-alpha.1.Pin server certificates (PEM) or SHA-256 fingerprints to prevent MITM attacks. Native validation on both Android (OkHttp TLS) and iOS (URLSessionDeleg
Pin server certificates (PEM) or SHA-256 fingerprints to prevent MITM attacks. Native validation on both Android (OkHttp TLS) and iOS (URLSessionDelegate + CommonCrypto).
Set headers at runtime via setDynamicHeaders(), or register a callback with setHeadersCallback() for on-demand header generation (e.g., rotating auth tokens). Background-safe via registerHeadlessHeadersCallback().
Attach arbitrary metadata (routeId, driverId, vehicleId, etc.) to every synced location via setRouteContext(). Context is included in the HTTP sync body and cleared with clearRouteContext().
Full control over the HTTP sync payload via setSyncBodyBuilder(). Receives locations and route context, returns a custom Map or List. Background-safe via registerHeadlessSyncBodyBuilder().
Full Changelog: https://github.com/Ikolvi/Tracelet/compare/v1.5.0...v1.6.0
setDynamicHeaders, setRouteContext, clearRouteContext, registerHeadlessHeadersCallback, and registerHeadlessSyncBodyBuilder platform methods.^1.6.0.Locations are now auto-synced to your server even when the app is killed or the device reboots.
Locations are now auto-synced to your server even when the app is killed or the device reboots.
dependencies:
tracelet: ^1.5.0
Closes #39
^1.5.0.