Add Firebase to your Android project

Prerequisites

• Install or update Android Studio to its latest version.

• Make sure that your project meets these requirements (note that some products might have stricter requirements):

  • Targets API level 21 (Lollipop) or higher
  • Uses Android 5.0 or higher
  • Uses Jetpack (AndroidX) , which includes meeting these version requirements:
    • com.android.tools.build:gradle v7.3.0 or later
    • compileSdkVersion 28 or later

• Set up a physical device or use an emulator to run your app.Note that Firebase SDKs with a dependency on Google Play services require the device or emulator to have Google Play services installed.

• Sign into Firebase using your Google account.

If you don't already have an Android project and just want to try out a Firebase product, you can download one of our quickstart samples .

You can connect your Android app to Firebase using one of the following options:

• Option 1 : (recommended) Use the Firebase console setup workflow.
• Option 2 : Use the Android Studio Firebase Assistant (may require additional configuration).

---

Option 1: Add Firebase using the Firebase console

Adding Firebase to your app involves tasks both in the Firebase console and in your open Android project (for example, you download Firebase config files from the console, then move them into your Android project).

Step 1: Create a Firebase project

Before you can add Firebase to your Android app, you need to create a Firebase project to connect to your Android app. Visit Understand Firebase Projects to learn more about Firebase projects.

Create a Firebase project

1. In the Firebase console , click Add project.

   • To add Firebase resources to an existing Google Cloud project, enter its project name or select it from the dropdown menu.

   • To create a new project, enter the desired project name. You can also optionally edit the project ID displayed below the project name.

2. If prompted, review and accept the Firebase terms .

3. Click Continue.

4. (Optional) Set up Google Analytics for your project, which enables you to have an optimal experience using any of the following Firebase products:

   • Firebase Crashlytics
   • Firebase Cloud Messaging

   • Firebase In-App Messaging
   • Firebase Remote Config

   • Remote Config personalization
   • Firebase A/B Testing

   Either select an existing Google Analytics account or to create a new account.

   If you create a new account, select your Analytics reporting location , then accept the data sharing settings and Google Analytics terms for your project.

5. Click Create project(or Add Firebase, if you're using an existing Google Cloud project).

Firebase automatically provisions resources for your Firebase project. When the process completes, you'll be taken to the overview page for your Firebase project in the Firebase console.

Step 2: Register your app with Firebase

To use Firebase in your Android app, you need to register your app with your Firebase project. Registering your app is often called "adding" your app to your project.

1. Go to the Firebase console .

2. In the center of the project overview page, click the Androidicon ( plat_android ) or Add appto launch the setup workflow.

3. Enter your app's package name in the Android package namefield.

   What's a package name, and where do you find it?

   • A package name uniquely identifies your app on the device and in the Google Play Store.

   • A package name is often referred to as an application ID .

   • Find your app's package name in your module (app-level) Gradle file, usually app/build.gradle (example package name: com.yourcompany.yourproject ).

   • Be aware that the package name value is case-sensitive, and it cannot be changed for this Firebase Android app after it's registered with your Firebase project.