獲取 Android NDK 崩潰報告

如果您的 Android 應用包含本機庫，您可以通過對應用的構建配置進行一些小更新，從 Firebase Crashlytics 啟用本機代碼的完整堆棧跟踪和詳細崩潰報告。

本指南介紹如何使用適用於 NDK 的 Firebase Crashlytics SDK 配置崩潰報告。

如果您正在尋找如何在 Unity 項目中開始使用 Crashlytics，請查看Unity 入門指南。

在你開始之前

  1. 如果您尚未將 Firebase 添加到您的 Android 項目中，請將其添加到您的 Android 項目中。如果您沒有 Android 應用程序，可以下載示例應用程序。

  2. 推薦：要獲得無崩潰用戶、麵包屑日誌和速度警報等功能，您需要在 Firebase 項目中啟用 Google Analytics。

    • 如果您現有的 Firebase 項目未啟用 Google Analytics（分析），您可以從 Firebase 控制台中 >項目設置的“集成”選項卡中啟用 Google Analytics。

    • 如果您要創建新的 Firebase 項目，請在項目創建工作流程期間啟用 Google Analytics。

第 1 步：將適用於 NDK 的 Crashlytics SDK 添加到您的應用程序

在模塊（應用程序級）Gradle 文件（通常<project>/<app-module>/build.gradle.kts或<project>/<app-module>/build.gradle ）中，添加 Crashlytics NDK 的依賴項安卓庫。我們建議使用Firebase Android BoM來控制庫版本控制。

為了獲得 Crashlytics 的最佳體驗，我們建議在您的 Firebase 項目中啟用 Google Analytics ，並將適用於 Google Analytics 的 Firebase SDK 添加到您的應用中。

Kotlin+KTX

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

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

通過使用Firebase Android BoM ，您的應用將始終使用 Firebase Android 庫的兼容版本。

（替代方法）在不使用 BoM 的情況下添加 Firebase 庫依賴項

如果您選擇不使用 Firebase BoM，則必須在其依賴項行中指定每個 Firebase 庫版本。

請注意，如果您在應用中使用多個Firebase 庫，我們強烈建議使用 BoM 來管理庫版本，這可確保所有版本兼容。

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

Java

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

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

通過使用Firebase Android BoM ，您的應用將始終使用 Firebase Android 庫的兼容版本。

（替代方法）在不使用 BoM 的情況下添加 Firebase 庫依賴項

如果您選擇不使用 Firebase BoM，則必須在其依賴項行中指定每個 Firebase 庫版本。

請注意，如果您在應用中使用多個Firebase 庫，我們強烈建議使用 BoM 來管理庫版本，這可確保所有版本兼容。

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

第 2 步：將 Crashlytics Gradle 插件添加到您的應用程序中

  1. 在根級（項目級） Gradle 文件（ <project>/build.gradle.kts或<project>/build.gradle ）中，將 Crashlytics Gradle 插件添加到plugins塊中：

    Kotlin

    plugins {
    id("com.android.application") version "7.2.0" apply false
    // ...

    // Make sure that you have the Google services Gradle plugin dependency
    id("com.google.gms.google-services") version "4.3.15" 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.2.0' apply false
    // ...

    // Make sure that you have the Google services Gradle plugin dependency
    id 'com.google.gms.google-services' version '4.3.15' 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 擴展添加到您的構建中

在模塊（應用程序級） Gradle 文件（通常為<project>/<app-module>/build.gradle.kts或<project>/<app-module>/build.gradle ）中，配置 Crashlytics 擴展。

Kotlin

import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension

// ...

android {
  // ...
  buildTypes {
      getByName("release") {
          // Add this extension
          configure<CrashlyticsExtension> {
              // Enable processing and uploading of native symbols to Firebase servers.
              // By default, this is disabled to improve build speeds.
              // This flag must be enabled to see properly-symbolicated native
              // stack traces in the Crashlytics dashboard.
              nativeSymbolUploadEnabled = true
          }
      }
  }
}

Groovy

// ...

android {
  // ...
  buildTypes {
      release {
          // Add this extension
          firebaseCrashlytics {
              // Enable processing and uploading of native symbols to Firebase servers.
              // By default, this is disabled to improve build speeds.
              // This flag must be enabled to see properly-symbolicated native
              // stack traces in the Crashlytics dashboard.
              nativeSymbolUploadEnabled true
          }
      }
  }
}

第 4 步：設置本地符號自動上傳

為了從 NDK 崩潰中生成可讀的堆棧跟踪，Crashlytics 需要了解本機二進製文件中的符號。 Crashlytics Gradle 插件包含uploadCrashlyticsSymbolFile BUILD_VARIANT任務來自動執行此過程。

  1. 為了能夠訪問自動符號上傳任務，請確保在模塊（應用程序級）Gradle 文件中將nativeSymbolUploadEnabled設置為true 。

  2. 為了使方法名稱出現在堆棧跟踪中，您必須在每次構建 NDK 庫後顯式調用uploadCrashlyticsSymbolFile BUILD_VARIANT任務。例如：

    >./gradlew app:assembleBUILD_VARIANT\
           app:uploadCrashlyticsSymbolFileBUILD_VARIANT

  3. Crashlytics SDK for NDK 和 Crashlytics Gradle 插件都依賴於本機共享對像中 GNU 構建 ID 的存在。

    您可以通過在每個二進製文件上運行readelf -n來驗證此 ID 是否存在。如果構建 ID 不存在，請將-Wl,--build-id添加到構建系統的標誌中以解決問題。

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

要完成 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 現在正在監視您的應用程序是否發生崩潰，您可以在 Crashlytics 儀表板中查看和調查崩潰報告和統計信息。

下一步

故障排除

如果您在 Firebase 控制台和 logcat 中看到不同的堆棧跟踪，請參閱故障排除指南。


上傳符號的替代選項

上面此頁面的主要工作流程適用於標準 Gradle 構建。但是，某些應用程序使用不同的配置或工具（例如 Gradle 以外的構建過程）。在這些情況下，以下選項可能有助於成功上傳符號。

選項：上傳庫模塊和外部依賴項的符號

此選項在以下情況下會很有幫助：

  • 如果您在 Gradle 中使用自定義的 NDK 構建流程
  • 如果您的本機庫內置在庫/功能模塊中或由第三方提供
  • 如果自動符號上傳任務失敗或者您在儀表板中看到非符號崩潰

選項：上傳非 Gradle 構建或無法訪問的未剝離本機庫的符號

此選項在以下情況下會很有幫助：

  • 如果您使用 Gradle 以外的構建過程

  • 如果未剝離的本機庫以某種方式提供給您，但在 Gradle 構建期間無法訪問它們