nanc_analytics 是一个用于在 Flutter 应用中集成数据分析功能的插件。它可以帮助你轻松地集成各种分析服务，如 Google Analytics、Firebase Analytics 等，并提供了统一的 API 来处理事件、用户属性等。

以下是使用 nanc_analytics 插件的基本步骤：

1. 添加依赖

首先，你需要在 pubspec.yaml 文件中添加 nanc_analytics 插件的依赖：

dependencies:
  flutter:
    sdk: flutter
  nanc_analytics: ^1.0.0  # 请使用最新版本

然后运行 flutter pub get 来安装依赖。

2. 初始化插件

在你的 Flutter 应用中初始化 nanc_analytics 插件。通常，你可以在 main.dart 文件中进行初始化：

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

void main() async {
  WidgetsFlutterBinding.ensureInitialized();

  // 初始化 nanc_analytics
  await NancAnalytics.initialize(
    analyticsProviders: [
      // 添加你需要的分析服务提供者
      FirebaseAnalyticsProvider(),
      GoogleAnalyticsProvider(),
    ],
  );

  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Analytics Demo',
      home: MyHomePage(),
    );
  }
}

3. 发送事件

你可以使用 NancAnalytics 来发送事件。例如，当用户点击一个按钮时，你可以发送一个事件：

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

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Analytics Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 发送一个自定义事件
            NancAnalytics.logEvent(
              eventName: 'button_clicked',
              parameters: {'button_name': 'my_button'},
            );
          },
          child: Text('Click Me'),
        ),
      ),
    );
  }
}

4. 设置用户属性

你可以使用 NancAnalytics 来设置用户属性。例如，设置用户的 ID 或用户的偏好设置：

NancAnalytics.setUserProperty({
  'user_id': '12345',
  'preferred_language': 'en',
});

5. 处理屏幕视图

你还可以使用 NancAnalytics 来跟踪用户的屏幕视图。例如，当用户进入一个新的页面时：

class MyHomePage extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // 跟踪屏幕视图
    NancAnalytics.setCurrentScreen(screenName: 'HomePage');

    return Scaffold(
      appBar: AppBar(
        title: Text('Analytics Demo'),
      ),
      body: Center(
        child: ElevatedButton(
          onPressed: () {
            // 发送一个自定义事件
            NancAnalytics.logEvent(
              eventName: 'button_clicked',
              parameters: {'button_name': 'my_button'},
            );
          },
          child: Text('Click Me'),
        ),
      ),
    );
  }
}

6. 处理用户ID

你可以使用 NancAnalytics 来设置用户ID，以便在分析服务中跟踪用户：

NancAnalytics.setUserId('12345');

7. 处理用户注销

当用户注销时，你可以清除用户的ID和属性：

NancAnalytics.clearUserProperties();
NancAnalytics.setUserId(null);

8. 处理应用生命周期事件

你还可以使用 NancAnalytics 来处理应用的生命周期事件，例如应用启动和暂停：

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Analytics Demo',
      home: MyHomePage(),
      navigatorObservers: [
        NancAnalyticsNavigatorObserver(),
      ],
    );
  }
}

9. 高级配置

nanc_analytics 还支持一些高级配置，例如设置默认参数、禁用某些分析服务等。你可以根据需要进行配置。

await NancAnalytics.initialize(
  analyticsProviders: [
    FirebaseAnalyticsProvider(),
    GoogleAnalyticsProvider(),
  ],
  defaultParameters: {
    'app_version': '1.0.0',
    'platform': 'mobile',
  },
  enabled: true, // 启用或禁用所有分析服务
);

10. 处理错误

你可以通过监听 NancAnalytics 的错误流来处理可能发生的错误：

NancAnalytics.errorStream.listen((error) {
  print('Analytics error: $error');
});