Flutter插件june_flutter的介绍与使用方法详解

Flutter插件june_flutter的介绍与使用方法详解

June 是一个产品分析工具，允许你捕获用户如何使用你的产品的数据。

此包是围绕 June HTTP API 的 Dart 包装器，使你在 Dart 项目和 Flutter 应用中轻松跟踪 June 数据。要了解有关使用 June 的更多信息，请查看官方文档。

开始使用Flutter插件june_flutter

添加依赖

在 pubspec.yaml 文件中添加 june_flutter 依赖，并运行 flutter pub get。

dependencies:
    june_flutter: ^0.x.x # 设置为最新版本

导入库

现在可以在 Dart 代码中使用以下导入：

import 'package:june_flutter/june_flutter.dart';

使用说明

初始化 June

要开始使用 SDK 跟踪数据，必须首先使用你的 June 写入密钥进行初始化。首先添加 import 'package:june_flutter/june_flutter.dart'; 并调用 June.instance.init(writeKey: writeKey);。你可以在 June 仪表板上找到写入密钥。

import 'package:june_flutter/june_flutter.dart';

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    // 初始化 June
    June.instance.init(writeKey: "你的写入密钥");

    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

发送数据

初始化 SDK 后，你可以通过调用 June 实例来跟踪事件和识别用户/公司。

识别用户或公司

// 识别用户并可选地传递属性
June.instance.identifyUser(userId: '用户ID', properties: {'类型': '管理员'});

// 识别公司
June.instance.identifyGroup(groupId: '公司ID', userId: '用户ID', properties: {'计划': '企业版'});

跟踪事件

// 跟踪事件并可选地传递属性
June.instance.track('食谱点击', properties: {'位置': '首页'});

完整示例 Demo

下面是一个完整的示例 Demo，展示了如何在 Flutter 应用中使用 June 插件。

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

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

class MyApp extends StatelessWidget {
  [@override](/user/override)
  Widget build(BuildContext context) {
    // 初始化 June
    June.instance.init(writeKey: "你的写入密钥");

    return MaterialApp(
      home: HomeScreen(),
    );
  }
}

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

class _HomeScreenState extends State<HomeScreen> {
  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('June Flutter Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 识别用户
            June.instance.identifyUser(userId: '12345', properties: {'类型': '管理员'});

            // 跟踪事件
            June.instance.track('食谱点击', properties: {'位置': '首页'});
          },
          child: Text('跟踪事件'),
        ),
      ),
    );
  }
}