firebase_messaging

• Update a dependency to the latest release.

• FIX: Ensure onMessage callback is consistently called on iOS platform. (#8202). (54f5555e)

2022-03-10

Changes

---

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• firebase_messaging - v11.2.10

---

• FIX: Update notification key to NSApplicationLaunchUserNotificationKey for macOS. (#8251). (46b54ccd)

2022-03-10

Changes

---

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• cloud_functions - v3.2.10
• firebase_auth - v3.3.10
• firebase_dynamic_links - v4.1.0
• firebase_dynamic_links_platform_interface - v0.2.2
• firebase_messaging - v11.2.9
• flutterfire_ui - v0.3.6

---

• FIX: getInitialMessage returns notification once & only if pressed for iOS. (#7634). (85739b4c)

• FIX: update all Dart SDK version constraints to Dart >= 2.16.0 (#8184). (df4a5bab)

• FIX: Stream new token via onTokenRefresh when getToken invoked for iOS. (#8166). (28b396b8)

• FIX: Set APNS token if user initializes Firebase app from Flutter. (#7610).

• FIX: bump Android compileSdkVersion to 31 (#7726).

• FIX: Return app constants for default app only on Android. (#7592).

• Update a dependency to the latest release.

• DOCS: Fix typos and remove unused imports (#7504).

• Update a dependency to the latest release.

• FEAT(database): Swift Package Manager support (#16783). (1509c33e)

• FEAT: bump iOS SDK to version 11.0.0 (#13158). (c0e0c997)
• DOCS: remove reference to flutter.io and firebase.flutter.dev (#13152). (5f0874b9)

• BREAKING REFACTOR: android plugins require minSdk 21, auth requires minSdk 23 ahead of android BOM >=33.0.0 (#12873). (52accfc6)
• BREAKING REFACTOR: bump all iOS deployment targets to iOS 13 ahead of Firebase iOS SDK v11 breaking change (#12872). (de0cea2c)
• BREAKING REFACTOR(analytics): remove deprecated API ahead of breaking change release (#12858). (f22f46a1)
• BREAKING FIX(analytics): fix typing of event parameters to Map<String, Object>? (#12427). (3705ee1b)

• REFACTOR: remove deprecated Flutter Android v1 Embedding usages, including in example app (#7158).
• FIX: Fix crash. If intent.getExtras() returns null, do not attempt to handle RemoteMessage #6759 (#7094).
• STYLE: macOS & iOS; explicitly include header that defines TARGET_OS_OSX (#7116).

• REFACTOR: remove a deprecated FallThroughError (#10143). (8af7fb41)

• FIX: was creating a new instance each time (#6961).

• FIX: cache the result of event.snapshot to be able to compare the value (#9899). (5f32b812)

• Update a dependency to the latest release.

• DOCS: update web example in line with flutter 2.2.0 generated index.html (#6398).
• CHORE: update v2 embedding support (#6506).
• CHORE: rm deprecated jcenter repository (#6431).

• REFACTOR: add verify to QueryPlatform and change internal verifyToken API to verify (#9711). (c99a842f)

• Update a dependency to the latest release.

• FIX: Fix FirebaseMessaging.onMessage and onMessageOpenedApp potentially throwing (#6093).
• DOCS: Add Flutter Favorite badge (#6190).
• CHORE: fix broken messaging example (#6176).

• BREAKING FEAT: Firebase iOS SDK version: 10.0.0 (#9708). (9627c56a)

• FIX: Send default parameters for iOS when using setDefaultEventParameters() API. (#8402). (7d3e5ba6)

• Update a dependency to the latest release.

• FIX: update all Dart SDK version constraints to Dart >= 2.16.0 (#8184). (df4a5bab)

• DOCS: code comment typo - logAdImpression mentions wrong event (#8180). (960a75a7)

• FEAT(auth,ios): add support for migrateCurrentUser (#18460). (b4eeafba)

• FIX: use jsify() with event parameters for logEvent() so they are sent (#7509).

• Bump platform interface a major version due to pigeon dependency update

• REFACTOR: move all packages to workspace (#18182). (6cdfcb10)

• FIX: update core, auth and app-check logic so internal resources on method channels are properly disposed (#18268). (a0de4ed8)

• FEAT: upgrade pigeon to version 26.3.4 (#18205). (cb6b4aef)

• FEAT(auth,android): add revokeAccessToken support for Android (#18206) (#18207). (7e0a2227)

• FIX: fix unhandled exception (#4676).

• TESTS: update mockito API usage in tests

Note: This release has breaking changes.

• BREAKING REFACTOR: migrate to NNBD (#4909).
• BREAKING: the following deprecated APIs have been removed:
  • iOSNotificationSettings.
  • requestNotificationPermissions - use requestPermission instead.
  • autoInitEnabled() - use setAutoInitEnabled() instead.
  • deleteInstanceID() - use deleteToken() instead.
  • FirebaseMessaging() - use FirebaseMessaging.instance instead.

• DOCS: fix messaging regex examples (#4649).

Note: This release has breaking changes.

• FEAT: add check on podspec to assist upgrading users deployment target.
• BUILD: commit Podfiles with 10.12 deployment target.
• BUILD: remove default sdk version, version should always come from firebase_core, or be user defined.
• BUILD: set macOS deployment target to 10.12 (from 10.11).
• BREAKING BUILD: set osx min supported platform version to 10.12.

Note: This release has breaking changes.

• FIX: Add missing sdk version constraints inside pubspec.yaml (#4604).
• FEAT: bump firebase-android-sdk BoM to 25.13.0.
• CHORE: harmonize dependencies and version handling.
• BREAKING FEAT: forward port to firebase-ios-sdk v7.3.0.
  • Due to this SDK upgrade, iOS 10 is now the minimum supported version by FlutterFire. Please update your build target version.

• REFACTOR: initial web release as pre-release version.
• FIX: manually create a FlutterShellArgs instance from Android activity intent (fixes #4078) (#4341).
• FIX: fixed callback handler type casting on Android (#4313).
• FIX: macOS should not use FIRAuth canHandleNotification as it's iOS only (fixes #4136) (#4340).
• FIX: some iOS methods could result in an no implementation found error (#4339).

• FEAT: web implementation (#4206).
• FEAT: bump android com.android.tools.build & 'com.google.gms:google-services versions (#4269).

• TEST: Explicitly opt-out from null safety.
• FIX: various data types issues in remote message (#4150).
• FIX: java String arrays should be converted to a List (fixes #4072) (#4092).
• CHORE: bump gradle wrapper to 5.6.4 (#4158).

• FIX: potential crash (fixes #4032) (#4071).

• Update a dependency to the latest release.

• REFACTOR: use invokeMapMethod instead of invokeMethod (#4048).
• FIX: don't replace UNUserNotificationCenter delegate when protocol conforms to FlutterApplicationLifeCycleDelegate (#4043).

• FIX: crash when senderId null (fixes #4024) (#4025).

• FEAT: roadmap rework (#4012).

• FIX: assert.
• FEAT: notification persistence.
• FEAT: add senderId (use iid on Android to support it).

• FEAT: bump firebase sdk version to 6.33.0.
• DOCS: typos.

This plugin is now federated to allow integration with other platforms, along with upgrading underlying SDK versions.

We've also added lots of features which can be seen in the changelog below, however notably the biggest changes are:

• Removed all manual native code changes that were originally required for integration - this plugin works out of the box once configured with Firebase & APNs.

• Support for macOS.

• iOS background handler support.

• Android background handler debugging and logging support.

• Android V2 embedding support.

• Reworked API for message handling (Streams + explicit handlers).

• Fully typed Message & Notification classes (vs raw Maps).

• New Apple notification permissions & support.

• Detailed documentation.

• FirebaseMessaging:

  • BREAKING: configure() has been removed in favor of calling specific static methods which return Streams.
    • Why?: The previous implementation of configure() caused unintended side effects if called multiple times (either to register a different handler, or remove handlers). This change allows developers to be more explicit about registering handlers and removing them without effecting others via Streams.
  • DEPRECATED: Calling FirebaseMessaging() has been deprecated in favor of FirebaseMessaging.instance & FirebaseMessaging.instanceFor().
  • DEPRECATED: requestNotificationPermissions() has been deprecated in favor of requestPermission().
  • DEPRECATED: deleteInstanceID() has been deprecated in favor of deleteToken().
  • DEPRECATED: autoInitEnabled() has been deprecated in favor of isAutoInitEnabled.
  • NEW: Added support for isAutoInitEnabled as a synchronous getter.
  • NEW: Added support for getInitialMessage(). This API has been added to detect whether a messaging containing a notification has caused the application to be opened via users interaction.
  • NEW: Added support for deleteToken().
  • NEW: Added support for getToken().
  • NEW: [Apple] Added support for getAPNSToken().
  • NEW: [Apple] Added support for getNotificationSettings(). See NotificationSettings below.
  • NEW: [Apple] Added support for requestPermission(). See NotificationSettings below. New permissions such as carPlay, crtiticalAlert, announcement are now supported.
  • NEW: [Android] Added support for sendMessage(). The sendMessage() API enables support for sending FCM payloads back to a custom server from the device.
  • NEW: [Android] When receiving background messages on the separate background Dart executor whilst in debug, you should now see flutter logs and be able to debug/add breakpoints your Dart background message handler.
  • NEW: [Apple] Added support for setForegroundNotificationPresentationOptions(). By default, iOS devices will not show notifications in the foreground. Use this API to override the defaults. See documentation for Android foreground notifications.
  • NEW - [Android] Firebase Cloud Messages that contain a notification are now always sent to Dart regardless of whether the app was in the foreground or background. Previously, if a message came through that contained a notification whilst your app was in the foreground then FCM would not notify the plugin messaging service of the message (and subsequently your handlers in Dart) until the user interacted with it.

• Event handling:

  • Event handling has been reworked to provide a more intuitive API for developers. Foreground based events can now be accessed via Streams:
    • NEW: FirebaseMessaging.onMessage Returns a Stream that is called when an incoming FCM payload is received whilst the Flutter instance is in the foreground, containing a [RemoteMessage].
    • NEW: FirebaseMessaging.onMessageOpenedApp Returns a [Stream] that is called when a user presses a notification displayed via FCM. This replaces the previous onLaunch and onResume handlers.
    • NEW: FirebaseMessaging.onBackgroundMessage() Sets a background message handler to trigger when the app is in the background or terminated.

• IosNotificationSettings:

  • DEPRECATED: Usage of the IosNotificationSettings class is now deprecated (currently used with the now deprecated requestNotificationPermissions() method).
    • Instead of this class, use named arguments when calling requestPermission() and read the permissions back via the returned NotificationSettings instance.

• NotificationSettings:

  • NEW: A NotificationSettings class is returned from calls to requestPermission() and getNotificationSettings(). It contains information such as the authorization status, along with the platform specific settings.

• RemoteMessage:

  • NEW: Incoming FCM payloads are now represented as a RemoteMessage rather than a raw Map.

• RemoteNotification:

  • NEW:When a message includes a notification payload, the RemoteMessage includes a RemoteNotification rather than a raw Map.

• Other:

  • Additional types are available throughout messaging to aid with the latest changes:
    • BackgroundMessageHandler, AppleNotificationSetting, AppleShowPreviewSetting, AuthorizationStatus , AndroidNotificationPriority, AndroidNotificationVisibility

• Update a dependency to the latest release.

• FIX: remove platform package usage (#3729).

• FIX(core,iOS): use namespaced iOS Pigeon header import (#18281). (7c1257e7)

• Bump platform interface a major version due to pigeon dependency update

• REFACTOR: move all packages to workspace (#18182). (6cdfcb10)

• FEAT: upgrade pigeon to version 26.3.4 (#18205). (cb6b4aef)

• Fix push notifications clearing after app launch on iOS.

• Fix - register pluginRegistrantCallback on every FcmDartService#start call.