Flutter错误追踪插件timber_sentry的使用

在Flutter应用开发中，错误追踪是一个非常重要的环节。timber_sentry 是一个结合了 Timber 和 Sentry 的插件，用于在Flutter项目中更方便地记录日志和捕获异常。本文将通过完整的示例代码展示如何在Flutter项目中使用 timber_sentry 插件。

安装timber_sentry插件

首先，在项目的 pubspec.yaml 文件中添加 timber_sentry 依赖：

dependencies:
  timber_sentry: ^1.0.0 # 确保使用最新版本

然后运行以下命令以安装依赖：

flutter pub get

初始化timber_sentry

在应用启动时初始化 timber_sentry 插件，并配置 Sentry 的 DSN（数据源名称）。

import 'package:flutter/material.dart';
import 'package:timber_sentry/timber_sentry.dart';

void main() {
  // 初始化 Timber Sentry
  TimberSentry.init(
    dsn: '你的Sentry DSN', // 替换为你的Sentry项目DSN
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

注意：请确保将 你的Sentry DSN 替换为你自己的Sentry项目生成的DSN。

使用timber_sentry记录日志

timber_sentry 提供了多种日志级别，包括 debug, info, warn, 和 error。以下是使用这些级别的示例代码：

class MyHomePage extends StatefulWidget {
  [@override](/user/override)
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  void _logDebug() {
    // 记录调试日志
    TimberSentry.d('这是一个调试日志');
  }

  void _logInfo() {
    // 记录信息日志
    TimberSentry.i('这是一个信息日志');
  }

  void _logWarning() {
    // 记录警告日志
    TimberSentry.w('这是一个警告日志');
  }

  void _logError() {
    // 记录错误日志
    TimberSentry.e('这是一个错误日志');
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('timber_sentry 示例'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: _logDebug,
              child: Text('记录调试日志'),
            ),
            ElevatedButton(
              onPressed: _logInfo,
              child: Text('记录信息日志'),
            ),
            ElevatedButton(
              onPressed: _logWarning,
              child: Text('记录警告日志'),
            ),
            ElevatedButton(
              onPressed: _logError,
              child: Text('记录错误日志'),
            ),
          ],
        ),
      ),
    );
  }
}

运行效果

点击按钮后，日志会在控制台输出，并且被捕获并发送到Sentry服务器。你可以在Sentry仪表板中查看这些日志。

捕获异常

除了记录日志，timber_sentry 还可以捕获未处理的异常。你可以通过捕获异常并记录到Sentry来实现这一点。

void _throwException() {
  try {
    throw Exception('这是一个未处理的异常');
  } catch (e, stackTrace) {
    // 捕获异常并记录到Sentry
    TimberSentry.e(e.toString(), stackTrace);
  }
}

[@override](/user/override)
Widget build(BuildContext context) {
  return Scaffold(
    appBar: AppBar(
      title: Text('timber_sentry 示例'),
    ),
    body: Center(
      child: Column(
        mainAxisAlignment: MainAxisAlignment.center,
        children: [
          ElevatedButton(
            onPressed: _throwException,
            child: Text('触发异常'),
          ),
        ],
      ),
    ),
  );
}