vietmap_tracking_plugin 1.0.4

A comprehensive Flutter plugin for GPS tracking and location data transmission to Vietmap's tracking API with background service support.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

---

1.0.4 - 2026-05-02

Changed

• Battery optimization — Further optimized tracking behavior to reduce power consumption on devices while maintaining stable location updates.

---

1.0.3 - 2026-04-30

Changed

• Battery optimization — Improved battery efficiency by optimizing GPS tracking intervals and reducing background wakeups.

Fixed

• Bug fixes — Various stability improvements and bug fixes.

---

1.0.2 - 2026-04-28

Added

• Flutter wrapper API — Added VietmapTrackingPlugin for configureTracking, configureAlertAPI, configureZoneNetworkV2, resetZoneNetworkV2, startAlert, stopAlert, and the new event streams.
• Auth mode toggle — Example app/provider can now switch tracking auth between header and query parameter via a single code flag.
• Unit tests — Added deterministic tests for the method channel routing and the new wrapper config methods.
• GPS payload contract v1.2 — Updated LocationData model to support new SDK payload format.

Changed

• LocationData serialization — toJson() now outputs GPS payload following new SDK contract (v1.2+) with time, int speed, and 12dp lat/lng.
• LocationData deserialization — fromJson() accepts both old keys (timestamp, latitude, longitude, bearing) and new keys (time, lat, lng, heading) for backward compatibility.

Fixed

• Test stability — Removed flutter_dotenv dependency from unit-test key constants so tests can run without local .env files.
• Speed serialization — Speed values now correctly converted to integer (0–32767) instead of float to match native SDK contract.
• Coordinate precision — Latitude/longitude now rounded to 12 decimal places (~1.1mm precision) for consistency with SDK expectations.

---

1.0.1 - 2026-04-24

Change

• Improve battery efficiency for devices by optimizing background tracking intervals and reducing wakeups.
• Reduce unnecessary location requests when tracking is idle or paused.
• Add offline tracking support to queue location events when the network is unavailable.
• Retry queued uploads automatically when connectivity is restored.
• Improve tracking stability when switching between foreground and background.

1.0.0 - 2026-02-27

Added

• Native SDK Integration — Direct bridge to VietmapTrackingSDK via platform channels (MethodChannel + EventChannel) on both iOS and Android. No third-party location wrappers.
• iOS Bridge (VietmapTrackingPlugin.swift) — Full implementation of all plugin methods: configure, configureAlertAPI, requestLocationPermissions, hasLocationPermissions, requestAlwaysLocationPermissions, startTracking, stopTracking, getCurrentLocation, isTrackingActive, getTrackingStatus, updateTrackingConfig, turnOnAlert, turnOffAlert.
• Android Bridge (VietmapTrackingPlugin.kt) — Full implementation matching iOS feature parity, including EventChannel support for location updates and tracking status, and the two-step background permission flow for Android 10+.
• EventChannel Streams — onLocationUpdate (Stream<LocationData>) and onTrackingStatusChanged (Stream<TrackingStatus>) for real-time event delivery from native SDK to Dart.
• Speed Alert System — turnOnAlert() and turnOffAlert() methods bridging to native SDK alert functionality. Requires separate Alert API credentials via configureAlertAPI().
• Tracking Presets — TrackingPresets.navigation(), TrackingPresets.fitness(), TrackingPresets.general(), TrackingPresets.batterySaver() with pre-tuned parameters.
• Permission Management — Unified PermissionResult model with detailed fields: granted, status, fineLocation, coarseLocation, backgroundLocation.
• Location Utilities — LocationUtils class with Haversine distance calculation, speed conversion, coordinate formatting, and radius checking.
• Dart Unit Tests — 89 tests covering method channel routing, model serialization/deserialization, and platform interface contract.
• iOS XCTests — Comprehensive test suite in RunnerTests.swift covering all bridge methods, error handling, and data structure validation.
• Android JVM Unit Tests — VietmapTrackingPluginTest.kt with tests for method routing, argument validation, guard checks, and data structure validation.
• Android Instrumented Tests — VietmapTrackingPluginInstrumentedTest.kt for testing with real SDK on device/emulator.

Architecture

Flutter App (Dart)
  └── VietmapTrackingController (singleton)
        └── VietmapTrackingPlatform (platform interface)
              └── MethodChannelVietmapTracking
                    ├── MethodChannel: vietmap_tracking_plugin
                    ├── EventChannel: /location_updates
                    └── EventChannel: /tracking_status
                          ├── iOS: VietmapTrackingPlugin.swift → VietmapTrackingSDK 1.1.6
                          └── Android: VietmapTrackingPlugin.kt → VietmapTrackingSDK 1.2.2

Platform Support

• iOS: 11.0+ (VietmapTrackingSDK via CocoaPods xcframework)
• Android: API 21+ (VietmapTrackingSDK via JitPack)
• Flutter: 3.3.0+
• Dart: 3.8.0+

Dependencies

• plugin_platform_interface: ^2.0.2
• background_location_2: ^0.16.3
• connectivity_plus: ^6.1.4
• flutter_background_service: ^5.1.0
• flutter_local_notifications: ^19.3.0
• geolocator: ^14.0.1
• http: ^1.1.0
• shared_preferences: ^2.5.3

Notes

• updateTrackingConfig() internally performs stopTracking() followed by startTracking(newConfig). This resets the tracking session. See README for details.
• Android background location permission follows the two-step flow required by Android 10+: foreground permission first, then background permission in a separate request.

---

1.0.0-alpha.1 - 2024-12-19

Added

• Initial alpha release with basic plugin structure.
• Background location tracking via third-party packages.
• HTTP API integration with retry logic and offline caching.
• Basic permission management.
• Example application.