hy_firebase_analytics 的使用

hy_firebase_analytics 是一个用于 Flutter 应用程序的 Firebase 分析插件。它允许开发者跟踪用户行为、事件和应用程序性能等数据。

安装

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

dependencies:
  hy_firebase_analytics: ^1.0.0

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

flutter pub get

初始化

在 main.dart 文件中初始化 Firebase Analytics：

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

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

使用 Firebase Analytics 跟踪事件

在 _HomeScreenState 中实现事件跟踪功能：

class _HomeScreenState extends State<HomeScreen> {
  final HyFirebaseAnalytics _analytics = HyFirebaseAnalytics();

  void _logEvent(String eventName, {Map<String, dynamic>? parameters}) {
    _analytics.logEvent(name: eventName, parameters: parameters);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Firebase Analytics Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () {
                // 跟踪自定义事件
                _logEvent('button_click', parameters: {'button': 'home_page'});
              },
              child: Text('Log Event'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                // 跟踪屏幕视图
                _analytics.setCurrentScreen(screenName: 'Home Screen');
              },
              child: Text('Set Current Screen'),
            ),
          ],
        ),
      ),
    );
  }
}

解释

1. 初始化：在 MyApp 类中，我们创建了一个 HyFirebaseAnalytics 实例。
2. 跟踪事件：通过 _logEvent 方法，我们可以跟踪自定义事件。例如，当用户点击按钮时，会触发 button_click 事件，并附带一些参数。
3. 设置当前屏幕：通过 _analytics.setCurrentScreen 方法，我们可以记录用户当前所在的屏幕名称。

完整示例代码

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

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

class _HomeScreenState extends State<HomeScreen> {
  final HyFirebaseAnalytics _analytics = HyFirebaseAnalytics();

  void _logEvent(String eventName, {Map<String, dynamic>? parameters}) {
    _analytics.logEvent(name: eventName, parameters: parameters);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Firebase Analytics Example'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: [
            ElevatedButton(
              onPressed: () {
                // 跟踪自定义事件
                _logEvent('button_click', parameters: {'button': 'home_page'});
              },
              child: Text('Log Event'),
            ),
            SizedBox(height: 20),
            ElevatedButton(
              onPressed: () {
                // 跟踪屏幕视图
                _analytics.setCurrentScreen(screenName: 'Home Screen');
              },
              child: Text('Set Current Screen'),
            ),
          ],
        ),
      ),
    );
  }
}