獲取 Android NDK 崩潰報告

查看此選項的說明

標準 Crashlytics 符號上傳任務假設您正在使用標準 NDK 建置工具（例如 CMake）將本機程式庫建置為應用程式模組 Gradle 建置的一部分。

但是，如果您在 Gradle 中使用自訂的 NDK 建置流程，或者您的本機程式庫是在程式庫/功能模組中建置的或由第三方提供的，則您可能需要明確指定未剝離程式庫的路徑。為此，您可以在 Gradle 建置檔案的 Crashlytics 擴充功能中新增unstrippedNativeLibsDir屬性。

1. 確保您已完成本頁前面主工作流程中的以下初始任務：

   1. 在 Firebase 控制台中啟用了 Crashlytics。

   2. 新增了適用於 NDK 的 Crashlytics SDK和Crashlytics Gradle 插件。

   3. 將 Crashlytics 擴充功能添加到您的建置中。

   4. 設定本機符號的自動上傳。

2. 為了讓自動符號上傳任務能夠找到您的符號訊息，請將以下內容新增到您的模組（應用程式層級） Gradle 檔案中（通常<project>/<app-module>/build.gradle.kts或<project>/<app-module>/build.gradle ）：

   Kotlin

   import com.google.firebase.crashlytics.buildtools.gradle.CrashlyticsExtension
   
   // ...
   
   android {
       // ...
       buildTypes {
           release {
               configure {
                   nativeSymbolUploadEnabled = true
                   unstrippedNativeLibsDir = file("PATH/TO/UNSTRIPPED/DIRECTORY")
               }
           }
       }
   }
   

   Groovy

   // ...
   
   android {
       // ...
       buildTypes {
           release {
               firebaseCrashlytics {
                   nativeSymbolUploadEnabled true
                   unstrippedNativeLibsDir file("PATH/TO/UNSTRIPPED/DIRECTORY")
               }
           }
       }
   }
   

   Crashlytics 外掛程式將遞歸搜尋指定目錄以尋找副檔名為.so的本機函式庫。然後，Crashlytics 從所有此類程式庫中提取偵錯符號並將其上傳到 Firebase 伺服器。

   以下是您可以在unstrippedNativeLibsDir屬性中指定的內容：

   • org.gradle.api.Project#files(Object...)允許的任何參數，包括： java.lang.String , java.io.File ，或org.gradle.api.file.FileCollection

   • 透過提供清單或FileCollection實例來實現單一建置風格的多個目錄

3. 最後，強制測試當機以完成 Crashlytics 的設定並在 Firebase 控制台的 Crashlytics 儀表板中查看初始資料。

查看此選項的說明

此選項要求您在建立發布版本或想要在 Firebase 控制台中查看符號堆疊追蹤的任何版本時執行 Firebase CLI 命令。

1. 確保您已完成本頁前面主工作流程中的以下初始任務：

   1. 在 Firebase 控制台中啟用了 Crashlytics。

   2. 新增了適用於 NDK 的 Crashlytics SDK和Crashlytics Gradle 插件。

   請注意，使用此選項，您不需要新增firebaseCrashlytics擴充功能或設定自動符號上傳，因為您將使用 Firebase CLI（下面的後續步驟）來產生和上傳符號檔案。

2. 設定符號上傳的環境和項目：

   1. 按照說明安裝 Firebase CLI 。

      如果您已經安裝了 CLI，請確保更新至其最新版本。

   2. （僅適用於使用 Android API 等級 30+ 的應用程式）更新應用程式的AndroidManifest.xml範本以停用指標標記：

      1. 選取Android Player Settings > Publishing Settings > Build > Custom Main Manifest複選框。

      2. 開啟位於Assets/Plugins/Android/AndroidManifest.xml的清單範本。

      3. 將以下屬性新增至應用程式標記： <application android:allowNativeHeapPointerTagging="false" ... />

3. 建立您的專案。

4. 上傳您的符號資訊。

   建置完成後，產生與 Crashlytics 相容的符號文件，並透過執行以下 Firebase CLI 命令將其上傳到 Firebase 伺服器：

   firebase crashlytics:symbols:upload --app=FIREBASE_APP_ID PATH/TO/SYMBOLS

   • FIREBASE_APP_ID ：您的 Firebase Android 應用程式 ID（不是您的套件名稱）
     範例 Firebase Android 應用程式 ID： 1:567383003300:android:17104a2ced0c9b9b

     需要尋找您的 Firebase 應用程式 ID？

     以下是尋找 Firebase 應用程式 ID 的兩種方法：

     • 在您的google-services.json檔案中，您的應用程式 ID 是mobilesdk_app_id值；或者

     • 在 Firebase 控制台中，前往您的專案設定。向下捲動至「您的應用程式」卡，然後按一下所需的 Firebase 應用程式以查找其應用程式 ID。

   • PATH/TO/SYMBOLS ：CLI 產生的符號檔案的路徑

     • 匯出到 Android Studio 專案 - PATH/TO/SYMBOLS可以是任何目錄。 Firebase CLI 將遞歸搜尋指定目錄以尋找副檔名為.so的本機程式庫。

     • 直接從 Unity 建構 APK — PATH/TO/SYMBOLS是建構完成後在專案根目錄中產生的壓縮符號檔案的路徑（例如： myproject/myapp-1.0-v100.symbols.zip ）。

   查看使用 Firebase CLI 命令產生和上傳符號檔案的進階選項

   旗幟	描述
   --generator=csym	使用舊版 cSYM 符號檔案產生器而不是預設的 Breakpad 產生器 不建議使用。我們建議使用預設的 Breakpad 符號檔案產生器。
   --generator=breakpad	使用 Breakpad 符號檔案產生器 請注意，符號檔案產生的預設值是 Breakpad。僅當您已新增時才使用此標誌在您的建置配置中symbolGenerator { csym() } ，並且您想要覆寫它以使用 Breakpad 取代。
   --dry-run	生成符號檔但不上傳它們 如果您想檢查發送的文件的內容，此標誌非常有用。
   --debug	提供額外的調試信息

5. 最後，強制測試當機以完成 Crashlytics 的設定並在 Firebase 控制台的 Crashlytics 儀表板中查看初始資料。

   在建立應用程式作為強制崩潰的一部分後，請確保執行 Firebase CLI crashlytics:symbols:upload命令來上傳符號檔案。