Migrating Android push notifications to Firebase Cloud Messaging

Earlier this year Google has deprecated the old service used for Android push notifications (GCM) in favour of Firebase Cloud Messaging (FCM). GCM server and client APIs will be removed on April 11, 2019 and current users are required to migrate to Firebase completely by that time if they want to continue using push notifications.

Because of that, since Pega Mobile Client version we switched the push notifications to Firebase with legacy GCM support that will stop working after the date mentioned above.

How does it affect you?

If you want to build a new mobile application using Pega Mobile Client or rebuild your current one after October 2018, you will have to import the GCM project to Firebase by following the instructions available in the first step of this guide.

After downloading the `google-services.json` you need to provide it to the application as part of the `assets.zip` alongside your custom branding. Just place it in the root of the archive and reupload it to Pega Platform.

The last step before triggering a new build is to update the certificate set used to sign the application. Change the Sender ID to the new one provided by Firebase and Server API Key to Legacy server key which can be found in Firebase Console under Project Settings | Cloud Messaging. You can refer to this help document for details on modifying certificate sets in Pega Platform.

What happens if you build the app without the google-services.json?

If your certificate set is configured for push notifications (i.e. senderId is set) the application will fail to build.

What else do you need to remember?

You will also have to update Pega Platform to at least 8.2 version to continue using push notifications after the legacy GCM support ends on April 11, 2019.


Keep up to date on this post and subscribe to comments

January 23, 2019 - 11:59am

Do you have any ETA when 8.2 will be available? 

January 23, 2019 - 12:33pm
Response to RulesGuy

This month. It's a matter of days.

March 26, 2019 - 8:20am

For update Pega Platform 7.3.1 following HFix-51029 is prepared.

April 5, 2019 - 7:31am

Hi, im already download the google-services.json, and how to put them into the asset ? may i have a screen capture guide please ?

April 16, 2019 - 11:46am