Firebase Cloud Messaging (FCM) is a cross-platform messaging solution that lets you reliably send messages at no cost.
Using FCM, you can notify a client app that new email or other data is available to sync. You can send notification messages to drive user re-engagement and retention. For use cases such as instant messaging, a message can transfer a payload of up to 4 KB to a client app.
- Null safety
Ensure you're using the Flutter
If your app is mixing legacy and null-safe packages, use the
For legacy package imports, place the following ignore comment to hide Dart analyzer warnings:
firebase_messaging dependency to your projects
- Null safety
If you are using Flutter Android Embedding V2 (Flutter Version >= 1.12) then no additional integration steps are required for Android.
For the Flutter Android Embedding V1, the background service must be provided a callback to register plugins with the
background isolate. This is done by giving the
FlutterFirebaseMessagingBackgroundService a callback to call your
In particular, its
Which is usually reflected in the application's
Note: Not calling
FlutterFirebaseMessagingBackgroundService.setPluginRegistrantwill result in an exception being thrown when a message eventually comes through.
iOS & macOS require additional configuration before you can start receiving messages through Firebase. Read the integration documentation on how to setup iOS or macOS with Firebase Cloud Messaging.
If using FlutterFire on the web, add the
Once complete, rebuild your Flutter application:
Once installed, you're ready to start using Firebase Cloud Messaging in your Flutter Project.
View the Usage documentation to get started.