測試 Crashlytics 導入作業


強制當機以測試實作

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

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

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

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

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

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

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

  4. 前往 Firebase 控制台的 Crashlytics 資訊主頁，查看測試異常終止情形。

如果您已重新整理控制台，但五分鐘後仍未看到測試異常終止，請嘗試啟用偵錯記錄功能 (下一節)。

啟用 Crashlytics 的偵錯記錄功能

如果您沒有在 Crashlytics 資訊主頁中看到測試異常終止的情況，可以使用 Crashlytics 的偵錯記錄功能，協助追蹤問題。

  1. 啟用偵錯記錄功能：

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

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

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

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

  3. 在記錄中搜尋 Crashlytics 中的記錄訊息，確認應用程式是否將當機事件傳送至 Firebase。

    Completed report submission

如果五分鐘後，您在 Firebase 主控台的 Crashlytics 資訊主頁中，沒有看到這份記錄或測試異常終止，請與 Firebase 支援團隊聯絡，並提供記錄輸出內容的副本，以便我們進一步協助您排除問題。

  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

如果五分鐘後，您在 Firebase 主控台的 Crashlytics 資訊主頁中，沒有看到這份記錄或測試異常終止，請與 Firebase 支援團隊聯絡，並提供記錄輸出內容的副本，以便我們進一步協助您排除問題。

後續步驟