Flutter数据追踪插件data_tracker的使用

特性

data_tracker 是一个轻量级的跟踪系统或分析插件，通过Firebase等工具简化跟踪系统的数据共享。它为分析数据提供了快速访问。

使用方法

基础使用

首先，在你的项目中添加 data_tracker 插件：

dependencies:
  data_tracker: ^最新版本号

然后，你可以按照以下示例来使用 TrackerScope 来传递参数并获取这些参数。

示例代码

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

class Example extends StatelessWidget {
  const Example({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return TrackerScope(
      params: const {"id": 101}, // 传递参数
      parentContext: context,
      child: const ExampleComponent(),
    );
  }
}

class ExampleComponent extends StatelessWidget {
  const ExampleComponent({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return TrackerScope(
      params: const {"name": "brook", "age": "18"}, // 传递参数
      parentContext: context,
      child: Builder(builder: (context) { // 使用Builder来创建一个新的BuildContext
        final id = Tracker.find(context, "id"); // 获取指定参数
        final idOrDefault = Tracker.findOrDefault(context, 'id', defaultVal: "101"); // 获取指定参数，如果不存在则返回默认值
        final filters = Tracker.findMap(context, ['id', 'name']); // 获取多个参数并封装为Map
        final allFilters = Tracker.findAllMap(context, ['id', 'name']); // 获取所有参数并封装为Map
        final currentParams = Tracker.collectSelf(context); // 收集当前组件的所有参数
        final allParams = Tracker.collect(context); // 收集所有父组件传递下来的参数

        return Column(
          children: [
            Text('ID: $id'), // 显示ID
            Text('ID or Default: $idOrDefault'), // 显示ID或默认值
            Text('Filters: $filters'), // 显示单个参数
            Text('All Filters: $allFilters'), // 显示多个参数
            Text('Current Params: $currentParams'), // 显示当前组件参数
            Text('All Params: $allParams'), // 显示所有参数
          ],
        );
      }),
    );
  }
}

在对话框或其他跨上下文场景中的使用

你也可以在对话框或者其他需要跨上下文传递数据的场景中使用 TrackerScope。

示例代码

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

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

class MyApp extends StatelessWidget {
  const MyApp({Key? key}) : super(key: key);

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(title: const Text('Data Tracker Example')),
        body: Center(
          child: ElevatedButton(
            onPressed: () {
              showDialog(
                context: context,
                builder: (context) {
                  return TrackerScope(
                    params: Tracker.collect(context), // 将当前上下文的参数传递给对话框
                    child: Container(
                      padding: const EdgeInsets.all(20),
                      child: Text('对话框内的内容'),
                    ),
                  );
                },
              );
            },
            child: const Text('打开对话框'),
          ),
        ),
      ),
    );
  }
}