Flutter数据分析跟踪插件analytics_tracker的使用

一个简化了错误跟踪和性能监控的Flutter包。该包帮助开发者捕获、分析并监控应用错误，同时提供详细的上下文信息。

特性

• 🎯 支持带有堆栈跟踪的简单错误跟踪
• 📱 自动收集设备信息
• 🔄 跨平台支持（iOS 和 Android）
• 🔍 详细错误上下文和元数据
• ⚡️ Sentry 集成以实现强大的错误报告
• 📊 支持多个分析平台：
  • Firebase Analytics
  • Mixpanel
  • Amplitude

开始使用

在 pubspec.yaml 文件中添加依赖：

dependencies:
  analytics_error_tracking: ^1.0.0

完整示例

以下是一个完整的示例代码，展示了如何使用 analytics_tracker 插件来跟踪错误。

import 'package:analytics_tracker/analytics_error_tracking.dart';
import 'package:flutter/material.dart';

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化插件，传入Sentry DSN
  await AnalyticsErrorTracking.initialize(
    platforms: [],
    sentryDsn: 'your-sentry-dsn',
  );

  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '错误跟踪演示',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        useMaterial3: true,
      ),
      home: const ErrorTrackingDemo(),
    );
  }
}

class ErrorTrackingDemo extends StatelessWidget {
  const ErrorTrackingDemo({super.key});

  // 生成测试错误
  void _generateError() async {
    try {
      // 生成一个示例错误
      throw Exception('这是一个测试错误');
    } catch (error, stackTrace) {
      // 记录错误，包括额外的上下文信息
      await AnalyticsErrorTracking.logError(
        error,
        stackTrace,
        extra: {
          'screen': 'ErrorTrackingDemo',
          'action': '生成错误按钮按下',
          'timestamp': DateTime.now().toIso8601String(),
        },
      );
    }
  }

  // 生成自定义错误
  void _generateCustomError() async {
    try {
      // 生成一个自定义错误场景
      final List<String> emptyList = [];
      // 这将抛出一个RangeError
      print(emptyList[1]);
    } catch (error, stackTrace) {
      // 记录错误，包括额外的上下文信息
      await AnalyticsErrorTracking.logError(
        error,
        stackTrace,
        extra: {
          'screen': 'ErrorTrackingDemo',
          'action': '列表访问错误',
          'custom_data': '尝试访问空列表',
        },
      );
    }
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text('错误跟踪演示'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            // 测试错误按钮
            ElevatedButton(
              onPressed: _generateError,
              child: const Text('生成测试错误'),
            ),
            const SizedBox(height: 20),
            // 自定义错误按钮
            ElevatedButton(
              onPressed: _generateCustomError,
              child: const Text('生成自定义错误'),
            ),
          ],
        ),
      ),
    );
  }
}