Jump to top

Android Installation

Manually integrate Instance ID into your Android application.

Android Manual Installation

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 projects /android/settings.gradle file:

include ':@react-native-firebase_iid'
project(':@react-native-firebase_iid').projectDir = new File(rootProject.projectDir, './../node_modules/@react-native-firebase/iid/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_iid")
}

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:

Import the package:

import io.invertase.firebase.iid.ReactNativeFirebaseIidPackage;

Add the package to the registry:

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

4. Rebuild the project

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

npx react-native run-android