Enabling Firebase Cloud Messaging (FCM)

Version 3.3.0 of this plugin added FCM support (which is the successor of GCM).

Although using push messages in your Firebase app is really easy setting it up is not. Traditionally, especially for iOS.

Android

If you didn't choose this feature during installation you can uncomment firebase-messaging in include.gradle

iOS

If you didn't choose this feature during installation you can uncomment Firebase/Messaging in Podfile

Receiving remote notifications in the background

Open app/App_Resources/iOS/Info.plist and add this to the bottom:

<key>UIBackgroundModes</key>
<array>
	<string>remote-notification</string>
</array>

Provisioning hell

Follow this guide to the letter. Once you've done it run tns run ios and upon starting the app it should prompt you for notification support. That also works on the simulator, but actually receiving notifications is only possible on a real device.

Don't receive the "Allow app to receive notifications" prompt?

Make sure your app.js has this before application.start();:

var firebase = require("nativescript-plugin-firebase");

Delete and re-add your app after you've added this.

Handling a notification

To listen to received notifications while in the foreground or when your app moves from the background to the foreground, add a handler init.

Any pending notifications (while your app was not in the foreground) will trigger the onMessageReceivedCallback handler.

  firebase.init({
    onMessageReceivedCallback: function(message) {
      console.log("Title: " + message.title);
      console.log("Body: " + message.body);
      // if your server passed a custom property called 'foo', then do this:
      console.log("Value of 'foo': " + message.foo);
    }
  });

You don't have to provide the handler during init - you can also do it through a dedicated function.

  firebase.addOnMessageReceivedCallback(
    function(message) {
      // ..
    }
  );

Pushing to individual devices

If you want to send push messages to individual devices, either from your own backend or the FCM console, you need the push token.

Similarly to the message callback you can either wire this through init or as a separate function:

  firebase.init({
    onPushTokenReceivedCallback: function(token) {
      console.log("Firebase push token: " + token);
    }
  });

.. or:

  firebase.addOnPushTokenReceivedCallback(
    function(token) {
      // ..
    }
  );

Testing

Using the Firebase Console gives you most flexibility, but you can quickly and easily test from the command line as well:

curl -X POST --header "Authorization: key=SERVER_KEY" --Header "Content-Type: application/json" https://fcm.googleapis.com/fcm/send -d "{\"notification\":{\"title\": \"My title\", \"text\": \"My text\", \"sound\": \"default\"}, \"priority\": \"High\", \"to\": \"DEVICE_TOKEN\"}"

SERVER_KEY: see below
DEVICE_TOKEN: the one you got in addOnPushTokenReceivedCallback or init's onPushTokenReceivedCallback

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!