v0.0.6

Full Changelog: v0.0.5...v0.0.6

v0.0.5

Full Changelog: v0.0.4...v0.0.5

iOS SPM support added

Full Changelog: v0.0.3...v0.0.4

v0.0.3 - Initial Release

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.

[0.0.3] - 2026-01-27

[0.0.2] - 2026-01-27

Changed

• SDK compatibility: Relaxed Dart SDK constraint from ^3.10.7 to ">=3.0.0 <4.0.0" for broader compatibility with Flutter projects

Fixed

• Code formatting improvements in Android plugin implementation

[0.0.1] - 2026-01-27

Added

• Initial release of the connectivity_validator plugin
• Validated connectivity checking: Detects real internet access, not just network connection
• Captive portal detection: Identifies when connected to WiFi but behind a captive portal
• Real-time updates: Stream-based API (onConnectivityChanged) for continuous connectivity monitoring
• Android implementation:
  • Uses ConnectivityManager.NetworkCallback for real-time network monitoring
  • Checks NET_CAPABILITY_INTERNET and NET_CAPABILITY_VALIDATED capabilities
  • Sends the initial state immediately when the stream is listened to
  • Optimized to only emit updates when the connectivity state actually changes
• iOS implementation:
  • Uses NWPathMonitor for network path monitoring
  • Checks .satisfied status to detect validated connectivity
  • Handles network state changes on the background queue
  • Sends updates to Flutter on the main thread
• Example app:
  • Complete working example demonstrating plugin usage
  • GetX-based state management example with NetworkStatusController.
  • Visual indicators (icons and colors) for connectivity status
  • Real-time UI updates using reactive state management
• Comprehensive documentation:
  • Detailed README with installation instructions
  • Multiple state management examples (StreamBuilder, GetX, Provider, Riverpod, BLoC, ValueNotifier)
  • API reference documentation
  • Platform-specific implementation details
  • Best practices and troubleshooting guide

Technical Details

• Channel name: connectivity_validator/status (consistent across all platforms)
• Zero dependencies: The plugin itself has no external dependencies
• Framework-agnostic: Works with any state management solution
• Optimized: Prevents duplicate emissions by tracking the last state
• Thread-safe: Properly handles main thread requirements for Flutter communication

Platform Support

• ✅ Android (API 24+)
• ✅ iOS (iOS 12.0+)