Flutter插件lumin_flutter的介绍与使用方法

简介

Lumin 是一款无痛、专注于隐私的分析工具，由欧盟制作并托管。您可以将此 SDK 集成到您的 Flutter 应用中。

特性

• 自动跟踪每日活跃用户（DAU）、每周活跃用户（WAU）、每月活跃用户（MAU）和每年活跃用户（YAU）
• 统计操作系统和来源国家的相关数据
• 不保存任何与用户相关的个人身份信息
  • 开箱即支持完整的 GDPR 合规性
• 自定义关键性能指标（KPI）

开始使用

添加依赖

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

dependencies:
  lumin_flutter: ^版本号

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

dart pub get

初始化 Lumin

在应用的入口文件中初始化 Lumin。通常是在 main 函数中执行以下操作：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // 确保 Flutter 的绑定已初始化

  // 替换为您的 Lumin 应用令牌
  await Lumin.init("<您的 Lumin 应用令牌>");

  runApp(const MyApp());
}

包裹应用

为了跟踪应用生命周期事件，需要将 MaterialApp 包裹在 LuminLifecycleLogger 中：

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

  [@override](/user/override)
  Widget build(BuildContext context) {
    return LuminLifecycleLogger(
      child: MaterialApp(
        title: 'Lumin 示例',
        theme: ThemeData(
          primarySwatch: Colors.blue,
        ),
        home: const MyHomePage(),
      ),
    );
  }
}

使用方法

发送自定义事件

如果您想发送自定义事件，可以使用 Lumin 的 instance 属性调用 trackCustomEvent 方法：

import 'package:lumin_flutter/lumin_flutter.dart';

class MyHomePage extends StatelessWidget {
  void _sendCustomEvent() {
    // 替换为实际的事件名称
    Lumin.instance.trackCustomEvent("自定义事件名称");
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Lumin 示例'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: _sendCustomEvent,
          child: Text('发送自定义事件'),
        ),
      ),
    );
  }
}