将错误报告给服务
虽然人们总是试图创建没有 bug 的应用程序,但它们肯定会在某些时候出现。由于有 bug 的应用程序会导致用户和客户不满意,因此了解用户遇到 bug 的频率以及这些 bug 发生的位置非常重要。这样,您就可以优先处理影响最大的 bug 并努力修复它们。
如何确定用户遇到 bug 的频率?每当发生错误时,创建一个包含发生的错误和相关堆栈跟踪的报告。然后,您可以将报告发送到错误跟踪服务,例如 Bugsnag、Datadog、Firebase Crashlytics、Rollbar 或 Sentry。
错误跟踪服务会聚合用户遇到的所有崩溃并将其分组。这使您能够了解应用程序失败的频率以及用户遇到问题的具体位置。
在本菜谱中,学习如何使用以下步骤将错误报告给 Sentry 崩溃报告服务
- 从 Sentry 获取 DSN。
- 导入 Flutter Sentry 包
- 初始化 Sentry SDK
- 以编程方式捕获错误
1. 从 Sentry 获取 DSN
#在将错误报告给 Sentry 之前,您需要一个“DSN”来使用 Sentry.io 服务唯一标识您的应用程序。
要获取 DSN,请使用以下步骤
- 在 Sentry 创建一个帐户.
- 登录帐户。
- 创建一个新的 Flutter 项目。
- 复制包含 DSN 的代码片段。
2. 导入 Sentry 包
#将 sentry_flutter
包导入应用程序。sentry 包使将错误报告发送到 Sentry 错误跟踪服务变得更容易。
要将 sentry_flutter
包添加为依赖项,请运行 flutter pub add
flutter pub add sentry_flutter
3. 初始化 Sentry SDK
#初始化 SDK 以自动捕获不同的未处理错误
import 'package:flutter/widgets.dart';
import 'package:sentry_flutter/sentry_flutter.dart';
Future<void> main() async {
await SentryFlutter.init(
(options) => options.dsn = 'https://[email protected]/example',
appRunner: () => runApp(const MyApp()),
);
}
或者,您可以使用 dart-define
标记将 DSN 传递给 Flutter
--dart-define SENTRY_DSN=https://[email protected]/example
这能给我带来什么?
#这对于 Sentry 捕获 Dart 和原生层中的未处理错误来说已经足够了。
这包括 iOS 上的 Swift、Objective-C、C 和 C++,以及 Android 上的 Java、Kotlin、C 和 C++。
4. 以编程方式捕获错误
#除了导入和初始化 SDK 后 Sentry 生成的自动错误报告之外,您还可以使用 API 将错误报告给 Sentry
await Sentry.captureException(exception, stackTrace: stackTrace);
有关更多信息,请参阅 pub.dev 上的 Sentry API 文档。
了解更多
#有关使用 Sentry SDK 的大量文档可在 Sentry 的网站 上找到。
完整示例
#要查看工作示例,请参阅 Sentry flutter 示例 应用程序。
除非另有说明,否则本网站上的文档反映了 Flutter 的最新稳定版本。页面最后更新于 2024-04-06。 查看源代码 或 报告问题.