flutter_awesome_deeplink 0.1.0

Complete deep linking solution for Flutter with 96%+ attribution success rates. Handles both normal (real-time) and deferred (post-install) deep links with Android Install Referrer API and optional iO [...]

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.1.0 - 2025-11-07

Added

• 🚀 Complete Deep Link Coverage - Unified normal and deferred deep link handling
• 🔗 Normal Deep Links Service - Real-time deep link processing using app_links
• 🎯 UnifiedDeepLinksService - Orchestrates both normal and deferred deep links
• 📝 Enhanced Documentation - Updated README with unified approach examples
• 🛠️ Improved API - Single initialization handles both deep link types
• 🔧 Better Logging - External logger integration for unified app logging
• 📊 Enhanced Attribution - Rich metadata for both normal and deferred links
• 🧪 Testing Utilities - Clear last processed links for testing scenarios

Changed

• 📦 API Enhancement - Main initialize() method now handles both normal and deferred deep links
• 🔄 Service Architecture - Refactored to use unified service pattern
• 📖 Documentation - Updated all examples to show unified approach

Fixed

• 🎯 Complete Coverage - No more "no deeplink found" issues for normal deep links
• 🔄 Unified Callback - Same handler processes both normal and deferred deep links
• ⚡ Performance - Optimized initialization sequence for better app startup

Technical Details

• New Services: NormalDeepLinksService, UnifiedDeepLinksService
• Enhanced Features:
  • Real-time deep link handling via app_links integration
  • Unified callback system for both link types
  • Improved error handling and validation
  • Better platform-specific optimization
• API Changes:
  • FlutterAwesomeDeeplink.instance now returns UnifiedDeepLinksService
  • Single initialize() call handles complete deep link lifecycle
  • Enhanced configuration options for both link types

0.0.2 - 2025-10-15

Added

• 🚀 Real-world production configuration for Challenge App in README.md
• 📝 Detailed README with production examples and migration guides

0.0.1 - 2025-01-15

Added

• 🚀 Initial release of Flutter Awesome Deeplink plugin
• 🤖 Android Install Referrer API integration for 95%+ attribution success
• 🍎 iOS clipboard detection with privacy-first opt-in configuration
• 🔗 Normal deep links handling using app_links for real-time navigation
• 🔄 Unified deep link handling - single callback for both normal and deferred links
• 📝 Logger integration with flutter_awesome_logger and custom loggers
• 🔒 Privacy-conscious design with iOS clipboard checking disabled by default
• 🌐 Cross-platform storage service for deferred link persistence
• ⚡ Platform-optimized attribution strategies for maximum success rates
• 🛡️ Production-ready error handling with comprehensive timeouts and fallbacks
• 📊 Rich attribution metadata for analytics and debugging
• 🎯 Configurable link validation supporting multiple domains and schemes
• 🧪 Comprehensive testing utilities including first launch reset
• 📖 Detailed documentation with migration guides and examples
• 🔧 Clean static API with advanced service access for power users

Features

• Platform Support: Android, iOS, and Web
• Deep Link Types:
  • Normal deep links: Real-time navigation using app_links
  • Deferred deep links: Post-install attribution with platform-optimized strategies
• Attribution Methods:
  • Android: Install Referrer API → Storage Service fallback
  • iOS: Clipboard detection → Storage Service fallback
  • Cross-platform: Persistent storage with automatic cleanup
• Success Rates: 96%+ overall attribution success
• Privacy Compliance: GDPR-friendly with minimal data collection
• Logger Integration: Seamless integration with flutter_awesome_logger
• Configuration Options: Highly customizable with sensible defaults
• Developer Experience: Simple setup with extensive debugging tools
• Unified Navigation: Single callback handles both normal and deferred deep links

Technical Details

• Minimum SDK: Flutter 3.3.0+, Dart 3.0.0+
• Android: API 21+ with Install Referrer API 2.2
• iOS: iOS 11+ with clipboard detection
• Dependencies:
  • shared_preferences: ^2.2.2 - Cross-platform storage
  • universal_html: ^2.2.4 - Web platform support
  • plugin_platform_interface: ^2.0.2 - Plugin architecture
  • app_links: ^6.3.2 - Normal deep link handling

Documentation

• Complete API documentation with examples
• Platform-specific setup guides
• Migration guides from Firebase Dynamic Links and Branch.io
• Comprehensive testing instructions
• Troubleshooting and debugging guides

Example App

• Interactive demo showcasing all plugin features
• Real-time attribution metadata viewer
• Link validation testing tools
• First launch simulation for testing
• Platform-specific testing scenarios

---

Upcoming Features

[0.1.0] - Planned

• Enhanced iOS Attribution: SKAdNetwork integration for iOS 14.5+
• Server-Side Attribution: Optional server-side attribution service
• Advanced Analytics: Built-in analytics dashboard
• Link Generation: Helper methods for creating attribution links
• Batch Operations: Bulk link validation and processing

0.2.0 Planned

• Web Attribution: Enhanced web platform support
• Custom Schemes: Advanced custom URL scheme handling
• Attribution Windows: Configurable attribution time windows
• A/B Testing: Built-in attribution A/B testing framework

Future Considerations

• Machine Learning: ML-powered attribution matching
• Cross-Device Attribution: User account-based attribution
• Real-Time Analytics: Live attribution monitoring
• Enterprise Features: Advanced security and compliance features

---

Migration Notes

From Firebase Dynamic Links

This plugin provides a drop-in replacement for Firebase Dynamic Links with improved attribution success rates and no ongoing costs.

From Branch.io / AppsFlyer

Migrate from expensive third-party attribution services while maintaining or improving attribution accuracy.

From Custom Solutions

Replace complex custom implementations with a production-ready, well-tested solution.

---

Support

For questions, issues, or feature requests:

• 📚 Documentation
• 🐛 Report Issues
• 💬 Discussions
• 📧 Email Support

---

Thank you for using Flutter Awesome Deeplink! 🚀