Flutter友盟统计插件 fl_umeng 的使用

友盟统计插件 fl_umeng 用于在Flutter应用中集成友盟统计功能。以下是如何使用该插件的详细步骤和示例代码。

前置条件

• 友盟APM性能监测如需直接使用，请参考fl_umeng_apm。
• 友盟超链请参考fl_umeng_link。
• 以上均基于 fl_umeng，必须初始化友盟 FlUMeng().init()。

Android 配置

在 /android/app/build.gradle 文件中添加混淆配置：

android {
    buildTypes {
        release {
            // 添加混淆配置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'consumer-rules.pro'
        }
        debug {
            // 添加混淆配置
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'consumer-rules.pro'
        }
    }
}

开始使用

注册友盟

首先需要注册友盟并进行初始化：

Future<void> init() async {
  /// 注册友盟 统计 性能检测 
  final bool? data = await FlUMeng().init(
      androidAppKey: '5f8fe2abfac90f1c19a8642e',
      iosAppKey: '5f8fe4d4c1122b44acfc7aa7',
      channel: 'channel');
  print('UMeng 初始化成功 = $data');
}

设置用户账号

可以设置或取消用户的账号信息：

void fun() {
  /// 是否开启log 仅支持 Android
  FlUMeng().setLogEnabled(true);

  /// 设置用户账号
  FlUMeng().signIn('userID');

  /// 取消用户账号
  FlUMeng().signOff();
}

发送自定义事件

发送自定义事件（目前属性值支持字符、整数、浮点、长整数，暂不支持NULL、布尔、MAP、数组）：

void fun() {
  FlUMeng().onEvent('test', <String, String>{'test': 'test'});
}

页面统计

可以设置页面统计模式，并记录页面进入和离开的时间：

void fun() {
  /// 设置是否自动采集；
  FlUMeng().setPageCollectionMode(true);

  /// 进入页面统计 
  FlUMeng().onPageStart('pageName');

  /// 离开页面统计
  FlUMeng().onPageEnd('pageName');
}

错误发送

仅支持Android平台的错误发送：

void fun() {
  /// 错误发送  仅支持 Android
  FlUMeng().reportError('error');
}

完整示例 Demo

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

import 'package:fl_umeng/fl_umeng.dart';
import 'package:flutter/foundation.dart';
import 'package:flutter/material.dart';

void main() {
  runApp(MaterialApp(
      debugShowCheckedModeBanner: false,
      title: 'UMeng Example',
      home: Scaffold(
          appBar: AppBar(title: const Text('UMeng Example')),
          body: SafeArea(
            child: Container(
                width: double.infinity,
                padding: const EdgeInsets.symmetric(horizontal: 10),
                child: _HomePage()),
          ))));
}

class _HomePage extends StatefulWidget {
  @override
  _HomePageState createState() => _HomePageState();
}

class _HomePageState extends State<_HomePage> {
  String text = '';

  @override
  void initState() {
    super.initState();
    init();
  }

  /// 注册友盟
  Future<void> init() async {
    debugPrint('注册友盟');
    final bool data = await FlUMeng().init(
        androidAppKey: '5f8fe2abfac90f1c19a8642e',
        iosAppKey: '5f8fe4d4c1122b44acfc7aa7',
        channel: 'channel');
    debugPrint('Umeng 初始化成功 = $data');
    await FlUMeng().setLogEnabled(true);
  }

  @override
  Widget build(BuildContext context) {
    return Column(children: [
      Container(
          margin: const EdgeInsets.symmetric(vertical: 10),
          width: double.infinity,
          height: 130,
          padding: const EdgeInsets.all(10),
          alignment: Alignment.center,
          decoration: BoxDecoration(
              color: Colors.black12, borderRadius: BorderRadius.circular(6)),
          child: SingleChildScrollView(
              child: Text(text, textAlign: TextAlign.center))),
      Expanded(
          child: SingleChildScrollView(
              child: Wrap(
                  spacing: 5,
                  runSpacing: 5,
                  alignment: WrapAlignment.center,
                  children: buildVoid))),
    ]);
  }

  List<Widget> get buildVoid => [
        ElevatedButton(
            onPressed: () async {
              final bool data = await FlUMeng().signIn('userId');
              text = 'signIn  $data';
              setState(() {});
            },
            child: const Text('signIn')),
        ElevatedButton(
            onPressed: () async {
              final bool data = await FlUMeng().signOff();
              text = 'signOff  $data';
              setState(() {});
            },
            child: const Text('signOff')),
        ElevatedButton(
            onPressed: () async {
              final bool data = await FlUMeng().onPageStart('pageStart');
              text = 'onPageStart  $data';
              setState(() {});
            },
            child: const Text('onPageStart')),
        ElevatedButton(
            onPressed: () async {
              final bool data = await FlUMeng().onPageEnd('pageEnd');
              text = 'onPageEnd  $data';
              setState(() {});
            },
            child: const Text('onPageEnd')),
        ElevatedButton(
            onPressed: () async {
              final bool data = await FlUMeng()
                  .onEvent('test', <String, String>{'test': 'test'});
              text = 'onEvent  $data';
              setState(() {});
            },
            child: const Text('onEvent')),
        ElevatedButton(
            onPressed: () async {
              final bool data = await FlUMeng().setPageCollectionMode(true);
              text = 'setPageCollectionMode  $data';
              setState(() {});
            },
            child: const Text('setPageCollectionMode')),
        ElevatedButton(
            onPressed: () async {
              final bool data = await FlUMeng().setLogEnabled(true);
              text = 'logEnabled  $data';
              setState(() {});
            },
            child: const Text('logEnabled')),
        if (defaultTargetPlatform == TargetPlatform.android)
          ElevatedButton(
              onPressed: () async {
                final bool data = await FlUMeng().reportError('error');
                text = 'reportError  $data';
                setState(() {});
              },
              child: const Text('reportError (仅支持 Android)'))
      ];
}

这个示例展示了如何在Flutter应用中集成友盟统计插件 fl_umeng，包括初始化、用户登录/登出、发送自定义事件、页面统计以及错误报告等功能。希望对您有所帮助！