Pierwsze kroki z Crashlytics na Androida

Z tego przewodnika dowiesz się, jak rozpocząć korzystanie z Firebase Crashlytics w aplikacji na Androida.

Po skonfigurowaniu pakietu SDK Firebase Crashlytics w aplikacji możesz otrzymywać obszerne raporty o awariach w konsoli Firebase. Dzięki Crashlytics na Androida otrzymujesz raporty o awariach, błędach niekrytycznych i "Aplikacja nie odpowiada" (ANR) błędach.

Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up Firebase Crashlytics for my app.

Zanim zaczniesz

Konfigurowanie Crashlytics wymaga wykonania zadań zarówno w konsoli Firebase, jak i w IDE (np. dodania pliku konfiguracyjnego Firebase i pakietu SDK Crashlytics ). Aby zakończyć konfigurację, musisz wymusić awarię testową, aby wysłać pierwszy raport o awarii do Firebase.

1. Jeśli jeszcze tego nie zrobisz, dodaj Firebase do projektu na Androida. Jeśli nie masz aplikacji na Androida, możesz pobrać przykładową aplikację.

2. Zalecane: aby automatycznie otrzymywać logi działań użytkownika i lepiej zrozumieć działania użytkowników prowadzące do awarii, błędu niekrytycznego lub zdarzenia ANR, musisz włączyć Google Analytics w projekcie w Firebase.

   • Jeśli tworzysz nowy projekt w Firebase, włącz Google Analytics w trakcie procesu tworzenia projektu.

   • Jeśli używasz dotychczasowego projektu w Firebase bez włączonej usługi Google Analytics możesz ją włączyć na stronie settings Ustawienia > Integracje konsoli Firebase.

3. Upewnij się, że Twoja aplikacja ma te minimalne wymagane wersje:

   • Gradle 8.0
   • Wtyczka Androida do obsługi Gradle 8.1.0
   • Wtyczka Gradle do usług Google 4.4.1

Krok 1. Dodaj pakiet SDK Crashlytics do aplikacji

Aby korzystać z logów działań użytkownika, dodaj też do aplikacji [pakiet] SDK Firebase dla Google Analytics. Upewnij się, że Google Analytics jest włączona w projekcie w Firebase.

dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:34.19.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")
}

Gdy korzystamy z Firebase Android BoM, aplikacja zawsze używa zgodnych wersji bibliotek Firebase na Androida.

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.1.1")
    implementation("com.google.firebase:firebase-analytics:23.2.0")
}

Krok 2. Dodaj wtyczkę Gradle Crashlytics do aplikacji

1. W pliku Gradle na poziomie głównym (na poziomie projektu) (<project>/build.gradle.kts lub <project>/build.gradle) dodaj wtyczkę Gradle Crashlytics do bloku 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.5.0" apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id("com.google.firebase.crashlytics") version "3.0.8" 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.5.0' apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id 'com.google.firebase.crashlytics' version '3.0.8' apply false
   }

2. W pliku Gradle na poziomie modułu (aplikacji) (zwykle <project>/<app-module>/build.gradle.kts lub <project>/<app-module>/build.gradle) dodaj wtyczkę 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'
   }

Krok 3. Wymuś awarię testową, aby zakończyć konfigurację

Aby zakończyć konfigurowanie Crashlytics i zobaczyć wstępne dane w Crashlytics panelu Firebase konsoli, musisz wymusić awarię testową.

1. Dodaj do aplikacji kod, którego możesz użyć do wymuszenia awarii testowej.

   Aby dodać do aplikacji przycisk, który po naciśnięciu spowoduje awarię, możesz użyć tego kodu w pliku MainActivity aplikacji. Przycisk ma etykietę „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. Skompiluj i uruchom aplikację.

3. Wymuś awarię testową, aby wysłać pierwszy raport o awarii aplikacji:

   1. Otwórz aplikację na urządzeniu testowym lub emulatorze.

   2. W aplikacji naciśnij przycisk „Test Crash”, który został dodany za pomocą powyższego kodu.

   3. Po awarii aplikacji uruchom ją ponownie, aby mogła wysłać raport o awarii do Firebase.

4. W konsoli Firebase otwórz panel DevOps i zaangażowanie > Crashlytics, aby sprawdzić raport o awarii testowej .

   Jeśli po odświeżeniu konsoli nadal nie widzisz awarii testowej po 5 minutach, włącz logowanie debugowania aby sprawdzić, czy aplikacja wysyła raporty o awariach.

To wszystko. Crashlytics monitoruje teraz Twoją aplikację pod kątem awarii, błędów niekrytycznych i błędów ANR. Otwórz panel Crashlytics , aby wyświetlić i zbadać wszystkie raporty i statystyki.

Dalsze kroki

• Dostosuj konfigurację raportu o awarii dodając raportowanie z możliwością rezygnacji, logi, klucze i śledzenie błędów niekrytycznych.

• Zintegruj się z Google Play, aby móc filtrować raporty o awariach aplikacji na Androida według ścieżki Google Play bezpośrednio w panelu Crashlytics. Pozwoli Ci to lepiej skupić się na konkretnych kompilacjach.

• Wyświetlaj i filtruj dane Crashlytics w Android Studio.

  • Użyj okna statystyk jakości aplikacji (AQI) w Android Studio, aby wyświetlać dane Crashlytics obok kodu. Nie musisz przełączać się między panelem Crashlytics a IDE, aby rozpocząć debugowanie najważniejszych problemów.
  • Dowiedz się , jak korzystać z okna AQI w dokumentacji Android Studio.
  • Chętnie poznamy Twoją opinię. Prześlij nam opinię o oknie AQI, przesyłając raport o błędzie.

• Eksportuj dane do BigQuery lub Cloud Logging aby korzystać z zaawansowanych analiz i funkcji, takich jak wysyłanie zapytań do danych, tworzenie niestandardowych paneli i konfigurowanie niestandardowych alertów.