Android Push Setup (FCM) - SuprSend, Notification infrastructure for Product teams

Example integration project can be found here.

Integration Steps

Create a Firebase project in the firebase console

To start sending notifications from FCM, you’ll have to first create a firebase project. Create a firebase project and application in firebase console with your applications package name which you can find in AndroidManifest.xml

Adding google-services.json to your project

You can get your Service Account JSON from Firebase Console Project Settings. Download google-services.json and add the file inside your android > app folder.

Adding Firebase dependencies and plugins

3.1. Add the below dependency inside projects build.gradle inside dependencies

dependencies {
        ...
        classpath 'com.google.gms:google-services:4.3.10' // or latest version
}

3.2. Add the below plugin inside the app build.gradle

apply plugin: 'com.google.gms.google-services'

3.3 Add the below dependency inside apps build.gradle inside dependencies

implementation("com.google.firebase:firebase-messaging:22.0.0") // or latest version

Implementing push

Push feature can be implemented in two ways:

Token Generation and Notification handled By SDK [Recommended]

You may use this option if all of your android push notifications are to be handled via SuprSend SDK. We recommend you use this method as it is just a single-step process to just register the service in your application manifest and everything else will be ready.

<!--If you are targeting to API 33 (Android 13) you will additional need to add POST_NOTIFICATIONS -->
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />

<service
    android:name="app.suprsend.fcm.SSFirebaseMessagingService"
    android:enabled="true"
    android:exported="false">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

Token Generation and Notification handled By Your Application

Once you get a token from Firebase you can pass the token by using the below code

suprsend.setAndroidFcmPush(fcm_token);

When you get a push notification you will get a payload and it can be passed to the method provided by Suprsend Flutter SDK and the notification displaying part will be handled by SDK.

suprsend.showNotification(notification_payload);

How to identify if notification is sent by SuprSend?

If notification payload contains key supr_send_n_pl then simply consider this as payload sent from suprsend and pass the payload to suprsend sdk.

Targeting Android 13 (API-33)

In Android13 (API 33) or higher notification permission will be disabled by default so permission needs to be asked to enable notifications if you are targeting android 13 users. You can follow this doc to update to support Andriod 13(API 33), if not already supported. Please test the application as well as upgrading to API 33 may causes breaking changes.

Add POST_NOTIFICATIONS permission in AndroidManifest.xml if not present already.

<manifest ...>
    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
    <application ...>
        ...
    </application>
</manifest>

Ask notification permission to show push notifications

You can use permission_handler or any other package to ask notification permission to user.

From v2.4.0, we have removed internal method to ask notification permission (suprsend.askNotificationPermission). You can use external package to ask notification permission.

Once notification permission is granted, users can be able to see push notifications.

Changelog

​Integration Steps

​Targeting Android 13 (API-33)

Integration Steps

Targeting Android 13 (API-33)