向服務報告錯誤

雖然人們總是努力編寫無 bug 的應用，但 bug 難免會不時出現。由於有 bug 的應用會導致使用者和客戶不滿意，因此瞭解使用者遇到 bug 的頻率以及 bug 發生的地點非常重要。這樣，您就可以優先處理影響最大的 bug 並著手修復它們。

您如何確定使用者遇到 bug 的頻率？每當發生錯誤時，建立一個包含所發生錯誤及相關堆疊跟蹤的報告。然後，您可以將報告發送到錯誤跟蹤服務，例如 Bugsnag、Datadog、Firebase Crashlytics、Rollbar 或 Sentry。

錯誤跟蹤服務會聚合您使用者遇到的所有崩潰，並將它們分組。這使您能夠了解您的應用失敗的頻率以及使用者在哪裡遇到麻煩。

在本示例中，您將學習如何透過以下步驟向 Sentry 崩潰報告服務報告錯誤

1. 從 Sentry 獲取 DSN。
2. 匯入 Flutter Sentry 包
3. 初始化 Sentry SDK
4. 以程式設計方式捕獲錯誤

在向 Sentry 報告錯誤之前，您需要一個“DSN”來唯一標識您的應用與 Sentry.io 服務。

要獲取 DSN，請執行以下步驟

1. 建立 Sentry 賬戶.
2. 登入賬戶。
3. 建立新的 Flutter 專案。
4. 複製包含 DSN 的程式碼片段。

將 sentry_flutter 包匯入到應用中。sentry 包使向 Sentry 錯誤跟蹤服務傳送錯誤報告更加容易。

要將 sentry_flutter 包新增為依賴項，請執行 flutter pub add

flutter pub add sentry_flutter

初始化 SDK 以自動捕獲不同的未處理錯誤

import 'package:flutter/widgets.dart';
import 'package:sentry_flutter/sentry_flutter.dart';

Future<void> main() async {
  await SentryFlutter.init(
    (options) => options.dsn = 'https://example@sentry.io/example',
    appRunner: () => runApp(const MyApp()),
  );
}

或者，您可以使用 dart-define 標籤將 DSN 傳遞給 Flutter

--dart-define SENTRY_DSN=https://example@sentry.io/example

這就是 Sentry 所需的，以便捕獲 Dart 和原生層中的未處理錯誤。
這包括 iOS 上的 Swift、Objective-C、C 和 C++，以及 Android 上的 Java、Kotlin、C 和 C++。

除了 Sentry 透過匯入和初始化 SDK 生成的自動錯誤報告外，您還可以使用 API 向 Sentry 報告錯誤

await Sentry.captureException(exception, stackTrace: stackTrace);

有關更多資訊，請參閱 pub.dev 上的 Sentry API 文件。

有關使用 Sentry SDK 的詳細文件，請訪問 Sentry 網站。

要檢視工作示例，請參閱 Sentry flutter 示例應用。