Skygear Push Basics

Once you have setup FCM in Skygear properly, you will need to enable receiving push notifications in the client app on Android. You need to:

1. Add Firebase to the project
2. Setup FirebaseMessagingService to register token and receive message

Add Firebase to the project

• In the General tab of the project settings, select the Android icon to register your app.

  

  Complete the steps to add your app into the Firebase project. Download the google-services.json file during the registration process. You can get back this file anytime in the General tab. Put the google-services.json into your Android app module root directory.

• Add the Google services plugin into your project by modifying the build.gradle files. The plugin will load the google-services.json file.

  Project-level build.gradle (<project>/build.gradle):

  buildscript {
      dependencies {
          // Add this line
          classpath 'com.google.gms:google-services:4.0.1'
      }
  }
  

  App-level build.gradle (<project>/<app-module>/build.gradle):

  dependencies {
      // Add this line
      implementation 'com.google.firebase:firebase-core:16.0.6'
  }
  ...
  // Add to the bottom of the file
  apply plugin: 'com.google.gms.google-services'
  

Setup FirebaseMessagingService to register token and receive message

There are two ways to setup FirebaseMessagingService:

1. Use Skygear default FirebaseMessagingService, it will help you to handle the token registration and simply display the message in android default Notification.
2. Create your own FirebaseMessagingService, use the Skygear SDK to send the token to Skygear and customize the codes in onMessageReceived.

Option 1: Use Skygear default FirebaseMessagingService

• Update the AndroidManifest.xml file in your application, include the following in the manifest:

  <service android:name="io.skygear.skygear.fcm.FirebaseMessagingService">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>
  

Option 2: Create your own FirebaseMessagingService

• Create your own FirebaseMessagingService class, extends com.google.firebase.messaging.FirebaseMessagingService. Override method onNewToken and onMessageReceived.

  Java

  @Override
  public void onNewToken(String token) {
      // send registration to skygear server
      Container container = Container.defaultContainer(this.getApplicationContext());
      container.getPush().registerDeviceToken(token);
  }
  
  @Override
  public void onMessageReceived(RemoteMessage remoteMessage) {
      super.onMessageReceived(remoteMessage);
      // handle notification
  }
  

  Kotlin

  override fun onNewToken(token: String?) {
      // send registration to skygear server
      val container = Container.defaultContainer(applicationContext)
      container.getPush().registerDeviceToken(token)
  }
  
  override fun onMessageReceived(remoteMessage: RemoteMessage?) {
      // handle notification
  }
  

• Update the AndroidManifest.xml file in your application. Include the following in the manifest:

  <service android:name=".YourFirebaseMessagingService">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>