⚠️ Beta Release: SDK compatibility and platform optimization. Not recommended for production use.

Changed #

• 🔄 SDK Compatibility: Lowered Dart SDK constraint to ^3.0.0 for broader compatibility
• 🔄 Android Optimizations: Refactored to use Kotlin Coroutines for efficient background processing and better memory management
• 🔄 iOS Safety: Enhanced memory safety in Swift plugin using weak references ([weak self]) to prevent retain cycles
• 🔄 Example App: Updated dependencies and configuration

Fixed #

• 🐛 Platform Stability: Resolved potential memory leaks and threading issues on both platforms
• 🐛 Version Sync: Ensured version strings match across all platform files

Technical Notes #

• Method channel: com.music_feature_analyzer/audio_metadata
• Flutter 3.0.0+, Dart 3.0.0+
• Android API 21+, iOS 12.0+

⚠️ Beta Release: Plugin discovery configuration fix. Not recommended for production use.

Changed #

• 🔄 Plugin Configuration: Enabled default_package: music_feature_analyzer in Android plugin configuration to improve plugin discovery
• 🔄 Plugin Discovery: This should help Flutter's plugin discovery mechanism find the plugin automatically

Fixed #

• 🐛 Plugin Discovery: Fixed potential plugin discovery issues by explicitly setting default_package

Technical Notes #

• Method channel: com.music_feature_analyzer/audio_metadata
• Flutter 3.0.0+, Dart 3.8.1+
• Android API 21+, iOS 12.0+

⚠️ Beta Release: Android plugin structure improvements and code quality enhancements. Not recommended for production use.

Changed #

• 🔄 Android Plugin Structure: Moved plugin file to proper package structure (com/music_feature_analyzer/)
• 🔄 Package Declaration: Added proper package declaration for better plugin discovery
• 🔄 Code Quality: Added @Suppress("unused") annotation to prevent false warnings
• 🔄 Loading Mode Detection: Enhanced loading mode detection with comprehensive path checking
• 🔄 Example App: Cleaned up MainActivity.kt (removed manual registration workaround)

Fixed #

• 🐛 Plugin Discovery: Fixed plugin file location to match package structure
• 🐛 Code Organization: Removed duplicate plugin file from incorrect location

Technical Notes #

• Method channel: com.music_feature_analyzer/audio_metadata
• Flutter 3.0.0+, Dart 3.8.1+
• Android API 21+, iOS 12.0+

⚠️ Beta Release: Code quality improvements and import cleanup. Not recommended for production use.

Fixed #

• 🐛 Code Quality: Removed unnecessary imports in feature extractor and metadata service
• 🐛 Test Imports: Cleaned up redundant imports in test files
• ✅ Lint Compliance: All lib and test files now pass Flutter analyze with no issues

Technical Notes #

• Method channel: com.music_feature_analyzer/audio_metadata
• Flutter 3.0.0+, Dart 3.8.1+
• Android API 21+, iOS 12.0+

⚠️ Beta Release: Documentation and error message improvements. Not recommended for production use.

Changed #

• 🔄 Improved Documentation: Clarified zero-configuration setup for published packages
• 🔄 Better Error Messages: More accurate troubleshooting guidance distinguishing published vs local packages
• 🔄 README Updates: Explicitly states no platform-specific configuration needed for pub.dev packages

Fixed #

• 📝 Documentation Clarity: Removed confusion about manual registration requirements
• 📝 Permission Documentation: Clarified that permissions are optional (only needed for media library access)

Technical Notes #

• Method channel: com.music_feature_analyzer/audio_metadata
• Flutter 3.0.0+, Dart 3.8.1+
• Android API 21+, iOS 11.0+

⚠️ Beta Release: Major native plugin improvements. Not recommended for production use.

Added #

• ✅ Rewritten Native Plugins: Android and iOS plugins rebuilt for better performance and stability
• ✅ iOS AVFoundation Integration: Full metadata extraction using AVAsset
• ✅ Album Art MIME Detection: Automatic detection of embedded artwork formats
• ✅ Improved Metadata Parsing: Better handling of track/disc numbers and year/date formats
• ✅ Enhanced Platform Verification: Extended verifyConnection() with platform details
• ✅ Graceful Error Recovery: Safe handling of corrupted or incomplete audio files

Changed #

• 🔄 Optimized Native Threading: Improved background execution and main-thread safety
• 🔄 Better Resource Management: Proper cleanup to avoid memory leaks
• 🔄 Improved Method Channel Stability: Reduced overhead and more reliable communication

Fixed #

• 🐞 Android file size overflow issues
• 🐞 Album art detection inconsistencies
• 🐞 Metadata parsing edge cases
• 🐞 Native concurrency and memory issues

Technical Notes #

• Method channel: com.music_feature_analyzer/audio_metadata
• Flutter 3.0.0+, Dart 3.8.1+
• Android API 21+, iOS 11.0+

⚠️ Beta Release: This version may have issues. Not recommended for production use.

Added #

• ✅ Automatic Native Code Registration via Flutter plugin system
• ✅ Metadata Extraction APIs: metadata() and extractMetadataBatch()
• ✅ Comprehensive Audio Metadata: Title, artist, album, album art, genre, year, track/disc number, bitrate, file size, and more
• ✅ Permission Helpers: Platform-specific permission guidance utilities
• ✅ Setup Verification: verifyPlatformSetup() to validate native configuration
• ✅ Platform Guides: Android and iOS integration documentation

Changed #

• 🔄 Simplified Setup: No manual MainActivity.kt or AppDelegate.swift changes required
• 🔄 Improved Error Messages: Clearer setup and runtime guidance
• 🔄 Documentation Updates: All guides updated for automatic registration

Technical Notes #

• Flutter plugin-based architecture
• Android plugin implements FlutterPlugin
• iOS plugin implements FlutterPlugin
• Thread-safe native operations
• File size overflow protection
• Optimized method channel handling
• Reduced verbose native logging

Added #

• 🎉 Initial release of Music Feature Analyzer
• 🎵 YAMNet AI integration for genre, mood, and instrument detection
• 🎚 Advanced signal processing for tempo, energy, and spectral features
• 📊 20+ extracted musical features
• 📦 Batch processing with progress callbacks
• 📱 Cross-platform support for Android and iOS
• 🧩 Freezed-based data models
• 🔄 JSON serialization support