Push Notifications using Firebase Cloud Messaging (FCM) in Android Development

Push notifications are an essential feature for keeping users engaged with your Android application. Firebase Cloud Messaging (FCM) provides a simple and powerful solution for sending push notifications to users' devices. This article will guide you through the process of integrating FCM into your Android app and sending push notifications to users.

What is Firebase Cloud Messaging (FCM)?

Firebase Cloud Messaging (FCM) is a cross-platform messaging solution that lets you send notifications and data messages to users on Android, iOS, and the web. FCM provides the infrastructure to send real-time notifications to apps, making it an excellent choice for apps that require user engagement through push notifications.

Setting up Firebase in Your Android Project

Before you can start using FCM, you need to set up Firebase in your Android project. Follow these steps:

  1. Go to the Firebase Console and create a new project.
  2. In your Firebase project, add an Android app. You'll need to provide your app's package name.
  3. Download the google-services.json file and place it in the app directory of your Android project.
  4. In the Firebase console, enable Firebase Cloud Messaging (FCM) for your project.

Step 1: Add Firebase SDK Dependencies

Once your project is set up on Firebase, you need to add the necessary Firebase dependencies in your build.gradle files.

    
    buildscript {
        repositories {
            google()
            mavenCentral()
        }
        dependencies {
            classpath 'com.google.gms:google-services:4.3.15' // Add this line
        }
    }

    
    dependencies {
        implementation 'com.google.firebase:firebase-messaging:23.1.1' // Add this line for FCM
    }

    apply plugin: 'com.google.gms.google-services' // Add this line

Sync your project with Gradle after adding the dependencies.

Receiving Push Notifications with Firebase Cloud Messaging

To receive push notifications in your app, you need to create a service that handles messages from FCM. This service will receive messages and display notifications when a push message is received.

Step 2: Create a FirebaseMessagingService

Extend the FirebaseMessagingService class and override the onMessageReceived() method to handle incoming push messages.

    import com.google.firebase.messaging.FirebaseMessagingService
    import com.google.firebase.messaging.RemoteMessage
    import android.app.Notification
    import android.app.NotificationManager
    import android.content.Context
    import androidx.core.app.NotificationCompat

    class MyFirebaseMessagingService : FirebaseMessagingService() {

        override fun onMessageReceived(remoteMessage: RemoteMessage) {
            // Check if the message contains a notification payload
            remoteMessage.notification?.let {
                sendNotification(it.body)
            }
        }

        private fun sendNotification(messageBody: String?) {
            val notificationManager = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager

            // Create the notification
            val notification = NotificationCompat.Builder(this, "default_channel")
                .setSmallIcon(android.R.drawable.ic_dialog_info)
                .setContentTitle("FCM Message")
                .setContentText(messageBody)
                .setPriority(NotificationCompat.PRIORITY_DEFAULT)
                .build()

            // Send the notification
            notificationManager.notify(0, notification)
        }
    }

In this code:

  • We extend FirebaseMessagingService to handle incoming FCM messages.
  • The onMessageReceived() method checks if the message contains a notification payload and then calls sendNotification() to display the notification.

Step 3: Declare the Service in the AndroidManifest

To let the system know about your service, you need to declare it in your AndroidManifest.xml file:

Sending Push Notifications from Firebase Console

You can send a simple test push notification directly from the Firebase Console.

  1. Go to the Firebase Console and open your project.
  2. Navigate to the "Cloud Messaging" section under "Firebase Cloud Messaging" in the left sidebar.
  3. Click on "Send your first message" or the "New notification" button.
  4. Enter the message title and body, and then click "Send" to push the notification to your app.

The notification will be sent to all devices that have subscribed to your FCM topic or have the app installed and registered for FCM.

Sending Push Notifications Programmatically using FCM

You can also send push notifications programmatically by calling the FCM API directly from your server. Here's an example of sending a notification using the HTTP protocol:

    import com.google.firebase.messaging.FirebaseMessaging
    import com.google.firebase.messaging.Message

    val message = Message.builder()
        .putData("title", "Hello")
        .putData("body", "This is a custom push notification")
        .setTopic("news")
        .build()

    FirebaseMessaging.getInstance().sendAsync(message)

In this code:

  • We create a Message object with the data payload (you can also send notifications with this approach).
  • We use the setTopic() method to send the message to a specific topic, which all subscribed devices can listen to.
  • Finally, we send the message asynchronously using the sendAsync() method from FirebaseMessaging.

Handling Notifications with Data Messages

In addition to notifications, FCM supports data messages that are sent to the app in the background. These messages do not display a notification but can be used to trigger actions in the app, such as syncing data.

Example of Sending a Data Message

    import com.google.firebase.messaging.FirebaseMessaging
    import com.google.firebase.messaging.Message

    val dataMessage = Message.builder()
        .putData("action", "sync")
        .setTopic("news")
        .build()

    FirebaseMessaging.getInstance().sendAsync(dataMessage)

Conclusion

Firebase Cloud Messaging is a powerful tool for sending push notifications to Android devices. By integrating FCM into your Android project, you can easily send notifications to your users, whether it's a simple alert or a complex data-driven update.

Make sure to handle notifications carefully, especially when dealing with background and foreground tasks. Always test your push notifications to ensure that they are delivered and handled properly on different devices and Android versions.




Advertisement