Inizia a utilizzare Crashlytics per Android

Seleziona la piattaforma: iOS+ Android Android NDK Flutter Unity


Questa guida descrive come iniziare a utilizzare Firebase Crashlytics nella tua app per Android.

Dopo aver configurato l'SDK Firebase Crashlytics nella tua app, puoi visualizzare report sugli arresti anomali completi nella console Firebase. Con Crashlytics per Android, ricevi report sugli arresti anomali, sugli errori non irreversibili e sugli errori "L'applicazione non risponde" (ANR).

La configurazione di Crashlytics richiede attività sia nella console Firebase sia nell'IDE (ad esempio l'aggiunta di un file di configurazione Firebase e dell'SDK Crashlytics ). Per completare la configurazione, dovrai forzare un arresto anomalo di test per inviare il primo report sugli arresti anomali a Firebase.

Prima di iniziare

  1. Se non l'hai già fatto, aggiungi Firebase al tuo progetto Android. Se non hai un'app per Android, puoi scaricare un'app di esempio.

  2. Consigliato: per ricevere automaticamente i log dei breadcrumb per comprendere le azioni dell'utente che hanno portato a un evento di arresto anomalo, non irreversibile o ANR, devi attivare Google Analytics nel tuo progetto Firebase.

    • Se il tuo progetto Firebase esistente non ha Google Analytics attivato, puoi attivare Google Analytics dalla scheda Integrazioni di > Impostazioni progetto nella console Firebase.

    • Se stai creando un nuovo progetto Firebase, attiva Google Analytics durante il flusso di lavoro di creazione del progetto.

  3. Assicurati che la tua app abbia le seguenti versioni minime richieste:

    • Gradle 8.0
    • Plug-in Android per Gradle 8.1.0
    • Plug-in Gradle dei servizi Google 4.4.1

Passaggio 1: aggiungi l'SDK Crashlytics alla tua app

Nel file Gradle del modulo (a livello di app) (in genere <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi la dipendenza per la libreria Crashlytics per Android. Ti consigliamo di utilizzare il Firebase Android BoM per controllare il controllo delle versioni delle librerie.

Per usufruire dei log dei breadcrumb, aggiungi anche l'SDK Firebase per Google Analytics alla tua app. Assicurati che Google Analytics sia attivato nel tuo progetto Firebase.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.11.0"))

    // Add the dependencies for the Crashlytics and Analytics libraries
    // When using the BoM, you don't specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics")
    implementation("com.google.firebase:firebase-analytics")
}

Utilizzando il Firebase Android BoM, la tua app utilizzerà sempre versioni compatibili delle librerie Android di Firebase.

(Alternativa)  Aggiungi le dipendenze delle librerie Firebase senza utilizzare il BoM

Se scegli di non utilizzare il Firebase BoM, devi specificare la versione di ogni libreria Firebase nella riga di dipendenza.

Tieni presente che, se utilizzi più librerie Firebase nella tua app, ti consigliamo vivamente di utilizzare il BoM per gestire le versioni delle librerie, in modo da garantire che tutte le versioni siano compatibili. 

dependencies {
    // Add the dependencies for the Crashlytics and Analytics libraries
    // When NOT using the BoM, you must specify versions in Firebase library dependencies
    implementation("com.google.firebase:firebase-crashlytics:20.0.4")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

Passaggio 2: aggiungi il plug-in Gradle Crashlytics alla tua app

  1. Nel file Gradle a livello di root (a livello di progetto) (<project>/build.gradle.kts o <project>/build.gradle), aggiungi il Crashlytics plug-in Gradle al blocco plugins:

    Kotlin 

    plugins {
    // Make sure that you have the AGP plugin 8.1+ dependency
    id("com.android.application") version "8.1.4" apply false
    // ...

    // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
    id("com.google.gms.google-services") version "4.4.4" apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id("com.google.firebase.crashlytics") version "3.0.6" apply false
}

    Groovy 

    plugins {
    // Make sure that you have the AGP plugin 8.1+ dependency
    id 'com.android.application' version '8.1.4' apply false
    // ...

    // Make sure that you have the Google services Gradle plugin 4.4.1+ dependency
    id 'com.google.gms.google-services' version '4.4.4' apply false

    // Add the dependency for the Crashlytics Gradle plugin
    id 'com.google.firebase.crashlytics' version '3.0.6' apply false
}

  2. Nel file Gradle del modulo (a livello di app) (in genere <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), aggiungi il plug-in Gradle Crashlytics:

    Kotlin 

    plugins {
  id("com.android.application")
  // ...

  // Make sure that you have the Google services Gradle plugin
  id("com.google.gms.google-services")

  // Add the Crashlytics Gradle plugin
  id("com.google.firebase.crashlytics")
}

    Groovy 

    plugins {
  id 'com.android.application'
  // ...

  // Make sure that you have the Google services Gradle plugin
  id 'com.google.gms.google-services'

  // Add the Crashlytics Gradle plugin
  id 'com.google.firebase.crashlytics'
}

Passaggio 3: forza un arresto anomalo di test per completare la configurazione

Per completare la configurazione di Crashlytics e visualizzare i dati iniziali nella Crashlytics dashboard della Firebase console, devi forzare un test arresto anomalo.

  1. Aggiungi codice alla tua app che puoi utilizzare per forzare un arresto anomalo di test.

    Puoi utilizzare il seguente codice in MainActivity della tua app per aggiungere un pulsante all'app che, quando viene premuto, causa un arresto anomalo. Il pulsante è etichettato "Test Crash".

    Kotlin 

    val crashButton = Button(this)
crashButton.text = "Test Crash"
crashButton.setOnClickListener {
   throw RuntimeException("Test Crash") // Force a crash
}

addContentView(crashButton, ViewGroup.LayoutParams(
       ViewGroup.LayoutParams.MATCH_PARENT,
       ViewGroup.LayoutParams.WRAP_CONTENT))

    Java 

    Button crashButton = new Button(this);
crashButton.setText("Test Crash");
crashButton.setOnClickListener(new View.OnClickListener() {
   public void onClick(View view) {
       throw new RuntimeException("Test Crash"); // Force a crash
   }
});

addContentView(crashButton, new ViewGroup.LayoutParams(
       ViewGroup.LayoutParams.MATCH_PARENT,
       ViewGroup.LayoutParams.WRAP_CONTENT));

  2. Crea ed esegui l'app.

  3. Forza l'arresto anomalo di test per inviare il primo report sugli arresti anomali della tua app:

    1. Apri l'app dal dispositivo di test o dall'emulatore.

    2. Nell'app, premi il pulsante "Test Crash" che hai aggiunto utilizzando il codice sopra.

    3. Dopo l'arresto anomalo dell'app, riavviala in modo che possa inviare il report sugli arresti anomali a Firebase.

  4. Vai alla Crashlytics dashboard della Firebase console per visualizzare l'arresto anomalo di test.

    Se hai aggiornato la console e non vedi ancora l'arresto anomalo di test dopo cinque minuti, attiva la registrazione di debug per verificare se la tua app sta inviando report sugli arresti anomali.


Ecco fatto. Crashlytics ora monitora la tua app per rilevare arresti anomali, errori non irreversibili e ANR. Visita la Crashlytics dashboard per visualizzare e analizzare tutti i report e le statistiche.

Passaggi successivi