Jump to top

Android Setup

Manually integrate Messaging into your Android application.

Android Manual Linking

The following steps are only required if your environment does not have access to React Native auto-linking.

1. Update Gradle Settings

Add the following to your project's /android/settings.gradle file:

include ':@react-native-firebase_messaging'
project(':@react-native-firebase_messaging').projectDir = new File(rootProject.projectDir, './../node_modules/@react-native-firebase/messaging/android')

2. Update Gradle Dependencies

Add the React Native Functions module dependency to your /android/app/build.gradle file:

dependencies {
  // ...
  implementation project(path: ":@react-native-firebase_messaging")

3. Add package to the Android Application

Import and apply the React Native Firebase module package to your /android/app/src/main/java/**/MainApplication.java file:

3.1 Import the package

Add the following underneath import com.facebook.react.ReactActivity;:

import io.invertase.firebase.messaging.ReactNativeFirebaseMessagingPackage;

3.2 Add the package to the registry

Add the following within the MainActivity class:

protected List<ReactPackage> getPackages() {
  return Arrays.asList(
    new MainReactPackage(),
    new ReactNativeFirebaseMessagingPackage(),

If the method getPackages() already exists on the class in your project, then instead only add new ReactNativeFirebaseMessagingPackage(), to the returned list.

4. Rebuild the project

Once the above steps have been completed, rebuild your Android project:

npx react-native run-android