Firebase Crashlytics 入門

為了獲得 Crashlytics 的最佳體驗，我們建議在您的 Firebase 專案中啟用 Google Analytics ，並將適用於 Google Analytics 的 Firebase SDK 新增至您的應用程式。

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

透過使用Firebase Android BoM ，您的應用程式將始終使用 Firebase Android 程式庫的相容版本。

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

步驟 2 ：將 Crashlytics Gradle 外掛程式新增至您的應用程式中

1. 在根級（專案級） Gradle 檔案（ <project>/build.gradle.kts或<project>/build.gradle ）中，將 Crashlytics Gradle 外掛程式新增至plugins區塊：

   Kotlin

   plugins {
       id("com.android.application") version "7.3.0" apply false
       // ...
   
       // Make sure that you have the Google services Gradle plugin dependency
       id("com.google.gms.google-services") version "4.4.0" apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id("com.google.firebase.crashlytics") version "2.9.9" apply false
   }
   

   Groovy

   plugins {
       id 'com.android.application' version '7.3.0' apply false
       // ...
   
       // Make sure that you have the Google services Gradle plugin dependency
       id 'com.google.gms.google-services' version '4.4.0' apply false
   
       // Add the dependency for the Crashlytics Gradle plugin
       id 'com.google.firebase.crashlytics' version '2.9.9' apply false
   }
   

2. 在模組（應用程式層級） Gradle 檔案（通常<project>/<app-module>/build.gradle.kts或<project>/<app-module>/build.gradle ）中，新增 Crashlytics Gradle 外掛程式：

   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'
   }

第 3 步：強制測試崩潰以完成設置

要完成 Crashlytics 的設定並在 Firebase 控制台的 Crashlytics 儀表板中查看初始數據，您需要強制測試崩潰。

1. 將程式碼新增到您的應用程式中，您可以使用它來強制測試崩潰。

   您可以在應用程式的MainActivity中使用以下程式碼為應用程式新增一個按鈕，按下該按鈕會導致崩潰。該按鈕標記為“測試崩潰”。

   Kotlin+KTX

   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. 建置並運行您的應用程式。

3. 強制測試崩潰以發送應用程式的第一個崩潰報告：

   1. 從測試設備或模擬器開啟您的應用程式。

   2. 在您的應用程式中，按您使用上面的程式碼新增的「測試崩潰」按鈕。

   3. 您的應用程式崩潰後，重新啟動它，以便您的應用程式可以將崩潰報告傳送到 Firebase。

4. 前往 Firebase 控制台的Crashlytics 儀表板以查看測試當機。

   如果刷新控制台後五分鐘後仍未看到測試崩潰，請啟用偵錯日誌記錄以查看應用程式是否正在傳送崩潰報告。

就是這樣！ Crashlytics 現在正在監控您的應用程式是否發生崩潰、非致命錯誤和 ANR。造訪Crashlytics 儀表板以查看和調查您的所有報告和統計資料。

下一步

• 透過新增選擇加入報告、日誌、金鑰和非致命錯誤追蹤來自訂崩潰報告設定。

• 與 Google Play 集成，以便您可以直接在 Crashlytics 儀表板中按 Google Play 追蹤過濾 Android 應用程式的崩潰報告。這使您可以更好地將儀表板集中在特定的建置上。

• 在 Android Studio 中，檢視和篩選 Crashlytics 資料。
  • 使用 Android Studio 中的App Quality Insights (AQI) 視窗查看程式碼旁的 Crashlytics 資料 — 無需在 Crashlytics 儀表板和 IDE 之間來回跳轉即可開始偵錯主要問題。
  • 造訪 Android Studio 的 Electric Eel 版本（穩定版）中的 AQI 窗口，或嘗試 Flamingo（測試版）中的新 AQI 功能。下載您想要的 Android Studio 版本。
  • 在 Android Studio 文件中了解如何使用 AQI 視窗。
  • 我們很樂意聽取您的意見！透過提交錯誤報告向我們發送有關 AQI 視窗的回饋。