The comprehensive step by step tutorial on receiving a push notification on Mobile App using Ionic 4 and Firebase Cloud Messaging (FCM). We will use Ionic 4 Cordova native FCM plugin for receiving a push notification and using Firebase API for sending push notification from the Postman.
Table of Contents:
- Setup and Configure Google FCM
- Create a new Ionic 4 App
- Add Ionic 4 Cordova Native FCM Plugin
- Run and Test Sending and Receiving Push Notification
The following tools, frameworks, and modules are required for this tutorial:
- Setup and Configure Google FCM
- Create a new Ionic 4 App
- Add Ionic 4 Cordova Native FCM Plugin
- Run and Test Sending and Receiving Push Notification
Before going to the main steps, we assume that you have to install Node.js. Next, upgrade or install new Ionic 4 CLI by open the terminal or Node command line then type this command.
sudo npm install -g ionic
You will get the latest Ionic CLI in your terminal or command line. Check the version by type this command.
ionic --version
4.10.3
1. Setup and Configure Google Firebase Cloud Messaging
Open your browser then go to Google Firebase Console then login using your Google account.
Next, click on the Add Project button then fill the Project Name with Ionic 4 FCM and check the terms then click Create Project button.
After clicking the continue button you will redirect to the Project Dashboard page. Click the Gear Button on the right of Project Overview then click Project Settings. Click the Cloud Messaging tab the write down the Server Key and Sender ID for next usage in the API and Ionic 4 App. Next, back to the General tab then click the Android icon in your Apps to add Android App.
Fill the required fields in the form as above then click Register App button. Next, download the google-services.json that will use in the Ionic 4 app later. Click next after download, you can skip Add Firebase SDK by click again Next button. You can skip step 4 if there’s no App creating on running yet.
2. Create a new Ionic 4 App
To create a new Ionic 4 App, type this command in your terminal.
ionic start ionic4-push blank --type=angular
If you see this question, just type N for because we will installing or adding Cordova later.
Install the free Ionic Appflow SDK and connect your app? (Y/n) N
Next, go to the newly created app folder.
cd ./ionic4-push
As usual, run the Ionic 4 App for the first time, but before run as lab mode, type this command to install @ionic/lab.
npm install --save-dev @ionic/lab
ionic serve -l
Now, open the browser and you will the Ionic 4 App with the iOS, Android, or Windows view. If you see a normal Ionic 4 blank application, that’s mean you ready to go to the next steps.
3. Add Ionic 4 Cordova Native FCM Plugin
To install Ionic 4 Cordova Native Firebase Message Plugin, type this command.
ionic cordova plugin add cordova-plugin-fcm-with-dependecy-updated
npm install @ionic-native/fcm
Next, open and edit src/app/app.module.ts then add this import.
import { FCM } from '@ionic-native/fcm/ngx';
Add to @NgModule providers.
providers: [
StatusBar,
SplashScreen,
FCM,
{ provide: RouteReuseStrategy, useClass: IonicRouteStrategy }
],
Next, open and edit src/app/app.component.ts then add this import.
import { FCM } from '@ionic-native/fcm/ngx';
import { Router } from '@angular/router';
Inject FCM and Router module to the constructor.
constructor(
private platform: Platform,
private splashScreen: SplashScreen,
private statusBar: StatusBar,
private fcm: FCM,
private router: Router
) {
this.initializeApp();
}
Inside platform ready of initializeApp function, add a function to get FCM token then print out to the browser console.
this.fcm.getToken().then(token => {
console.log(token);
});
Add this function to refresh the FCM token.
this.fcm.onTokenRefresh().subscribe(token => {
console.log(token);
});
Add this function to receive push notification from Firebase Cloud Messaging.
this.fcm.onNotification().subscribe(data => {
console.log(data);
if (data.wasTapped) {
console.log('Received in background');
this.router.navigate([data.landing_page, data.price]);
} else {
console.log('Received in foreground');
this.router.navigate([data.landing_page, data.price]);
}
});
Above example of receiving a push notification from FCM will redirect to the other page with params of data. For that, next, we have to add a new page by type this command.
ionic g page second
Next, modify src/app/app-routing.module.ts then change the new page route.
const routes: Routes = [
{ path: '', redirectTo: 'home', pathMatch: 'full' },
{ path: 'home', loadChildren: './home/home.module#HomePageModule' },
{ path: 'second/:price', loadChildren: './second/second.module#SecondPageModule' },
];
Next, open and edit src/app/second/second.page.ts then add this import.
import { ActivatedRoute } from '@angular/router';
Inject that module to the constructor.
constructor(private route: ActivatedRoute) { }
Add a variable for hold data from router parameters.
price: any = '';
Add this line to get data from the router parameters.
constructor(private route: ActivatedRoute) {
this.price = this.route.snapshot.params['price'];
}
Next, open and edit src/app/second/second.page.html then replace all HTML tags with this.
<ion-header>
<ion-toolbar>
<ion-title>Second</ion-title>
</ion-toolbar>
</ion-header>
<ion-content padding>
<ion-card>
<ion-card-header>
<ion-card-title>Congratulation!</ion-card-title>
</ion-card-header>
<ion-card-content>
You get price from our sponsor:
<h2>{{price}}</h2>
</ion-card-content>
</ion-card>
</ion-content>
If you plan to send push notification to the group of topic, add this lines inside the platform ready.
this.fcm.subscribeToTopic('people');
To unsubscribe from topic, add this line.
this.fcm.unsubscribeFromTopic('marketing');
4. Run and Test Sending and Receiving Push Notification
Before running this Ionic 4 app, we have to copy the downloaded google-services.json file to the root of the project. Type this command to add the Android platform.
ionic cordova platform add android
Next, copy the google-services.json to the platform/android/ directory.
cp google-services.json platform/android/
Next, run the Ionic 4 App to the Android device by type this command.
ionic cordova run android
After the app running on the device, check the console from the Google Chrome by type this address chrome://inspect then choose the inspect link. You should take to the browser inspector, just change to the console tab.
As you can see above, you can take and write down the FCM token for use by Postman. Next, open the Postman application from your computer. Change the method to POST and add this address [https://fcm.googleapis.com/fcm/send](https://fcm.googleapis.com/fcm/send "https://fcm.googleapis.com/fcm/send"). On the headers, add this key Content-Type with value application/json and Authorization with value key=YOUR_FIREBASE_KEY....
Next, add this JSON data to the RAW body.
{
"notification":{
"title":"Ionic 4 Notification",
"body":"This notification sent from POSTMAN using Firebase HTTP protocol",
"sound":"default",
"click_action":"FCM_PLUGIN_ACTIVITY",
"icon":"fcm_push_icon"
},
"data":{
"landing_page":"second",
"price":"$3,000.00"
},
"to":"eadego-nig0:APA91bEtKx9hv50lmQmfzl-bSDdsZyTQ4RkelInfzxrPcZjJaSgDmok3-WQKV5FBu9hrMrkRrcCmf3arkGSviGltg5CyC2F9x1J2m0W7U8PxJ3Zlh7-_tL6VcFdb76hbaLIdZ-dOK15r",
"priority":"high",
"restricted_package_name":""
}
If you want to send by topics recipients, change the value of to to topics/people. Next, click the send button and you should see this response.
{
"multicast_id": 7712395953543412819,
"success": 1,
"failure": 0,
"canonical_ids": 0,
"results": [
{
"message_id": "0:1550632139317442%b73443ccb73443cc"
}
]
}
And you will see the notification in your Android device background screen.
If you tap on it, it will open the App and redirect to the second page with this view.
That it’s, the example of receiving push notification using Ionic 4 and Firebase Cloud Messaging. You can grab the full source code from our GitHub.
#ionic #firebase #angular
