Google is committed to advancing racial equity for Black communities. See how.

Get started with Firebase Crashlytics

This quickstart describes how to set up Firebase Crashlytics in your app with the Firebase Crashlytics SDK, so you can get comprehensive crash reports in the Firebase console.

Before you begin

If you haven't already, add Firebase to your Android project. If you don't have an Android app, you can download a sample app.

Step 1: Set up Crashlytics in the Firebase console

  1. Click Crashlytics in the left-hand nav panel of the Firebase console.

  2. If your Firebase project has multiple apps registered in it, select the app you just added from the dropdown next to Crashlytics in the top bar of the console.

  3. Click Add SDK.

Step 2: Add Firebase Crashlytics to your app

  1. In your project-level build.gradle file, add the Crashlytics Gradle plugin as a buildscript dependency:
    buildscript {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
        }
    
        dependencies {
            // ...
    
            // Check that you have the Google Services Gradle plugin v4.3.2 or later
            // (if not, add it).
            classpath 'com.google.gms:google-services:4.3.3'
    
            // Add the Crashlytics Gradle plugin.
            classpath 'com.google.firebase:firebase-crashlytics-gradle:2.2.0'
        }
    }
    
    allprojects {
        repositories {
            // Check that you have Google's Maven repository (if not, add it).
            google()
        }
    }
       
  2. In your app-level build.gradle file, apply the Crashlytics Gradle plugin:
    apply plugin: 'com.android.application'
    
    apply plugin: 'com.google.gms.google-services' // Google Services Gradle plugin
    
    // Apply the Crashlytics Gradle plugin
    apply plugin: 'com.google.firebase.crashlytics'
        

Step 3: Initialize Crashlytics

For an optimal experience with Firebase Crashlytics, we recommend adding the Firebase SDK for Google Analytics to your app in addition to the Firebase Crashlytics SDK. Make sure you add Google Analytics version 17.2.3 or later in order to get real time crash-free users and breadcrumbs.

  1. In your app-level build.gradle, add dependencies for Google Analytics and Crashlytics.

    Java

    dependencies {
        // Recommended: Add the Firebase SDK for Google Analytics.
        implementation 'com.google.firebase:firebase-analytics:17.4.3'
    
        // Add the Firebase Crashlytics SDK.
        implementation 'com.google.firebase:firebase-crashlytics:17.1.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Recommended: Add the Firebase SDK for Google Analytics.
        implementation 'com.google.firebase:firebase-analytics-ktx:17.4.3'
    
        // Add the Firebase Crashlytics SDK.
        implementation 'com.google.firebase:firebase-crashlytics:17.1.0'
    }
    
  2. Optional: Firebase Crashlytics offers crash reporting for apps built using the Android Native Development Kit (NDK). If your app uses the NDK, you can configure Crashlytics to report crashes that occur in your app's underlying NDK libraries. Visit the NDK crash reporting documentation to learn how.

Step 4: Run your project

Finally, run your app. Your device logs display the Firebase verification that initialization is complete.

Next steps