|Your help is appreciated. Create a PR, submit a bug or just grab me 🍺|
$ cordova plugin add cordova-plugin-firebase-messaging
If you get an error about CocoaPods being unable to find compatible versions, run
$ pod repo update
ANDROIDX_CORE_VERSION to override dependency versions on Android.
In general (for both platforms) you can only rely on custom data fields from a FCM payload.
For iOS APNS payload is stored in
aps object. It's available when a message arrives in both foreground and background.
For Android GCM payload is stored in
gcm. It's available ONLY when a message arrives in foreground. For a some reason Google applied this limitation into their APIs. Anyway I've created an issue for a future improvement.
Called when a push message received while app is in foreground.
Called when a push message received while app is in background.
Grant permission to recieve push notifications (will trigger prompt on iOS).
options object you can specify a boolean setting
true this setting forces notification to display even when app is in foreground:
Returns a promise that fulfills with the current FCM token.
This method also accepts optional argument
type. Currently iOS implementation supports values
"apns-string" that defines presentation of resolved APNS token:
Delete the Instance ID (Token) and the data associated with it. Call getToken to generate a new one.
Triggers every time when FCM token updated. You should usually call
getToken to get an updated token and send it to server.
Use this callback to get initial token and to refresh stored value in future.
Subscribe to a topic in background.
Unsubscribe from a topic in background.
Reads current badge number (if supported).
Sets current badge number (if supported).
Set custom default notification channel
If incoming FCM messages do not specify an Android notification channel, you can indicate to FCM what channel should be used as the default by adding a metadata element to your application manifest. In the metadata element specify the ID of the channel that should be used by default by FCM.
Note: You are still required to create a notification channel in code with an ID that matches the one defined in the manifest. See the Android docs for more.
Set custom default notification icon
Setting a custom default icon allows you to specify what icon is used for notification messages if no icon is set in the notification payload. Also use the custom default icon to set the icon used by notification messages sent from the Firebase console. If no custom default icon is set and no icon is set in the notification payload, the application icon (rendered in white) is used.
Set custom default notification color
You can also define what color is used with your notification. Different android versions use this settings in different ways: Android < N use this as background color for the icon. Android >= N use this to color the icon and the app name.