在 Crashlytics 資訊主頁中取得可讀的當機報告

。

iOS+ (Apple 平台)

若是使用 Crashlytics Unity SDK 8.2.0 以上版本的 Apple 平台應用程式，Firebase 會 Unity 編輯器外掛程式會自動設定要上傳的 Xcode 專案 符號。下載最新版本。

Android

如果是 Android 應用程式，Crashlytics Unity SDK 8.6.1 以上版本會自動包含 NDK 當機回報功能，可讓 Crashlytics 自動回報 Unity IL2CPP Android 系統當機不過，如要查看原生資料庫的符號化堆疊追蹤 Crashlytics 資訊主頁當機。如要上傳符號資訊，請前往 建構時間

  1. 請務必使用 Crashlytics Unity SDK 8.6.1 以上版本。 下載最新版本。

  2. 設定環境和專案以上傳符號：

    1. 按照操作說明安裝 Firebase CLI。

      如已安裝 CLI，請務必 更新至最新版本。

    2. (僅適用於搭載 Android API 級別 30 以上版本的應用程式) 更新應用程式的 停用指標標記的 AndroidManifest.xml 範本：

      1. 勾選 [Android Player Settings] (Android 播放器設定) 的核取方塊 發布設定 > 建構 >自訂主要資訊清單。

      2. 開啟位於 Assets/Plugins/Android/AndroidManifest.xml。

      3. (僅適用於使用以下 SDK 版本的應用程式： 8.8.0) 新增 將下列屬性新增至應用程式標記： <application android:allowNativeHeapPointerTagging="false" ... />

  3. 建立專案與上傳符號。

    每次建立發布子版本或版本時，請完成下列步驟 並在其中查看符號化的堆疊追蹤 Firebase 控制台。

    1. 在「Build Settings」對話方塊中，執行下列其中一項操作：

      • 匯出至 Android Studio 專案來建立專案；或

      • 直接透過 Unity 編輯器建立 APK。
        建構前，請確認「建立符號.zip」核取方塊已勾選 已勾選「Build Settings」對話方塊。

    2. 建構作業完成後，產生與 Crashlytics 相容的符號 並執行下列指令，將檔案上傳到 Firebase 伺服器 Firebase CLI 指令：

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

      • FIREBASE_APP_ID：您的 Firebase Android 應用程式 ID (非 套件名稱)
        Firebase Android 應用程式 ID 範例：1:567383003300:android:17104a2ced0c9b9b

      • PATH/TO/SYMBOLS：由 CLI

        • 匯出至 Android Studio 專案： PATH/TO/SYMBOLS 是 unityLibrary/symbols 目錄， 也就是您建構應用程式後，在匯出的專案根目錄中建立的 透過 Gradle 或 Android Studio 發布

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

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

      標記 說明
      --generator=csym

      使用舊版 cSYM 符號檔案產生器，而非 預設斷路板產生器

      不建議使用。建議您使用預設值 換行符號符號檔案產生器。

      --generator=breakpad

      使用 Breakpad 符號檔案產生器

      請注意，產生符號檔案的預設設定為 Breakpad。 只有在已加入 symbolGenerator { csym() } 並想覆寫建構設定中的 請改用換行符號。

      --dry-run

      產生符號檔案但不上傳符號

      這個標記很適合用來檢查 系統傳送的檔案

      --debug 提供其他偵錯資訊