Skip to main content

This content has been archived and is no longer being updated.

Links may not function; however, this content may be relevant to outdated versions of the product.

Migrating Android mobile apps that use push notifications to Firebase Cloud Messaging

Suggest edit Updated on September 12, 2019

Push notifications in mobile apps for Android that are created by using Pega Platform™ required Google Cloud Messaging (GCM) service. However, GCM service has been deprecated and will be removed from use on April 11, 2019. If you use GCM push notifications in an existing Android mobile app, you must migrate your GCM project to Firebase Cloud Messaging (FCM) before this date. FCM inherits the GCM infrastructure and adds new features.

Perform the following steps to migrate your Android project to FCM push notifications.

Note: To continue using push notifications in Android mobile apps after support for GCM push notifications ends, you must also upgrade Pega Platform to version 8.2 or later.

Importing your GCM project to a Firebase project

To enable Firebase Cloud Messaging (FCM) push notifications, you must import an existing Android GCM project to a Firebase Cloud Messaging project. Do the following:

  1. Log in to the Firebase console and add a project.
  2. Select the existing GCM project and add the Firebase project to an Android mobile app.
  3. Enter the mobile app package name and select SHA-1, and then download the generated google-services.json file for an Android mobile app.
  4. Save the generated FCM server key for the Firebase project for reference.
Note: For more information about importing an existing GCM project as a Firebase project, see the first section in Migrate a GCM Client App for Android to Firebase Cloud Messaging.

Updating the Android certificate set

Update the certificate set that is used by an Android mobile app so that it includes the information about the FCM server key and google-services.json file for the Firebase project that you created.

  1. Log in to Pega Platform.
  2. In Dev Studio, click the name of an application, and then click Channels and interfaces.
  3. Click a mobile app icon.
  4. Click the Build tab.
  5. In the Platforms section, turn on the Android switch.
  6. In the Certificate set section, edit an existing certificate set.
  7. In the FCM Server Key field, enter the key that is used to authenticate with FCM services that you obtained from the Firebase console.
  8. Update the Google Services JSON file that you obtained from the Firebase console:
    • If you are using Pega Platform 8.1 or earlier, add and upload the Google Services JSON file.
    • If you are using Pega Platform 8.2 or later, in the Google Services JSON section, click New and select the google-services.json file you obtained from the Firebase console.
  9. Click Submit.

You can now build your Android mobile app in Pega Platform so that the FCM push notifications are enabled.

Note: For more information, see Push notifications in an Android mobile app and Building an Android app.

Adding and uploading the Google Services JSON file (Pega Platform 8.1 or earlier)

In Pega Platform 8.1 or earlier versions, after you download the google-services.json file from the Firebase project, you must add it to the file, which contains custom branding for an Android mobile app in Pega Platform.

  1. Obtain the branding assets file for your Android mobile app.
  2. Save the google-services.json file in the root directory of the file.
  3. Upload the updated file to Pega Platform.
Note: For more information, see Preparing custom branding assets and Contents of the branding assets package.
Did you find this content helpful? YesNo

100% found this useful

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us