MIGRATE-TO-FIREBASE.md

Migration guide push-plugin -> Firebase plugin

If you have an app that uses push-plugin for push notifications and need to switch to nativescript-plugin-firebase, this guide can help you. If you are just starting with push notifications, however, it would be best to use Firebase plugin and refer its documentation on messaging.

1. Add the plugin to your app

Go to your app's root folder in terminal app and execute

tns plugin add nativescript-plugin-firebase

Upon plugin installation, you'll be prompted to choose which features to use. Choose "yes" for Firebase Messaging (of course :)). By default, the plugin saves the configuration as a file (firebase.nativescript.json) to use it when reinstalling the plugin.

2. Setup

Add GoogleService-Info.plist (for iOS) or google-services.json (for Android) in App_Resources/iOS (and App_Resources/Android, respectively). These are the configuration files that come from your Firebase apps. If you don't have such yet, go to https://console.firebase.google.com and create one. See Firebase plugin's docs for more info on initial setup.

3. Initialization prerequisite

Make sure you require the plugin in app.ts / main.ts / main.aot.ts before application.start(), and do init() after the app has started (not in app.ts - not even in a timeout; move it out of app.ts entirely!). This ensures the notifications will be receivable in the background.

EXAMPLE:

// in app.ts
// ...
const firebase = require("nativescript-plugin-firebase");
// ...
app.start({ moduleName: 'main-page' });

4. Add some code to handle a notification

EXAMPLE: The following code using push-plugin:

private pushSettings = {
    notificationCallbackIOS: (message: any) => {
        this.updateMessage("Message received!\n" + JSON.stringify(message));
    }
};

pushPlugin.register(this.pushSettings, (token: String) => {
    console.log("Device registered. Access token: " + token);

    pushPlugin.registerUserNotificationSettings(() => {
        console.log("Successfully registered for push.");
    }, (err) => {
        console.log(("Error registering for interactive push: " + JSON.stringify(err));
    });
}, (errorMessage: String) => {
    console.log((JSON.stringify(errorMessage));
});

... could be rewriten using Firebase plugin like:

import * as firebase from "nativescript-plugin-firebase";

firebase.init({
    onMessageReceivedCallback: (message: firebase.Message) => {
        console.log(`Message: ${message}`);
    },
    onPushTokenReceivedCallback: function(token) {
        console.log("Firebase push token: " + token);
    }
});

5. Testing with messages

To test with real messages, you can use the UI in Firebase Console, or use the https://fcm.googleapis.com/fcm/send API. See the testing docs section in Firebase plugin.

6. Interactive Push Notifications - in push plugin they are set in the options argument passed to pushPlugin.register(options, callback) method. In Firebase plugin, it is done in a very similar way:

import * as firebase from "nativescript-plugin-firebase";
import { messaging } from "nativescript-plugin-firebase/messaging";
...
const model = new messaging.PushNotificationModel();
model.iosSettings = new messaging.IosPushSettings();
model.iosSettings.interactiveSettings = new messaging.IosInteractivePushSettings();
model.iosSettings.interactiveSettings.actions = [<<array of IosInteractiveNotificationAction>>]

model.iosSettings.interactiveSettings.categories = [{ identifier: "SOME CATEGORY" }];

model.onNotificationActionTakenCallback = () => {
    // callback to hook to if you want to handle what action have been taken by the user
};

firebase.registerForInteractivePush(model: messaging.PushNotificationModel);

Some lines in the above example have been omitted. See Firebase plugin's interactive notifications docs for more details.

7. areNotificationsEnabled() API

In Firebase plugin it is pretty similar to the one in push-plugin, and even simpler to use:

import * as firebase from "nativescript-plugin-firebase";

const areTheyEnabled = firebase.areNotificationsEnabled(); // synchronous, retruns boolean;

This API is also supported in Android, SDK version 24 and above