notificationapi_flutter_sdk 2.1.0
notificationapi_flutter_sdk: ^2.1.0 copied to clipboard
A Flutter plugin for integrating NotificationAPI push notifications into your mobile app.
Changelog #
All notable changes to this project will be documented in this file.
2.1.0 - 2025-09-02 #
Added #
- π Region support for EU and CA via
regionparameter- API endpoints automatically route to
euandcaregions - Default remains
us
- API endpoints automatically route to
2.0.5 - 2024-03-21 #
Changed #
- π¦ Package update - Provided better utility methods for push token management
2.0.4 - 2024-03-21 #
Fixed #
- π§ Permission handling - Fixed issue where notification permission is revoked but was previously granted
2.0.2 - 2024-12-20 #
Fixed #
- π§ Notification parsing - Fixed title and body extraction from push messages to correctly handle backend data format
- π± FCM compatibility - Now properly extracts title and body from
datafield for FCM notifications - π APN compatibility - Now properly extracts title and body from
alertobject for APN notifications - π Backward compatibility - Maintains fallback to standard notification fields if custom format not found
2.0.1 - 2024-12-20 #
Fixed #
- π§ Package publishing - Minor fixes and improvements for pub.flutter-io.cn compatibility
2.0.0 - 2024-12-20 #
BREAKING CHANGES #
- π Native APN support for iOS - iOS now uses Apple Push Notifications directly, no Firebase routing required
- π₯ Removed Firebase dependencies for iOS - Eliminated
firebase_messagingandfirebase_coredependencies - π± Platform-specific push tokens - FCM tokens on Android, APN tokens on iOS
- β‘ Improved performance - Reduced latency for iOS notifications by removing Firebase intermediate step
Added #
- π Direct APN integration - Native iOS push notifications without Firebase
- π― Cross-platform push package - Unified push notification handling across platforms
- π§ Simplified architecture - Removed service abstraction layer for cleaner code
Changed #
- iOS setup - No longer requires Firebase configuration on iOS
- Token handling - Platform-specific token types (APN for iOS, FCM for Android)
- Dependencies - Replaced Firebase dependencies with
push: ^3.3.3package - Performance - Faster iOS notification delivery through direct APN connection
Removed #
- Firebase dependencies for iOS (
firebase_messaging,firebase_core) - Push notification service abstraction layer
- Firebase initialization requirement for iOS
Migration Guide #
For iOS developers:
- Remove Firebase configuration files if only using for push notifications
- No code changes required - API remains the same
- Enjoy faster notification delivery!
For Android developers:
- Firebase setup still required for FCM
- No code changes required
Dependencies #
push: ^3.3.3(replaces Firebase dependencies)flutter_local_notifications: ^17.2.2http: ^1.1.0shared_preferences: ^2.2.2device_info_plus: ^10.1.0
1.0.3 - 2024-12-20 #
Fixed #
- π§ Android namespace declaration - Added required
namespaceproperty tobuild.gradlefor modern Android Gradle Plugin compatibility - π AGP compatibility - Resolved "Namespace not specified" error with newer Android Gradle Plugin versions
- π± Build configuration - Ensured proper namespace declaration as required by current Android tooling standards
1.0.2 - 2024-12-20 #
Fixed #
- π§ Android build configuration - Added missing
build.gradle,AndroidManifest.xml, andgradle.propertiesfiles - π Flutter 3.32.0 compatibility - Resolved "Configuration with name 'implementation' not found" errors
- βοΈ Gradle setup - Fixed NullPointerException during project evaluation
- π± Plugin integration - Ensured proper Android plugin structure for modern Flutter versions
Technical Details #
- Added complete Android build configuration with Kotlin support
- Included AndroidX compatibility settings
- Added proper Gradle plugin declarations and dependency management
- Fixed plugin structure to meet current Flutter plugin standards
1.0.1 - 2024-12-20 #
Changed #
- Published under verified publisher
notificationapi.com - No functional changes from 1.0.0
1.0.0 - 2024-12-20 #
Added #
- π One-line setup - Single
NotificationAPI.setup()call replaces complex multi-step initialization - π Automatic native notifications - Built-in foreground notification display with
flutter_local_notifications - π± Cross-platform support - Full iOS and Android compatibility
- π Background notification handling - Complete support for notifications when app is closed/terminated
- π Automatic permission management - Optional auto-request of push notification permissions
- π― Deep linking support - Handle navigation when notifications are tapped
- πΎ User persistence - Automatic user data storage across app launches
- π Token management - Automatic FCM token retrieval and backend synchronization
- π‘οΈ Graceful error handling - No thrown exceptions, returns safe defaults
- π Real-time streams - Listen to foreground and tap events with reactive streams
Features #
- Simplified API replacing complex client/service architecture
- Firebase Messaging integration
- Local notification display in foreground
- SharedPreferences-based user persistence
- HTTP-based backend communication
- Comprehensive example app
- Detailed documentation with setup guides
Dependencies #
firebase_messaging: ^14.7.9firebase_core: ^2.24.2flutter_local_notifications: ^17.2.2http: ^1.1.0shared_preferences: ^2.2.2
Platform Support #
- Flutter: >=3.0.0
- Dart: >=3.0.0 <4.0.0
- iOS: iOS 10.0+
- Android: API level 21+ (Android 5.0)