測試 Crashlytics 導入狀態 (Flutter)

選取平台：

iOS+ Android Flutter Unity

如果按照入門指南操作後，Crashlytics 資訊主頁仍未顯示當機情形，請參閱本指南。

強制當機以測試導入作業

1. 在應用程式中加入程式碼，強制擲回測試例外狀況。

   如果您已新增會呼叫頂層 Zone 的錯誤處理常式，可以使用下列程式碼在應用程式中新增按鈕，按下按鈕時會擲回測試例外狀況：FirebaseCrashlytics.instance.recordError(error, stack, fatal: true)

   TextButton(
       onPressed: () => throw Exception(),
       child: const Text("Throw Test Exception"),
   ),
   

2. 建構並執行應用程式。

3. 強制擲回測試例外狀況，以便傳送應用程式的第一份報告：

   1. 在測試裝置或模擬器上開啟應用程式。

   2. 在應用程式中，按下使用上述程式碼新增的測試例外狀況按鈕。

4. 前往 Firebase 控制台的Crashlytics資訊主頁，查看測試當機情形。

   如果重新整理控制台後，您在五分鐘內仍未看到測試當機，請嘗試啟用偵錯記錄 (下一節)。

啟用 Crashlytics 的偵錯記錄功能

如果Crashlytics資訊主頁未顯示測試當機，請使用 Crashlytics 的偵錯記錄，協助找出問題。

Apple 平台

1. 啟用偵錯記錄功能：

   1. 在 Xcode 中，依序選取「Product」>「Scheme」>「Edit scheme」。

   2. 在左選單中選取「Run」，然後選取「Arguments」分頁標籤。

   3. 在「Arguments Passed on Launch」部分中，加入 -FIRDebugEnabled。

2. 強制測試當機。本頁的第一節說明如何執行這項操作。

3. 在記錄中，搜尋來自 Crashlytics 的記錄訊息，其中包含下列字串，確認應用程式是否將當機情形傳送至 Firebase。

   Completed report submission

   確認應用程式會傳送當機情形後，您可以選擇移除啟動時傳遞的引數 -FIRDebugEnabled，停用偵錯記錄。

如果五分鐘後，您在 Firebase 控制台的 Crashlytics 資訊主頁中沒有看到這份記錄或測試當機，請將記錄輸出內容副本提供給 Firebase 支援團隊，以便我們進一步協助您排解問題。

Android

1. 啟用及查看 Crashlytics 的偵錯記錄：

   1. 執行應用程式前，請將下列 adb 殼層標記設為 DEBUG：

      adb shell setprop log.tag.FirebaseCrashlytics DEBUG

   2. 執行下列指令，查看裝置記錄中的記錄：

      adb logcat -s FirebaseCrashlytics

2. 強制測試當機。本頁的第一節說明如何執行這項操作。

3. 在 logcat 輸出內容中尋找下列訊息或程式碼 204，確認應用程式是否將當機情形傳送至 Firebase。

   Crashlytics report upload complete

   確認應用程式會傳送當機資訊後，您可以選擇將 adb 殼層標記設回 INFO，停用偵錯記錄：

   adb shell setprop log.tag.FirebaseCrashlytics INFO

如果五分鐘後，您在 Firebase 控制台的 Crashlytics 資訊主頁中沒有看到這份記錄或測試當機，請將記錄輸出內容副本提供給 Firebase 支援團隊，以便我們進一步協助您排解問題。

後續步驟

• 自訂當機報告設定，加入選擇加入回報、記錄、鍵，以及追蹤非致命錯誤。