Android Push Setup (FCM)

Prerequisites

Integration of SuprSend Flutter SDK
Configuring Android vendor form in SuprSend dashboard

Example can be found in the example/ app.

Step 1: Create a Firebase project in the firebase console

Create a Firebase project (or reuse an existing one) in the Firebase console and register your Android app using its applicationId (the same value as applicationId in android/app/build.gradle).

Step 2: Adding google-services.json to your project

Download the google-services.json file for your registered Android app from the Firebase console and place it in your app module:

android/app/google-services.json

Step 3: Adding Firebase dependencies and plugins

Depending on your project, use either the Groovy (*.gradle) or Kotlin DSL (*.gradle.kts) snippets below.

Declare the Google Services Gradle plugin

Declare it in settings.gradle (top-level, apply false). Add it to your existing plugins { } block:

plugins {
    // ...
    id "com.google.gms.google-services" version "4.3.13" apply false // or latest version
}

plugins {
    // ...
    id("com.google.gms.google-services") version "4.3.13" apply false // or latest version
}

Apply the plugin in your app module

Add it to the existing plugins { } block:

plugins {
    // ...
    id "com.google.gms.google-services"
}

plugins {
    // ...
    id("com.google.gms.google-services")
}

Add the Firebase Messaging dependency in your app module

dependencies {
    implementation "com.google.firebase:firebase-messaging:22.0.0" // or latest version
}

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

Step 4: Implementing push

Use SuprSend Background service (Recommended)

This is the simplest way to implement push and everything is handled by the SuprSend background service, like token generating, attaching it to user, showing notification and tracking analytics. Register the SDK’s messaging service inside the <application> tag of android/app/src/main/AndroidManifest.xml:

<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>

Targeting Android 13 (API-33)

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

The example uses permission_handler:

import 'package:permission_handler/permission_handler.dart';

Future<void> requestNotificationPermission() async {
  final status = await Permission.notification.status;
  // Android 13+ shows the POST_NOTIFICATIONS dialog; older versions grant by default.
  if (status.isDenied) {
    await Permission.notification.request();
  }
}

Developer Resources

Updates and Versioning

Authentication

Security

SDKs and APIs

Features

Testing

Monitoring and Logging

Prerequisites

Step 1: Create a Firebase project in the firebase console

Step 2: Adding google-services.json to your project

Step 3: Adding Firebase dependencies and plugins

Step 4: Implementing push

Use SuprSend Background service (Recommended)

Targeting Android 13 (API-33)

​Prerequisites

​Step 1: Create a Firebase project in the firebase console

​Step 2: Adding google-services.json to your project

​Step 3: Adding Firebase dependencies and plugins

​Step 4: Implementing push

​Use SuprSend Background service (Recommended)

​Targeting Android 13 (API-33)

Prerequisites

Step 1: Create a Firebase project in the firebase console

Step 2: Adding google-services.json to your project

Step 3: Adding Firebase dependencies and plugins

Step 4: Implementing push

Use SuprSend Background service (Recommended)

Targeting Android 13 (API-33)