Flutter页面分析插件page_analytics的使用

PageAnalytics 是一个用于 Flutter 的插件，可以帮助您跟踪应用中每个页面的浏览量和停留时间。它提供了页面启动和停止事件的回调，便于与您的分析系统集成。

特性

• 自动跟踪页面浏览量
• 测量每个页面的停留时间
• 处理应用程序生命周期的变化（暂停/恢复）
• 可选择排除特定页面的跟踪
• 易于与自定义分析系统集成

安装

在项目的 pubspec.yaml 文件中添加以下依赖项：

dependencies:
  page_analytics: ^1.0.0

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

$ flutter pub get

使用

以下是使用 PageAnalytics 的步骤：

1. 在 Dart 代码中导入插件

import 'package:page_analytics/page_analytics.dart';

2. 创建 PageAnalytics 实例

final analytics = PageAnalytics(
  onPageStart: (pageName, pageData) {
    // 页面开始时的处理逻辑
    print('Page started: $pageName');
  },
  onPageStop: (pageName, timeSpent, pageData) {
    // 页面结束时的处理逻辑
    print('Page stopped: $pageName, Time spent: $timeSpent seconds');
  },
  restrictedScreens: ['/login', '/splash'], // 可选：排除某些页面的跟踪
);

3. 集成到应用的导航中

class MyApp extends StatelessWidget {
  final PageAnalytics analytics;

  MyApp({required this.analytics});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      onGenerateRoute: (settings) {
        // 让 PageAnalytics 处理路由以进行分析
        analytics.onGenerateRoute(settings);

        // 您的实际路由生成逻辑
        // ...
      },
      // 其他 MaterialApp 属性
    );
  }
}

4. 不要忘记在不再需要时释放 analytics 对象

[@override](/user/override)
void dispose() {
  analytics.dispose();
  super.dispose();
}

示例代码

以下是一个完整的示例，展示如何在 Flutter 应用中使用 PageAnalytics：

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

void main() {
  final analytics = PageAnalytics(
    onPageStart: (pageName, pageData) {
      print('Page started: $pageName');
      print('Page data: $pageData');
    },
    onPageStop: (pageName, timeSpent, pageData) {
      print('Page stopped: $pageName');
      print('Time spent: $timeSpent seconds');
      print('Page data: $pageData');
    },
  );

  runApp(MyApp(analytics: analytics));
}

class MyApp extends StatelessWidget {
  final PageAnalytics analytics;

  MyApp({required this.analytics});

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'PageAnalytics Demo',
      onGenerateRoute: (settings) {
        analytics.onGenerateRoute(settings);

        // 您的实际路由生成逻辑
        switch (settings.name) {
          case '/':
            return MaterialPageRoute(builder: (_) => HomePage());
          case '/details':
            return MaterialPageRoute(builder: (_) => DetailsPage());
          default:
            return null;
        }
      },
      home: HomePage(),
    );
  }
}

class HomePage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Home')),
      body: Center(
        child: ElevatedButton(
          child: Text('Go to Details'),
          onPressed: () {
            Navigator.pushNamed(context, '/details', arguments: {'id': '123'});
          },
        ),
      ),
    );
  }
}

class DetailsPage extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: Text('Details')),
      body: Center(child: Text('Details Page')),
    );
  }
}