notification_badge_plus 1.0.8

A Flutter plugin for displaying notification badges on app icons with comprehensive Android manufacturer support and iOS compatibility.

1.0.8

Release date: 2026-05-05

• 🧹 Auto-cleanup of legacy badge notification artifacts - Added LegacyBadgeNotificationCleaner that deletes the stale App Badge Notifications / Badge Notifications channels and cancels lingering "Badge Count" helper notifications left by plugin versions ≤ 1.0.6. Runs automatically on plugin start and before every setBadgeCount call.
• 🧰 New cleanLegacyBadgeNotifications() API - Exposes the cleanup explicitly so apps can trigger it on demand (e.g. during a migration step). No-op on iOS.

1.0.7

Release date: 2026-05-01

• 🐛 Fixed extra Android notification category - Removed the Oreo fallback provider that created a synthetic "Badge Count" notification/channel and caused duplicate badge entries.
• 🔧 Updated Xiaomi badge strategy - Switched from notification-based MIUI badge updates to launcher broadcast/provider updates so badge changes no longer create user-visible helper notifications.
• 📚 Docs & polish - Corrected README troubleshooting samples (NotificationBadgePlus), aligned background guide with non-notification MIUI behavior, avoided duplicate OPPO/OnePlus broadcasts, updated Nova Launcher package lookup for Android 13+, unified Dart error log prefix.

1.0.6

• ✨ Added iOS Permission Helpers - Added checkPermissions() and requestPermissions() to handle iOS notification badge permissions easily.
• 🔧 Fixed Podspec Versioning - Updated notification_badge_plus.podspec to match the current package version and repository URL.
• 📚 Improved iOS Documentation - Updated README with instructions and examples for handling iOS permissions.

1.0.5

• Verified repository URL - Finalized repository links and verified for production deployment.
• Improved documentation - Updated README and package metadata for better clarity and production readiness.

1.0.4

• 🔧 Fixed Android Namespace Issue - Resolved build failure by adding explicit namespace to android/build.gradle for AGP 8.0+ compatibility.
• 📱 Improved Android SDK Support - Upgraded compileSdkVersion to 35 and updated JavaVersion to 11 for better compatibility with modern Android development environments.

1.0.3

• 📦 Added Swift Package Manager (SPM) support - Added Package.swift file to enable Swift Package Manager compatibility for iOS
• ✨ Improved package scoring - Package now meets pub.dev requirements for SPM support, improving overall package score
• 🔧 iOS build system enhancement - Package can now be used with both CocoaPods and Swift Package Manager

1.0.2

• 🔧 Fixed iOS compilation errors - Resolved Swift compiler errors by removing non-existent getBadgeCount API calls
• 📱 Improved iOS compatibility - Use UIApplication.applicationIconBadgeNumber for consistent badge retrieval across all iOS versions

1.0.1

• Added SERVER_PAYLOAD_GUIDE.md with comprehensive instructions for server-side badge payloads (iOS/Android/FCM/APNs).
• Replaced all instances of "OEM" with "manufacturer" for clarity and consistency across documentation and code.
• Enhanced logging in Dart, Android (Kotlin), and iOS (Swift) code to improve workflow visibility in debug mode.
• Documentation updated to reflect terminology and logging improvements

1.0.0

• Initial release of notification_badge_plus package

🚀 Core Features

• Comprehensive Android support for notification badges including:
  • Samsung devices with native BadgeProvider integration
  • Xiaomi/Redmi/POCO devices with notification-based badges optimized for MIUI
  • Huawei/Honor devices with EMUI-compatible badge system
  • OPPO/OnePlus/Realme devices with ColorOS and OxygenOS support
  • Vivo/iQOO devices with FuntouchOS badge support
  • Sony devices with Xperia launcher integration
  • HTC devices with Sense UI badge support
  • LG devices with LG UX launcher compatibility
  • Nova Launcher support with TeslaUnread integration
  • Android Oreo+ default notification badges for stock Android

🍎 iOS Support

• Full iOS support for all iOS versions (9.0+)
• iOS 16+ compatibility with latest UNUserNotificationCenter APIs
• Legacy iOS support with UIApplication fallback methods
• Automatic background and foreground state management
• Badge persistence across app states and device restarts

🔄 Background/Foreground Handling

• Automatic app lifecycle management with WidgetsBindingObserver integration
• Badge count persistence across all app states (foreground, background, terminated)
• Seamless synchronization when app returns to foreground
• Push notification integration with background badge updates
• Cross-platform consistent behavior

📱 API Methods

• setBadgeCount(int count) - Set badge count with validation
• getBadgeCount() - Retrieve current badge count
• clearBadge() - Clear badge (set to 0)
• incrementBadge() - Increment badge by 1
• decrementBadge() - Decrement badge by 1 (minimum 0)
• isSupported() - Check device badge support
• getDeviceManufacturer() - Get device manufacturer (Android)

📚 Documentation

• Comprehensive README with usage examples and platform-specific details
• Background and Foreground Handling Guide - Detailed guide for lifecycle management
• Quick Reference Guide - Fast reference for common scenarios
• Complete example app demonstrating all features
• Troubleshooting guides for common issues
• Best practices and performance considerations

🔧 Technical Implementation

• Cross-platform API with consistent error handling
• Device manufacturer detection for optimal Android handling
• SharedPreferences persistence on Android
• Thread-safe iOS implementation
• Comprehensive logging and debugging support
• No external dependencies required
• Flutter 3.0+ and Dart 3.0+ compatibility