Flutter应用活动追踪插件app_activity_trace的使用

App Activity Trace

一个用于跟踪用户活动并报告错误的Flutter包。它提供了无缝集成，可以监控用户导航、捕获错误并将数据发送到集中式后端。

特性

• 跟踪应用程序内的用户导航
• 报告错误和异常
• 可定制的数据收集
• 易于与Flutter应用程序集成
• 支持Android和iOS平台

开始使用

要使用此包，请在pubspec.yaml文件中添加app_activity_trace作为依赖项。

dependencies:
  app_activity_trace: ^0.1.0

完整示例Demo

以下是一个完整的示例，展示如何使用app_activity_trace来跟踪用户活动和捕获错误。

1. 添加依赖项

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

dependencies:
  app_activity_trace: ^0.1.0

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

flutter pub get

2. 初始化插件

在应用程序启动时初始化app_activity_trace插件。例如，在main.dart文件中：

import 'package:flutter/material.dart';
import 'package:app_activity_trace/app_activity_trace.dart'; // 导入插件

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'App Activity Trace Demo',
      home: MyHomePage(),
    );
  }
}

3. 配置插件

在MyHomePage类中配置app_activity_trace插件，并开始跟踪用户活动：

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

class _MyHomePageState extends State<MyHomePage> {
  // 初始化插件
  final AppActivityTrace _appActivityTrace = AppActivityTrace();

  [@override](/user/override)
  void initState() {
    super.initState();

    // 开始跟踪用户活动
    _appActivityTrace.startTracking();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('App Activity Trace Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () {
                // 模拟页面跳转
                Navigator.push(
                  context,
                  MaterialPageRoute(builder: (context) => SecondPage()),
                );
              },
              child: Text('Go to Second Page'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                // 模拟错误触发
                throw Exception('An example error occurred!');
              },
              child: Text('Trigger Error'),
            ),
          ],
        ),
      ),
    );
  }
}

4. 第二个页面

创建一个名为SecondPage的第二个页面，并在其中继续跟踪用户活动：

class SecondPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Second Page'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 返回主页
            Navigator.pop(context);
          },
          child: Text('Go Back'),
        ),
      ),
    );
  }
}

5. 错误处理

当应用程序抛出异常时，app_activity_trace会自动捕获错误并将其发送到后端。您可以自定义错误处理逻辑：

[@override](/user/override)
void didCatchError(Object error, StackTrace stackTrace) {
  // 自定义错误处理逻辑
  print('Error caught: $error');
  _appActivityTrace.reportError(error.toString(), stackTrace.toString());
}